@googleapis/toolresults 4.0.1 → 6.0.0

package/v1beta3.ts

@@ -1794,6 +1794,53 @@ export namespace toolresults_v1beta3 {
 
     /**
      * Gets the Tool Results settings for a project. May return any of the following canonical error codes: - PERMISSION_DENIED - if the user is not authorized to read from project
+     * @example
+     * ```js
+     * // Before running the sample:
+     * // - Enable the API at:
+     * //   https://console.developers.google.com/apis/api/toolresults.googleapis.com
+     * // - Login into gcloud by running:
+     * //   ```sh
+     * //   $ gcloud auth application-default login
+     * //   ```
+     * // - Install the npm module by running:
+     * //   ```sh
+     * //   $ npm install googleapis
+     * //   ```
+     *
+     * const {google} = require('googleapis');
+     * const toolresults = google.toolresults('v1beta3');
+     *
+     * async function main() {
+     *   const auth = new google.auth.GoogleAuth({
+     *     // Scopes can be specified either as an array or as a single, space-delimited string.
+     *     scopes: ['https://www.googleapis.com/auth/cloud-platform'],
+     *   });
+     *
+     *   // Acquire an auth client, and bind it to all future calls
+     *   const authClient = await auth.getClient();
+     *   google.options({auth: authClient});
+     *
+     *   // Do the magic
+     *   const res = await toolresults.projects.getSettings({
+     *     // A Project id. Required.
+     *     projectId: 'placeholder-value',
+     *   });
+     *   console.log(res.data);
+     *
+     *   // Example response
+     *   // {
+     *   //   "defaultBucket": "my_defaultBucket",
+     *   //   "name": "my_name"
+     *   // }
+     * }
+     *
+     * main().catch(e => {
+     *   console.error(e);
+     *   throw e;
+     * });
+     *
+     * ```
      *
      * @param params - Parameters for request
      * @param options - Optionally override request options, such as `url`, `method`, and `encoding`.
@@ -1884,6 +1931,53 @@ export namespace toolresults_v1beta3 {
 
     /**
      * Creates resources for settings which have not yet been set. Currently, this creates a single resource: a Google Cloud Storage bucket, to be used as the default bucket for this project. The bucket is created in an FTL-own storage project. Except for in rare cases, calling this method in parallel from multiple clients will only create a single bucket. In order to avoid unnecessary storage charges, the bucket is configured to automatically delete objects older than 90 days. The bucket is created with the following permissions: - Owner access for owners of central storage project (FTL-owned) - Writer access for owners/editors of customer project - Reader access for viewers of customer project The default ACL on objects created in the bucket is: - Owner access for owners of central storage project - Reader access for owners/editors/viewers of customer project See Google Cloud Storage documentation for more details. If there is already a default bucket set and the project can access the bucket, this call does nothing. However, if the project doesn't have the permission to access the bucket or the bucket is deleted, a new bucket will be created. May return any canonical error codes, including the following: - PERMISSION_DENIED - if the user is not authorized to write to project - Any error code raised by Google Cloud Storage
+     * @example
+     * ```js
+     * // Before running the sample:
+     * // - Enable the API at:
+     * //   https://console.developers.google.com/apis/api/toolresults.googleapis.com
+     * // - Login into gcloud by running:
+     * //   ```sh
+     * //   $ gcloud auth application-default login
+     * //   ```
+     * // - Install the npm module by running:
+     * //   ```sh
+     * //   $ npm install googleapis
+     * //   ```
+     *
+     * const {google} = require('googleapis');
+     * const toolresults = google.toolresults('v1beta3');
+     *
+     * async function main() {
+     *   const auth = new google.auth.GoogleAuth({
+     *     // Scopes can be specified either as an array or as a single, space-delimited string.
+     *     scopes: ['https://www.googleapis.com/auth/cloud-platform'],
+     *   });
+     *
+     *   // Acquire an auth client, and bind it to all future calls
+     *   const authClient = await auth.getClient();
+     *   google.options({auth: authClient});
+     *
+     *   // Do the magic
+     *   const res = await toolresults.projects.initializeSettings({
+     *     // A Project id. Required.
+     *     projectId: 'placeholder-value',
+     *   });
+     *   console.log(res.data);
+     *
+     *   // Example response
+     *   // {
+     *   //   "defaultBucket": "my_defaultBucket",
+     *   //   "name": "my_name"
+     *   // }
+     * }
+     *
+     * main().catch(e => {
+     *   console.error(e);
+     *   throw e;
+     * });
+     *
+     * ```
      *
      * @param params - Parameters for request
      * @param options - Optionally override request options, such as `url`, `method`, and `encoding`.
@@ -2003,6 +2097,68 @@ export namespace toolresults_v1beta3 {
 
     /**
      * Creates a History. The returned History will have the id set. May return any of the following canonical error codes: - PERMISSION_DENIED - if the user is not authorized to write to project - INVALID_ARGUMENT - if the request is malformed - NOT_FOUND - if the containing project does not exist
+     * @example
+     * ```js
+     * // Before running the sample:
+     * // - Enable the API at:
+     * //   https://console.developers.google.com/apis/api/toolresults.googleapis.com
+     * // - Login into gcloud by running:
+     * //   ```sh
+     * //   $ gcloud auth application-default login
+     * //   ```
+     * // - Install the npm module by running:
+     * //   ```sh
+     * //   $ npm install googleapis
+     * //   ```
+     *
+     * const {google} = require('googleapis');
+     * const toolresults = google.toolresults('v1beta3');
+     *
+     * async function main() {
+     *   const auth = new google.auth.GoogleAuth({
+     *     // Scopes can be specified either as an array or as a single, space-delimited string.
+     *     scopes: ['https://www.googleapis.com/auth/cloud-platform'],
+     *   });
+     *
+     *   // Acquire an auth client, and bind it to all future calls
+     *   const authClient = await auth.getClient();
+     *   google.options({auth: authClient});
+     *
+     *   // Do the magic
+     *   const res = await toolresults.projects.histories.create({
+     *     // A Project id. Required.
+     *     projectId: 'placeholder-value',
+     *     // A unique request ID for server to detect duplicated requests. For example, a UUID. Optional, but strongly recommended.
+     *     requestId: 'placeholder-value',
+     *
+     *     // Request body metadata
+     *     requestBody: {
+     *       // request body parameters
+     *       // {
+     *       //   "displayName": "my_displayName",
+     *       //   "historyId": "my_historyId",
+     *       //   "name": "my_name",
+     *       //   "testPlatform": "my_testPlatform"
+     *       // }
+     *     },
+     *   });
+     *   console.log(res.data);
+     *
+     *   // Example response
+     *   // {
+     *   //   "displayName": "my_displayName",
+     *   //   "historyId": "my_historyId",
+     *   //   "name": "my_name",
+     *   //   "testPlatform": "my_testPlatform"
+     *   // }
+     * }
+     *
+     * main().catch(e => {
+     *   console.error(e);
+     *   throw e;
+     * });
+     *
+     * ```
      *
      * @param params - Parameters for request
      * @param options - Optionally override request options, such as `url`, `method`, and `encoding`.
@@ -2093,6 +2249,57 @@ export namespace toolresults_v1beta3 {
 
     /**
      * Gets a History. May return any of the following canonical error codes: - PERMISSION_DENIED - if the user is not authorized to read project - INVALID_ARGUMENT - if the request is malformed - NOT_FOUND - if the History does not exist
+     * @example
+     * ```js
+     * // Before running the sample:
+     * // - Enable the API at:
+     * //   https://console.developers.google.com/apis/api/toolresults.googleapis.com
+     * // - Login into gcloud by running:
+     * //   ```sh
+     * //   $ gcloud auth application-default login
+     * //   ```
+     * // - Install the npm module by running:
+     * //   ```sh
+     * //   $ npm install googleapis
+     * //   ```
+     *
+     * const {google} = require('googleapis');
+     * const toolresults = google.toolresults('v1beta3');
+     *
+     * async function main() {
+     *   const auth = new google.auth.GoogleAuth({
+     *     // Scopes can be specified either as an array or as a single, space-delimited string.
+     *     scopes: ['https://www.googleapis.com/auth/cloud-platform'],
+     *   });
+     *
+     *   // Acquire an auth client, and bind it to all future calls
+     *   const authClient = await auth.getClient();
+     *   google.options({auth: authClient});
+     *
+     *   // Do the magic
+     *   const res = await toolresults.projects.histories.get({
+     *     // A History id. Required.
+     *     historyId: 'placeholder-value',
+     *     // A Project id. Required.
+     *     projectId: 'placeholder-value',
+     *   });
+     *   console.log(res.data);
+     *
+     *   // Example response
+     *   // {
+     *   //   "displayName": "my_displayName",
+     *   //   "historyId": "my_historyId",
+     *   //   "name": "my_name",
+     *   //   "testPlatform": "my_testPlatform"
+     *   // }
+     * }
+     *
+     * main().catch(e => {
+     *   console.error(e);
+     *   throw e;
+     * });
+     *
+     * ```
      *
      * @param params - Parameters for request
      * @param options - Optionally override request options, such as `url`, `method`, and `encoding`.
@@ -2184,6 +2391,59 @@ export namespace toolresults_v1beta3 {
 
     /**
      * Lists Histories for a given Project. The histories are sorted by modification time in descending order. The history_id key will be used to order the history with the same modification time. May return any of the following canonical error codes: - PERMISSION_DENIED - if the user is not authorized to read project - INVALID_ARGUMENT - if the request is malformed - NOT_FOUND - if the History does not exist
+     * @example
+     * ```js
+     * // Before running the sample:
+     * // - Enable the API at:
+     * //   https://console.developers.google.com/apis/api/toolresults.googleapis.com
+     * // - Login into gcloud by running:
+     * //   ```sh
+     * //   $ gcloud auth application-default login
+     * //   ```
+     * // - Install the npm module by running:
+     * //   ```sh
+     * //   $ npm install googleapis
+     * //   ```
+     *
+     * const {google} = require('googleapis');
+     * const toolresults = google.toolresults('v1beta3');
+     *
+     * async function main() {
+     *   const auth = new google.auth.GoogleAuth({
+     *     // Scopes can be specified either as an array or as a single, space-delimited string.
+     *     scopes: ['https://www.googleapis.com/auth/cloud-platform'],
+     *   });
+     *
+     *   // Acquire an auth client, and bind it to all future calls
+     *   const authClient = await auth.getClient();
+     *   google.options({auth: authClient});
+     *
+     *   // Do the magic
+     *   const res = await toolresults.projects.histories.list({
+     *     // If set, only return histories with the given name. Optional.
+     *     filterByName: 'placeholder-value',
+     *     // The maximum number of Histories to fetch. Default value: 20. The server will use this default if the field is not set or has a value of 0. Any value greater than 100 will be treated as 100. Optional.
+     *     pageSize: 'placeholder-value',
+     *     // A continuation token to resume the query at the next item. Optional.
+     *     pageToken: 'placeholder-value',
+     *     // A Project id. Required.
+     *     projectId: 'placeholder-value',
+     *   });
+     *   console.log(res.data);
+     *
+     *   // Example response
+     *   // {
+     *   //   "histories": [],
+     *   //   "nextPageToken": "my_nextPageToken"
+     *   // }
+     * }
+     *
+     * main().catch(e => {
+     *   console.error(e);
+     *   throw e;
+     * });
+     *
+     * ```
      *
      * @param params - Parameters for request
      * @param options - Optionally override request options, such as `url`, `method`, and `encoding`.
@@ -2341,6 +2601,78 @@ export namespace toolresults_v1beta3 {
 
     /**
      * Creates an Execution. The returned Execution will have the id set. May return any of the following canonical error codes: - PERMISSION_DENIED - if the user is not authorized to write to project - INVALID_ARGUMENT - if the request is malformed - NOT_FOUND - if the containing History does not exist
+     * @example
+     * ```js
+     * // Before running the sample:
+     * // - Enable the API at:
+     * //   https://console.developers.google.com/apis/api/toolresults.googleapis.com
+     * // - Login into gcloud by running:
+     * //   ```sh
+     * //   $ gcloud auth application-default login
+     * //   ```
+     * // - Install the npm module by running:
+     * //   ```sh
+     * //   $ npm install googleapis
+     * //   ```
+     *
+     * const {google} = require('googleapis');
+     * const toolresults = google.toolresults('v1beta3');
+     *
+     * async function main() {
+     *   const auth = new google.auth.GoogleAuth({
+     *     // Scopes can be specified either as an array or as a single, space-delimited string.
+     *     scopes: ['https://www.googleapis.com/auth/cloud-platform'],
+     *   });
+     *
+     *   // Acquire an auth client, and bind it to all future calls
+     *   const authClient = await auth.getClient();
+     *   google.options({auth: authClient});
+     *
+     *   // Do the magic
+     *   const res = await toolresults.projects.histories.executions.create({
+     *     // A History id. Required.
+     *     historyId: 'placeholder-value',
+     *     // A Project id. Required.
+     *     projectId: 'placeholder-value',
+     *     // A unique request ID for server to detect duplicated requests. For example, a UUID. Optional, but strongly recommended.
+     *     requestId: 'placeholder-value',
+     *
+     *     // Request body metadata
+     *     requestBody: {
+     *       // request body parameters
+     *       // {
+     *       //   "completionTime": {},
+     *       //   "creationTime": {},
+     *       //   "dimensionDefinitions": [],
+     *       //   "executionId": "my_executionId",
+     *       //   "outcome": {},
+     *       //   "specification": {},
+     *       //   "state": "my_state",
+     *       //   "testExecutionMatrixId": "my_testExecutionMatrixId"
+     *       // }
+     *     },
+     *   });
+     *   console.log(res.data);
+     *
+     *   // Example response
+     *   // {
+     *   //   "completionTime": {},
+     *   //   "creationTime": {},
+     *   //   "dimensionDefinitions": [],
+     *   //   "executionId": "my_executionId",
+     *   //   "outcome": {},
+     *   //   "specification": {},
+     *   //   "state": "my_state",
+     *   //   "testExecutionMatrixId": "my_testExecutionMatrixId"
+     *   // }
+     * }
+     *
+     * main().catch(e => {
+     *   console.error(e);
+     *   throw e;
+     * });
+     *
+     * ```
      *
      * @param params - Parameters for request
      * @param options - Optionally override request options, such as `url`, `method`, and `encoding`.
@@ -2432,6 +2764,63 @@ export namespace toolresults_v1beta3 {
 
     /**
      * Gets an Execution. May return any of the following canonical error codes: - PERMISSION_DENIED - if the user is not authorized to write to project - INVALID_ARGUMENT - if the request is malformed - NOT_FOUND - if the Execution does not exist
+     * @example
+     * ```js
+     * // Before running the sample:
+     * // - Enable the API at:
+     * //   https://console.developers.google.com/apis/api/toolresults.googleapis.com
+     * // - Login into gcloud by running:
+     * //   ```sh
+     * //   $ gcloud auth application-default login
+     * //   ```
+     * // - Install the npm module by running:
+     * //   ```sh
+     * //   $ npm install googleapis
+     * //   ```
+     *
+     * const {google} = require('googleapis');
+     * const toolresults = google.toolresults('v1beta3');
+     *
+     * async function main() {
+     *   const auth = new google.auth.GoogleAuth({
+     *     // Scopes can be specified either as an array or as a single, space-delimited string.
+     *     scopes: ['https://www.googleapis.com/auth/cloud-platform'],
+     *   });
+     *
+     *   // Acquire an auth client, and bind it to all future calls
+     *   const authClient = await auth.getClient();
+     *   google.options({auth: authClient});
+     *
+     *   // Do the magic
+     *   const res = await toolresults.projects.histories.executions.get({
+     *     // An Execution id. Required.
+     *     executionId: 'placeholder-value',
+     *     // A History id. Required.
+     *     historyId: 'placeholder-value',
+     *     // A Project id. Required.
+     *     projectId: 'placeholder-value',
+     *   });
+     *   console.log(res.data);
+     *
+     *   // Example response
+     *   // {
+     *   //   "completionTime": {},
+     *   //   "creationTime": {},
+     *   //   "dimensionDefinitions": [],
+     *   //   "executionId": "my_executionId",
+     *   //   "outcome": {},
+     *   //   "specification": {},
+     *   //   "state": "my_state",
+     *   //   "testExecutionMatrixId": "my_testExecutionMatrixId"
+     *   // }
+     * }
+     *
+     * main().catch(e => {
+     *   console.error(e);
+     *   throw e;
+     * });
+     *
+     * ```
      *
      * @param params - Parameters for request
      * @param options - Optionally override request options, such as `url`, `method`, and `encoding`.
@@ -2523,6 +2912,59 @@ export namespace toolresults_v1beta3 {
 
     /**
      * Lists Executions for a given History. The executions are sorted by creation_time in descending order. The execution_id key will be used to order the executions with the same creation_time. May return any of the following canonical error codes: - PERMISSION_DENIED - if the user is not authorized to read project - INVALID_ARGUMENT - if the request is malformed - NOT_FOUND - if the containing History does not exist
+     * @example
+     * ```js
+     * // Before running the sample:
+     * // - Enable the API at:
+     * //   https://console.developers.google.com/apis/api/toolresults.googleapis.com
+     * // - Login into gcloud by running:
+     * //   ```sh
+     * //   $ gcloud auth application-default login
+     * //   ```
+     * // - Install the npm module by running:
+     * //   ```sh
+     * //   $ npm install googleapis
+     * //   ```
+     *
+     * const {google} = require('googleapis');
+     * const toolresults = google.toolresults('v1beta3');
+     *
+     * async function main() {
+     *   const auth = new google.auth.GoogleAuth({
+     *     // Scopes can be specified either as an array or as a single, space-delimited string.
+     *     scopes: ['https://www.googleapis.com/auth/cloud-platform'],
+     *   });
+     *
+     *   // Acquire an auth client, and bind it to all future calls
+     *   const authClient = await auth.getClient();
+     *   google.options({auth: authClient});
+     *
+     *   // Do the magic
+     *   const res = await toolresults.projects.histories.executions.list({
+     *     // A History id. Required.
+     *     historyId: 'placeholder-value',
+     *     // The maximum number of Executions to fetch. Default value: 25. The server will use this default if the field is not set or has a value of 0. Optional.
+     *     pageSize: 'placeholder-value',
+     *     // A continuation token to resume the query at the next item. Optional.
+     *     pageToken: 'placeholder-value',
+     *     // A Project id. Required.
+     *     projectId: 'placeholder-value',
+     *   });
+     *   console.log(res.data);
+     *
+     *   // Example response
+     *   // {
+     *   //   "executions": [],
+     *   //   "nextPageToken": "my_nextPageToken"
+     *   // }
+     * }
+     *
+     * main().catch(e => {
+     *   console.error(e);
+     *   throw e;
+     * });
+     *
+     * ```
      *
      * @param params - Parameters for request
      * @param options - Optionally override request options, such as `url`, `method`, and `encoding`.
@@ -2616,6 +3058,80 @@ export namespace toolresults_v1beta3 {
 
     /**
      * Updates an existing Execution with the supplied partial entity. May return any of the following canonical error codes: - PERMISSION_DENIED - if the user is not authorized to write to project - INVALID_ARGUMENT - if the request is malformed - FAILED_PRECONDITION - if the requested state transition is illegal - NOT_FOUND - if the containing History does not exist
+     * @example
+     * ```js
+     * // Before running the sample:
+     * // - Enable the API at:
+     * //   https://console.developers.google.com/apis/api/toolresults.googleapis.com
+     * // - Login into gcloud by running:
+     * //   ```sh
+     * //   $ gcloud auth application-default login
+     * //   ```
+     * // - Install the npm module by running:
+     * //   ```sh
+     * //   $ npm install googleapis
+     * //   ```
+     *
+     * const {google} = require('googleapis');
+     * const toolresults = google.toolresults('v1beta3');
+     *
+     * async function main() {
+     *   const auth = new google.auth.GoogleAuth({
+     *     // Scopes can be specified either as an array or as a single, space-delimited string.
+     *     scopes: ['https://www.googleapis.com/auth/cloud-platform'],
+     *   });
+     *
+     *   // Acquire an auth client, and bind it to all future calls
+     *   const authClient = await auth.getClient();
+     *   google.options({auth: authClient});
+     *
+     *   // Do the magic
+     *   const res = await toolresults.projects.histories.executions.patch({
+     *     // Required.
+     *     executionId: 'placeholder-value',
+     *     // Required.
+     *     historyId: 'placeholder-value',
+     *     // A Project id. Required.
+     *     projectId: 'placeholder-value',
+     *     // A unique request ID for server to detect duplicated requests. For example, a UUID. Optional, but strongly recommended.
+     *     requestId: 'placeholder-value',
+     *
+     *     // Request body metadata
+     *     requestBody: {
+     *       // request body parameters
+     *       // {
+     *       //   "completionTime": {},
+     *       //   "creationTime": {},
+     *       //   "dimensionDefinitions": [],
+     *       //   "executionId": "my_executionId",
+     *       //   "outcome": {},
+     *       //   "specification": {},
+     *       //   "state": "my_state",
+     *       //   "testExecutionMatrixId": "my_testExecutionMatrixId"
+     *       // }
+     *     },
+     *   });
+     *   console.log(res.data);
+     *
+     *   // Example response
+     *   // {
+     *   //   "completionTime": {},
+     *   //   "creationTime": {},
+     *   //   "dimensionDefinitions": [],
+     *   //   "executionId": "my_executionId",
+     *   //   "outcome": {},
+     *   //   "specification": {},
+     *   //   "state": "my_state",
+     *   //   "testExecutionMatrixId": "my_testExecutionMatrixId"
+     *   // }
+     * }
+     *
+     * main().catch(e => {
+     *   console.error(e);
+     *   throw e;
+     * });
+     *
+     * ```
      *
      * @param params - Parameters for request
      * @param options - Optionally override request options, such as `url`, `method`, and `encoding`.
@@ -2793,6 +3309,61 @@ export namespace toolresults_v1beta3 {
 
     /**
      * Retrieves a single screenshot cluster by its ID
+     * @example
+     * ```js
+     * // Before running the sample:
+     * // - Enable the API at:
+     * //   https://console.developers.google.com/apis/api/toolresults.googleapis.com
+     * // - Login into gcloud by running:
+     * //   ```sh
+     * //   $ gcloud auth application-default login
+     * //   ```
+     * // - Install the npm module by running:
+     * //   ```sh
+     * //   $ npm install googleapis
+     * //   ```
+     *
+     * const {google} = require('googleapis');
+     * const toolresults = google.toolresults('v1beta3');
+     *
+     * async function main() {
+     *   const auth = new google.auth.GoogleAuth({
+     *     // Scopes can be specified either as an array or as a single, space-delimited string.
+     *     scopes: ['https://www.googleapis.com/auth/cloud-platform'],
+     *   });
+     *
+     *   // Acquire an auth client, and bind it to all future calls
+     *   const authClient = await auth.getClient();
+     *   google.options({auth: authClient});
+     *
+     *   // Do the magic
+     *   const res = await toolresults.projects.histories.executions.clusters.get({
+     *     // A Cluster id Required.
+     *     clusterId: 'placeholder-value',
+     *     // An Execution id. Required.
+     *     executionId: 'placeholder-value',
+     *     // A History id. Required.
+     *     historyId: 'placeholder-value',
+     *     // A Project id. Required.
+     *     projectId: 'placeholder-value',
+     *   });
+     *   console.log(res.data);
+     *
+     *   // Example response
+     *   // {
+     *   //   "activity": "my_activity",
+     *   //   "clusterId": "my_clusterId",
+     *   //   "keyScreen": {},
+     *   //   "screens": []
+     *   // }
+     * }
+     *
+     * main().catch(e => {
+     *   console.error(e);
+     *   throw e;
+     * });
+     *
+     * ```
      *
      * @param params - Parameters for request
      * @param options - Optionally override request options, such as `url`, `method`, and `encoding`.
@@ -2885,6 +3456,56 @@ export namespace toolresults_v1beta3 {
 
     /**
      * Lists Screenshot Clusters Returns the list of screenshot clusters corresponding to an execution. Screenshot clusters are created after the execution is finished. Clusters are created from a set of screenshots. Between any two screenshots, a matching score is calculated based off their metadata that determines how similar they are. Screenshots are placed in the cluster that has screens which have the highest matching scores.
+     * @example
+     * ```js
+     * // Before running the sample:
+     * // - Enable the API at:
+     * //   https://console.developers.google.com/apis/api/toolresults.googleapis.com
+     * // - Login into gcloud by running:
+     * //   ```sh
+     * //   $ gcloud auth application-default login
+     * //   ```
+     * // - Install the npm module by running:
+     * //   ```sh
+     * //   $ npm install googleapis
+     * //   ```
+     *
+     * const {google} = require('googleapis');
+     * const toolresults = google.toolresults('v1beta3');
+     *
+     * async function main() {
+     *   const auth = new google.auth.GoogleAuth({
+     *     // Scopes can be specified either as an array or as a single, space-delimited string.
+     *     scopes: ['https://www.googleapis.com/auth/cloud-platform'],
+     *   });
+     *
+     *   // Acquire an auth client, and bind it to all future calls
+     *   const authClient = await auth.getClient();
+     *   google.options({auth: authClient});
+     *
+     *   // Do the magic
+     *   const res = await toolresults.projects.histories.executions.clusters.list({
+     *     // An Execution id. Required.
+     *     executionId: 'placeholder-value',
+     *     // A History id. Required.
+     *     historyId: 'placeholder-value',
+     *     // A Project id. Required.
+     *     projectId: 'placeholder-value',
+     *   });
+     *   console.log(res.data);
+     *
+     *   // Example response
+     *   // {
+     *   //   "clusters": []
+     *   // }
+     * }
+     *
+     * main().catch(e => {
+     *   console.error(e);
+     *   throw e;
+     * });
+     *
+     * ```
      *
      * @param params - Parameters for request
      * @param options - Optionally override request options, such as `url`, `method`, and `encoding`.
@@ -3025,6 +3646,68 @@ export namespace toolresults_v1beta3 {
 
     /**
      * Gets an Environment. May return any of the following canonical error codes: - PERMISSION_DENIED - if the user is not authorized to read project - INVALID_ARGUMENT - if the request is malformed - NOT_FOUND - if the Environment does not exist
+     * @example
+     * ```js
+     * // Before running the sample:
+     * // - Enable the API at:
+     * //   https://console.developers.google.com/apis/api/toolresults.googleapis.com
+     * // - Login into gcloud by running:
+     * //   ```sh
+     * //   $ gcloud auth application-default login
+     * //   ```
+     * // - Install the npm module by running:
+     * //   ```sh
+     * //   $ npm install googleapis
+     * //   ```
+     *
+     * const {google} = require('googleapis');
+     * const toolresults = google.toolresults('v1beta3');
+     *
+     * async function main() {
+     *   const auth = new google.auth.GoogleAuth({
+     *     // Scopes can be specified either as an array or as a single, space-delimited string.
+     *     scopes: ['https://www.googleapis.com/auth/cloud-platform'],
+     *   });
+     *
+     *   // Acquire an auth client, and bind it to all future calls
+     *   const authClient = await auth.getClient();
+     *   google.options({auth: authClient});
+     *
+     *   // Do the magic
+     *   const res = await toolresults.projects.histories.executions.environments.get({
+     *     // Required. An Environment id.
+     *     environmentId: 'placeholder-value',
+     *     // Required. An Execution id.
+     *     executionId: 'placeholder-value',
+     *     // Required. A History id.
+     *     historyId: 'placeholder-value',
+     *     // Required. A Project id.
+     *     projectId: 'placeholder-value',
+     *   });
+     *   console.log(res.data);
+     *
+     *   // Example response
+     *   // {
+     *   //   "completionTime": {},
+     *   //   "creationTime": {},
+     *   //   "dimensionValue": [],
+     *   //   "displayName": "my_displayName",
+     *   //   "environmentId": "my_environmentId",
+     *   //   "environmentResult": {},
+     *   //   "executionId": "my_executionId",
+     *   //   "historyId": "my_historyId",
+     *   //   "projectId": "my_projectId",
+     *   //   "resultsStorage": {},
+     *   //   "shardSummaries": []
+     *   // }
+     * }
+     *
+     * main().catch(e => {
+     *   console.error(e);
+     *   throw e;
+     * });
+     *
+     * ```
      *
      * @param params - Parameters for request
      * @param options - Optionally override request options, such as `url`, `method`, and `encoding`.
@@ -3122,6 +3805,66 @@ export namespace toolresults_v1beta3 {
 
     /**
      * Lists Environments for a given Execution. The Environments are sorted by display name. May return any of the following canonical error codes: - PERMISSION_DENIED - if the user is not authorized to read project - INVALID_ARGUMENT - if the request is malformed - NOT_FOUND - if the containing Execution does not exist
+     * @example
+     * ```js
+     * // Before running the sample:
+     * // - Enable the API at:
+     * //   https://console.developers.google.com/apis/api/toolresults.googleapis.com
+     * // - Login into gcloud by running:
+     * //   ```sh
+     * //   $ gcloud auth application-default login
+     * //   ```
+     * // - Install the npm module by running:
+     * //   ```sh
+     * //   $ npm install googleapis
+     * //   ```
+     *
+     * const {google} = require('googleapis');
+     * const toolresults = google.toolresults('v1beta3');
+     *
+     * async function main() {
+     *   const auth = new google.auth.GoogleAuth({
+     *     // Scopes can be specified either as an array or as a single, space-delimited string.
+     *     scopes: ['https://www.googleapis.com/auth/cloud-platform'],
+     *   });
+     *
+     *   // Acquire an auth client, and bind it to all future calls
+     *   const authClient = await auth.getClient();
+     *   google.options({auth: authClient});
+     *
+     *   // Do the magic
+     *   const res = await toolresults.projects.histories.executions.environments.list(
+     *     {
+     *       // Required. An Execution id.
+     *       executionId: 'placeholder-value',
+     *       // Required. A History id.
+     *       historyId: 'placeholder-value',
+     *       // The maximum number of Environments to fetch. Default value: 25. The server will use this default if the field is not set or has a value of 0.
+     *       pageSize: 'placeholder-value',
+     *       // A continuation token to resume the query at the next item.
+     *       pageToken: 'placeholder-value',
+     *       // Required. A Project id.
+     *       projectId: 'placeholder-value',
+     *     },
+     *   );
+     *   console.log(res.data);
+     *
+     *   // Example response
+     *   // {
+     *   //   "environments": [],
+     *   //   "executionId": "my_executionId",
+     *   //   "historyId": "my_historyId",
+     *   //   "nextPageToken": "my_nextPageToken",
+     *   //   "projectId": "my_projectId"
+     *   // }
+     * }
+     *
+     * main().catch(e => {
+     *   console.error(e);
+     *   throw e;
+     * });
+     *
+     * ```
      *
      * @param params - Parameters for request
      * @param options - Optionally override request options, such as `url`, `method`, and `encoding`.
@@ -3286,6 +4029,58 @@ export namespace toolresults_v1beta3 {
 
     /**
      * Lists accessibility clusters for a given Step May return any of the following canonical error codes: - PERMISSION_DENIED - if the user is not authorized to read project - INVALID_ARGUMENT - if the request is malformed - FAILED_PRECONDITION - if an argument in the request happens to be invalid; e.g. if the locale format is incorrect - NOT_FOUND - if the containing Step does not exist
+     * @example
+     * ```js
+     * // Before running the sample:
+     * // - Enable the API at:
+     * //   https://console.developers.google.com/apis/api/toolresults.googleapis.com
+     * // - Login into gcloud by running:
+     * //   ```sh
+     * //   $ gcloud auth application-default login
+     * //   ```
+     * // - Install the npm module by running:
+     * //   ```sh
+     * //   $ npm install googleapis
+     * //   ```
+     *
+     * const {google} = require('googleapis');
+     * const toolresults = google.toolresults('v1beta3');
+     *
+     * async function main() {
+     *   const auth = new google.auth.GoogleAuth({
+     *     // Scopes can be specified either as an array or as a single, space-delimited string.
+     *     scopes: ['https://www.googleapis.com/auth/cloud-platform'],
+     *   });
+     *
+     *   // Acquire an auth client, and bind it to all future calls
+     *   const authClient = await auth.getClient();
+     *   google.options({auth: authClient});
+     *
+     *   // Do the magic
+     *   const res =
+     *     await toolresults.projects.histories.executions.steps.accessibilityClusters(
+     *       {
+     *         // The accepted format is the canonical Unicode format with hyphen as a delimiter. Language must be lowercase, Language Script - Capitalized, Region - UPPERCASE. See http://www.unicode.org/reports/tr35/#Unicode_locale_identifier for details. Required.
+     *         locale: 'placeholder-value',
+     *         // A full resource name of the step. For example, projects/my-project/histories/bh.1234567890abcdef/executions/ 1234567890123456789/steps/bs.1234567890abcdef Required.
+     *         name: 'projects/my-project/histories/my-historie/executions/my-execution/steps/my-step',
+     *       },
+     *     );
+     *   console.log(res.data);
+     *
+     *   // Example response
+     *   // {
+     *   //   "clusters": [],
+     *   //   "name": "my_name"
+     *   // }
+     * }
+     *
+     * main().catch(e => {
+     *   console.error(e);
+     *   throw e;
+     * });
+     *
+     * ```
      *
      * @param params - Parameters for request
      * @param options - Optionally override request options, such as `url`, `method`, and `encoding`.
@@ -3387,6 +4182,94 @@ export namespace toolresults_v1beta3 {
 
     /**
      * Creates a Step. The returned Step will have the id set. May return any of the following canonical error codes: - PERMISSION_DENIED - if the user is not authorized to write to project - INVALID_ARGUMENT - if the request is malformed - FAILED_PRECONDITION - if the step is too large (more than 10Mib) - NOT_FOUND - if the containing Execution does not exist
+     * @example
+     * ```js
+     * // Before running the sample:
+     * // - Enable the API at:
+     * //   https://console.developers.google.com/apis/api/toolresults.googleapis.com
+     * // - Login into gcloud by running:
+     * //   ```sh
+     * //   $ gcloud auth application-default login
+     * //   ```
+     * // - Install the npm module by running:
+     * //   ```sh
+     * //   $ npm install googleapis
+     * //   ```
+     *
+     * const {google} = require('googleapis');
+     * const toolresults = google.toolresults('v1beta3');
+     *
+     * async function main() {
+     *   const auth = new google.auth.GoogleAuth({
+     *     // Scopes can be specified either as an array or as a single, space-delimited string.
+     *     scopes: ['https://www.googleapis.com/auth/cloud-platform'],
+     *   });
+     *
+     *   // Acquire an auth client, and bind it to all future calls
+     *   const authClient = await auth.getClient();
+     *   google.options({auth: authClient});
+     *
+     *   // Do the magic
+     *   const res = await toolresults.projects.histories.executions.steps.create({
+     *     // Required. An Execution id.
+     *     executionId: 'placeholder-value',
+     *     // Required. A History id.
+     *     historyId: 'placeholder-value',
+     *     // Required. A Project id.
+     *     projectId: 'placeholder-value',
+     *     // A unique request ID for server to detect duplicated requests. For example, a UUID. Optional, but strongly recommended.
+     *     requestId: 'placeholder-value',
+     *
+     *     // Request body metadata
+     *     requestBody: {
+     *       // request body parameters
+     *       // {
+     *       //   "completionTime": {},
+     *       //   "creationTime": {},
+     *       //   "description": "my_description",
+     *       //   "deviceUsageDuration": {},
+     *       //   "dimensionValue": [],
+     *       //   "hasImages": false,
+     *       //   "labels": [],
+     *       //   "multiStep": {},
+     *       //   "name": "my_name",
+     *       //   "outcome": {},
+     *       //   "runDuration": {},
+     *       //   "state": "my_state",
+     *       //   "stepId": "my_stepId",
+     *       //   "testExecutionStep": {},
+     *       //   "toolExecutionStep": {}
+     *       // }
+     *     },
+     *   });
+     *   console.log(res.data);
+     *
+     *   // Example response
+     *   // {
+     *   //   "completionTime": {},
+     *   //   "creationTime": {},
+     *   //   "description": "my_description",
+     *   //   "deviceUsageDuration": {},
+     *   //   "dimensionValue": [],
+     *   //   "hasImages": false,
+     *   //   "labels": [],
+     *   //   "multiStep": {},
+     *   //   "name": "my_name",
+     *   //   "outcome": {},
+     *   //   "runDuration": {},
+     *   //   "state": "my_state",
+     *   //   "stepId": "my_stepId",
+     *   //   "testExecutionStep": {},
+     *   //   "toolExecutionStep": {}
+     *   // }
+     * }
+     *
+     * main().catch(e => {
+     *   console.error(e);
+     *   throw e;
+     * });
+     *
+     * ```
      *
      * @param params - Parameters for request
      * @param options - Optionally override request options, such as `url`, `method`, and `encoding`.
@@ -3479,6 +4362,72 @@ export namespace toolresults_v1beta3 {
 
     /**
      * Gets a Step. May return any of the following canonical error codes: - PERMISSION_DENIED - if the user is not authorized to read project - INVALID_ARGUMENT - if the request is malformed - NOT_FOUND - if the Step does not exist
+     * @example
+     * ```js
+     * // Before running the sample:
+     * // - Enable the API at:
+     * //   https://console.developers.google.com/apis/api/toolresults.googleapis.com
+     * // - Login into gcloud by running:
+     * //   ```sh
+     * //   $ gcloud auth application-default login
+     * //   ```
+     * // - Install the npm module by running:
+     * //   ```sh
+     * //   $ npm install googleapis
+     * //   ```
+     *
+     * const {google} = require('googleapis');
+     * const toolresults = google.toolresults('v1beta3');
+     *
+     * async function main() {
+     *   const auth = new google.auth.GoogleAuth({
+     *     // Scopes can be specified either as an array or as a single, space-delimited string.
+     *     scopes: ['https://www.googleapis.com/auth/cloud-platform'],
+     *   });
+     *
+     *   // Acquire an auth client, and bind it to all future calls
+     *   const authClient = await auth.getClient();
+     *   google.options({auth: authClient});
+     *
+     *   // Do the magic
+     *   const res = await toolresults.projects.histories.executions.steps.get({
+     *     // A Execution id. Required.
+     *     executionId: 'placeholder-value',
+     *     // A History id. Required.
+     *     historyId: 'placeholder-value',
+     *     // A Project id. Required.
+     *     projectId: 'placeholder-value',
+     *     // A Step id. Required.
+     *     stepId: 'placeholder-value',
+     *   });
+     *   console.log(res.data);
+     *
+     *   // Example response
+     *   // {
+     *   //   "completionTime": {},
+     *   //   "creationTime": {},
+     *   //   "description": "my_description",
+     *   //   "deviceUsageDuration": {},
+     *   //   "dimensionValue": [],
+     *   //   "hasImages": false,
+     *   //   "labels": [],
+     *   //   "multiStep": {},
+     *   //   "name": "my_name",
+     *   //   "outcome": {},
+     *   //   "runDuration": {},
+     *   //   "state": "my_state",
+     *   //   "stepId": "my_stepId",
+     *   //   "testExecutionStep": {},
+     *   //   "toolExecutionStep": {}
+     *   // }
+     * }
+     *
+     * main().catch(e => {
+     *   console.error(e);
+     *   throw e;
+     * });
+     *
+     * ```
      *
      * @param params - Parameters for request
      * @param options - Optionally override request options, such as `url`, `method`, and `encoding`.
@@ -3570,6 +4519,68 @@ export namespace toolresults_v1beta3 {
 
     /**
      * Retrieves a PerfMetricsSummary. May return any of the following error code(s): - NOT_FOUND - The specified PerfMetricsSummary does not exist
+     * @example
+     * ```js
+     * // Before running the sample:
+     * // - Enable the API at:
+     * //   https://console.developers.google.com/apis/api/toolresults.googleapis.com
+     * // - Login into gcloud by running:
+     * //   ```sh
+     * //   $ gcloud auth application-default login
+     * //   ```
+     * // - Install the npm module by running:
+     * //   ```sh
+     * //   $ npm install googleapis
+     * //   ```
+     *
+     * const {google} = require('googleapis');
+     * const toolresults = google.toolresults('v1beta3');
+     *
+     * async function main() {
+     *   const auth = new google.auth.GoogleAuth({
+     *     // Scopes can be specified either as an array or as a single, space-delimited string.
+     *     scopes: ['https://www.googleapis.com/auth/cloud-platform'],
+     *   });
+     *
+     *   // Acquire an auth client, and bind it to all future calls
+     *   const authClient = await auth.getClient();
+     *   google.options({auth: authClient});
+     *
+     *   // Do the magic
+     *   const res =
+     *     await toolresults.projects.histories.executions.steps.getPerfMetricsSummary(
+     *       {
+     *         // A tool results execution ID.
+     *         executionId: 'placeholder-value',
+     *         // A tool results history ID.
+     *         historyId: 'placeholder-value',
+     *         // The cloud project
+     *         projectId: 'placeholder-value',
+     *         // A tool results step ID.
+     *         stepId: 'placeholder-value',
+     *       },
+     *     );
+     *   console.log(res.data);
+     *
+     *   // Example response
+     *   // {
+     *   //   "appStartTime": {},
+     *   //   "executionId": "my_executionId",
+     *   //   "graphicsStats": {},
+     *   //   "historyId": "my_historyId",
+     *   //   "perfEnvironment": {},
+     *   //   "perfMetrics": [],
+     *   //   "projectId": "my_projectId",
+     *   //   "stepId": "my_stepId"
+     *   // }
+     * }
+     *
+     * main().catch(e => {
+     *   console.error(e);
+     *   throw e;
+     * });
+     *
+     * ```
      *
      * @param params - Parameters for request
      * @param options - Optionally override request options, such as `url`, `method`, and `encoding`.
@@ -3664,6 +4675,61 @@ export namespace toolresults_v1beta3 {
 
     /**
      * Lists Steps for a given Execution. The steps are sorted by creation_time in descending order. The step_id key will be used to order the steps with the same creation_time. May return any of the following canonical error codes: - PERMISSION_DENIED - if the user is not authorized to read project - INVALID_ARGUMENT - if the request is malformed - FAILED_PRECONDITION - if an argument in the request happens to be invalid; e.g. if an attempt is made to list the children of a nonexistent Step - NOT_FOUND - if the containing Execution does not exist
+     * @example
+     * ```js
+     * // Before running the sample:
+     * // - Enable the API at:
+     * //   https://console.developers.google.com/apis/api/toolresults.googleapis.com
+     * // - Login into gcloud by running:
+     * //   ```sh
+     * //   $ gcloud auth application-default login
+     * //   ```
+     * // - Install the npm module by running:
+     * //   ```sh
+     * //   $ npm install googleapis
+     * //   ```
+     *
+     * const {google} = require('googleapis');
+     * const toolresults = google.toolresults('v1beta3');
+     *
+     * async function main() {
+     *   const auth = new google.auth.GoogleAuth({
+     *     // Scopes can be specified either as an array or as a single, space-delimited string.
+     *     scopes: ['https://www.googleapis.com/auth/cloud-platform'],
+     *   });
+     *
+     *   // Acquire an auth client, and bind it to all future calls
+     *   const authClient = await auth.getClient();
+     *   google.options({auth: authClient});
+     *
+     *   // Do the magic
+     *   const res = await toolresults.projects.histories.executions.steps.list({
+     *     // A Execution id. Required.
+     *     executionId: 'placeholder-value',
+     *     // A History id. Required.
+     *     historyId: 'placeholder-value',
+     *     // The maximum number of Steps to fetch. Default value: 25. The server will use this default if the field is not set or has a value of 0. Optional.
+     *     pageSize: 'placeholder-value',
+     *     // A continuation token to resume the query at the next item. Optional.
+     *     pageToken: 'placeholder-value',
+     *     // A Project id. Required.
+     *     projectId: 'placeholder-value',
+     *   });
+     *   console.log(res.data);
+     *
+     *   // Example response
+     *   // {
+     *   //   "nextPageToken": "my_nextPageToken",
+     *   //   "steps": []
+     *   // }
+     * }
+     *
+     * main().catch(e => {
+     *   console.error(e);
+     *   throw e;
+     * });
+     *
+     * ```
      *
      * @param params - Parameters for request
      * @param options - Optionally override request options, such as `url`, `method`, and `encoding`.
@@ -3755,6 +4821,96 @@ export namespace toolresults_v1beta3 {
 
     /**
      * Updates an existing Step with the supplied partial entity. May return any of the following canonical error codes: - PERMISSION_DENIED - if the user is not authorized to write project - INVALID_ARGUMENT - if the request is malformed - FAILED_PRECONDITION - if the requested state transition is illegal (e.g try to upload a duplicate xml file), if the updated step is too large (more than 10Mib) - NOT_FOUND - if the containing Execution does not exist
+     * @example
+     * ```js
+     * // Before running the sample:
+     * // - Enable the API at:
+     * //   https://console.developers.google.com/apis/api/toolresults.googleapis.com
+     * // - Login into gcloud by running:
+     * //   ```sh
+     * //   $ gcloud auth application-default login
+     * //   ```
+     * // - Install the npm module by running:
+     * //   ```sh
+     * //   $ npm install googleapis
+     * //   ```
+     *
+     * const {google} = require('googleapis');
+     * const toolresults = google.toolresults('v1beta3');
+     *
+     * async function main() {
+     *   const auth = new google.auth.GoogleAuth({
+     *     // Scopes can be specified either as an array or as a single, space-delimited string.
+     *     scopes: ['https://www.googleapis.com/auth/cloud-platform'],
+     *   });
+     *
+     *   // Acquire an auth client, and bind it to all future calls
+     *   const authClient = await auth.getClient();
+     *   google.options({auth: authClient});
+     *
+     *   // Do the magic
+     *   const res = await toolresults.projects.histories.executions.steps.patch({
+     *     // A Execution id. Required.
+     *     executionId: 'placeholder-value',
+     *     // A History id. Required.
+     *     historyId: 'placeholder-value',
+     *     // A Project id. Required.
+     *     projectId: 'placeholder-value',
+     *     // A unique request ID for server to detect duplicated requests. For example, a UUID. Optional, but strongly recommended.
+     *     requestId: 'placeholder-value',
+     *     // A Step id. Required.
+     *     stepId: 'placeholder-value',
+     *
+     *     // Request body metadata
+     *     requestBody: {
+     *       // request body parameters
+     *       // {
+     *       //   "completionTime": {},
+     *       //   "creationTime": {},
+     *       //   "description": "my_description",
+     *       //   "deviceUsageDuration": {},
+     *       //   "dimensionValue": [],
+     *       //   "hasImages": false,
+     *       //   "labels": [],
+     *       //   "multiStep": {},
+     *       //   "name": "my_name",
+     *       //   "outcome": {},
+     *       //   "runDuration": {},
+     *       //   "state": "my_state",
+     *       //   "stepId": "my_stepId",
+     *       //   "testExecutionStep": {},
+     *       //   "toolExecutionStep": {}
+     *       // }
+     *     },
+     *   });
+     *   console.log(res.data);
+     *
+     *   // Example response
+     *   // {
+     *   //   "completionTime": {},
+     *   //   "creationTime": {},
+     *   //   "description": "my_description",
+     *   //   "deviceUsageDuration": {},
+     *   //   "dimensionValue": [],
+     *   //   "hasImages": false,
+     *   //   "labels": [],
+     *   //   "multiStep": {},
+     *   //   "name": "my_name",
+     *   //   "outcome": {},
+     *   //   "runDuration": {},
+     *   //   "state": "my_state",
+     *   //   "stepId": "my_stepId",
+     *   //   "testExecutionStep": {},
+     *   //   "toolExecutionStep": {}
+     *   // }
+     * }
+     *
+     * main().catch(e => {
+     *   console.error(e);
+     *   throw e;
+     * });
+     *
+     * ```
      *
      * @param params - Parameters for request
      * @param options - Optionally override request options, such as `url`, `method`, and `encoding`.
@@ -3847,6 +5003,81 @@ export namespace toolresults_v1beta3 {
 
     /**
      * Publish xml files to an existing Step. May return any of the following canonical error codes: - PERMISSION_DENIED - if the user is not authorized to write project - INVALID_ARGUMENT - if the request is malformed - FAILED_PRECONDITION - if the requested state transition is illegal, e.g. try to upload a duplicate xml file or a file too large. - NOT_FOUND - if the containing Execution does not exist
+     * @example
+     * ```js
+     * // Before running the sample:
+     * // - Enable the API at:
+     * //   https://console.developers.google.com/apis/api/toolresults.googleapis.com
+     * // - Login into gcloud by running:
+     * //   ```sh
+     * //   $ gcloud auth application-default login
+     * //   ```
+     * // - Install the npm module by running:
+     * //   ```sh
+     * //   $ npm install googleapis
+     * //   ```
+     *
+     * const {google} = require('googleapis');
+     * const toolresults = google.toolresults('v1beta3');
+     *
+     * async function main() {
+     *   const auth = new google.auth.GoogleAuth({
+     *     // Scopes can be specified either as an array or as a single, space-delimited string.
+     *     scopes: ['https://www.googleapis.com/auth/cloud-platform'],
+     *   });
+     *
+     *   // Acquire an auth client, and bind it to all future calls
+     *   const authClient = await auth.getClient();
+     *   google.options({auth: authClient});
+     *
+     *   // Do the magic
+     *   const res =
+     *     await toolresults.projects.histories.executions.steps.publishXunitXmlFiles({
+     *       // A Execution id. Required.
+     *       executionId: 'placeholder-value',
+     *       // A History id. Required.
+     *       historyId: 'placeholder-value',
+     *       // A Project id. Required.
+     *       projectId: 'placeholder-value',
+     *       // A Step id. Note: This step must include a TestExecutionStep. Required.
+     *       stepId: 'placeholder-value',
+     *
+     *       // Request body metadata
+     *       requestBody: {
+     *         // request body parameters
+     *         // {
+     *         //   "xunitXmlFiles": []
+     *         // }
+     *       },
+     *     });
+     *   console.log(res.data);
+     *
+     *   // Example response
+     *   // {
+     *   //   "completionTime": {},
+     *   //   "creationTime": {},
+     *   //   "description": "my_description",
+     *   //   "deviceUsageDuration": {},
+     *   //   "dimensionValue": [],
+     *   //   "hasImages": false,
+     *   //   "labels": [],
+     *   //   "multiStep": {},
+     *   //   "name": "my_name",
+     *   //   "outcome": {},
+     *   //   "runDuration": {},
+     *   //   "state": "my_state",
+     *   //   "stepId": "my_stepId",
+     *   //   "testExecutionStep": {},
+     *   //   "toolExecutionStep": {}
+     *   // }
+     * }
+     *
+     * main().catch(e => {
+     *   console.error(e);
+     *   throw e;
+     * });
+     *
+     * ```
      *
      * @param params - Parameters for request
      * @param options - Optionally override request options, such as `url`, `method`, and `encoding`.
@@ -4095,6 +5326,83 @@ export namespace toolresults_v1beta3 {
 
     /**
      * Creates a PerfMetricsSummary resource. Returns the existing one if it has already been created. May return any of the following error code(s): - NOT_FOUND - The containing Step does not exist
+     * @example
+     * ```js
+     * // Before running the sample:
+     * // - Enable the API at:
+     * //   https://console.developers.google.com/apis/api/toolresults.googleapis.com
+     * // - Login into gcloud by running:
+     * //   ```sh
+     * //   $ gcloud auth application-default login
+     * //   ```
+     * // - Install the npm module by running:
+     * //   ```sh
+     * //   $ npm install googleapis
+     * //   ```
+     *
+     * const {google} = require('googleapis');
+     * const toolresults = google.toolresults('v1beta3');
+     *
+     * async function main() {
+     *   const auth = new google.auth.GoogleAuth({
+     *     // Scopes can be specified either as an array or as a single, space-delimited string.
+     *     scopes: ['https://www.googleapis.com/auth/cloud-platform'],
+     *   });
+     *
+     *   // Acquire an auth client, and bind it to all future calls
+     *   const authClient = await auth.getClient();
+     *   google.options({auth: authClient});
+     *
+     *   // Do the magic
+     *   const res =
+     *     await toolresults.projects.histories.executions.steps.perfMetricsSummary.create(
+     *       {
+     *         // A tool results execution ID.
+     *         executionId: 'placeholder-value',
+     *         // A tool results history ID.
+     *         historyId: 'placeholder-value',
+     *         // The cloud project
+     *         projectId: 'placeholder-value',
+     *         // A tool results step ID.
+     *         stepId: 'placeholder-value',
+     *
+     *         // Request body metadata
+     *         requestBody: {
+     *           // request body parameters
+     *           // {
+     *           //   "appStartTime": {},
+     *           //   "executionId": "my_executionId",
+     *           //   "graphicsStats": {},
+     *           //   "historyId": "my_historyId",
+     *           //   "perfEnvironment": {},
+     *           //   "perfMetrics": [],
+     *           //   "projectId": "my_projectId",
+     *           //   "stepId": "my_stepId"
+     *           // }
+     *         },
+     *       },
+     *     );
+     *   console.log(res.data);
+     *
+     *   // Example response
+     *   // {
+     *   //   "appStartTime": {},
+     *   //   "executionId": "my_executionId",
+     *   //   "graphicsStats": {},
+     *   //   "historyId": "my_historyId",
+     *   //   "perfEnvironment": {},
+     *   //   "perfMetrics": [],
+     *   //   "projectId": "my_projectId",
+     *   //   "stepId": "my_stepId"
+     *   // }
+     * }
+     *
+     * main().catch(e => {
+     *   console.error(e);
+     *   throw e;
+     * });
+     *
+     * ```
      *
      * @param params - Parameters for request
      * @param options - Optionally override request options, such as `url`, `method`, and `encoding`.
@@ -4224,6 +5532,79 @@ export namespace toolresults_v1beta3 {
 
     /**
      * Creates a PerfSampleSeries. May return any of the following error code(s): - ALREADY_EXISTS - PerfMetricSummary already exists for the given Step - NOT_FOUND - The containing Step does not exist
+     * @example
+     * ```js
+     * // Before running the sample:
+     * // - Enable the API at:
+     * //   https://console.developers.google.com/apis/api/toolresults.googleapis.com
+     * // - Login into gcloud by running:
+     * //   ```sh
+     * //   $ gcloud auth application-default login
+     * //   ```
+     * // - Install the npm module by running:
+     * //   ```sh
+     * //   $ npm install googleapis
+     * //   ```
+     *
+     * const {google} = require('googleapis');
+     * const toolresults = google.toolresults('v1beta3');
+     *
+     * async function main() {
+     *   const auth = new google.auth.GoogleAuth({
+     *     // Scopes can be specified either as an array or as a single, space-delimited string.
+     *     scopes: ['https://www.googleapis.com/auth/cloud-platform'],
+     *   });
+     *
+     *   // Acquire an auth client, and bind it to all future calls
+     *   const authClient = await auth.getClient();
+     *   google.options({auth: authClient});
+     *
+     *   // Do the magic
+     *   const res =
+     *     await toolresults.projects.histories.executions.steps.perfSampleSeries.create(
+     *       {
+     *         // A tool results execution ID.
+     *         executionId: 'placeholder-value',
+     *         // A tool results history ID.
+     *         historyId: 'placeholder-value',
+     *         // The cloud project
+     *         projectId: 'placeholder-value',
+     *         // A tool results step ID.
+     *         stepId: 'placeholder-value',
+     *
+     *         // Request body metadata
+     *         requestBody: {
+     *           // request body parameters
+     *           // {
+     *           //   "basicPerfSampleSeries": {},
+     *           //   "executionId": "my_executionId",
+     *           //   "historyId": "my_historyId",
+     *           //   "projectId": "my_projectId",
+     *           //   "sampleSeriesId": "my_sampleSeriesId",
+     *           //   "stepId": "my_stepId"
+     *           // }
+     *         },
+     *       },
+     *     );
+     *   console.log(res.data);
+     *
+     *   // Example response
+     *   // {
+     *   //   "basicPerfSampleSeries": {},
+     *   //   "executionId": "my_executionId",
+     *   //   "historyId": "my_historyId",
+     *   //   "projectId": "my_projectId",
+     *   //   "sampleSeriesId": "my_sampleSeriesId",
+     *   //   "stepId": "my_stepId"
+     *   // }
+     * }
+     *
+     * main().catch(e => {
+     *   console.error(e);
+     *   throw e;
+     * });
+     *
+     * ```
      *
      * @param params - Parameters for request
      * @param options - Optionally override request options, such as `url`, `method`, and `encoding`.
@@ -4316,6 +5697,66 @@ export namespace toolresults_v1beta3 {
 
     /**
      * Gets a PerfSampleSeries. May return any of the following error code(s): - NOT_FOUND - The specified PerfSampleSeries does not exist
+     * @example
+     * ```js
+     * // Before running the sample:
+     * // - Enable the API at:
+     * //   https://console.developers.google.com/apis/api/toolresults.googleapis.com
+     * // - Login into gcloud by running:
+     * //   ```sh
+     * //   $ gcloud auth application-default login
+     * //   ```
+     * // - Install the npm module by running:
+     * //   ```sh
+     * //   $ npm install googleapis
+     * //   ```
+     *
+     * const {google} = require('googleapis');
+     * const toolresults = google.toolresults('v1beta3');
+     *
+     * async function main() {
+     *   const auth = new google.auth.GoogleAuth({
+     *     // Scopes can be specified either as an array or as a single, space-delimited string.
+     *     scopes: ['https://www.googleapis.com/auth/cloud-platform'],
+     *   });
+     *
+     *   // Acquire an auth client, and bind it to all future calls
+     *   const authClient = await auth.getClient();
+     *   google.options({auth: authClient});
+     *
+     *   // Do the magic
+     *   const res =
+     *     await toolresults.projects.histories.executions.steps.perfSampleSeries.get({
+     *       // A tool results execution ID.
+     *       executionId: 'placeholder-value',
+     *       // A tool results history ID.
+     *       historyId: 'placeholder-value',
+     *       // The cloud project
+     *       projectId: 'placeholder-value',
+     *       // A sample series id
+     *       sampleSeriesId: 'placeholder-value',
+     *       // A tool results step ID.
+     *       stepId: 'placeholder-value',
+     *     });
+     *   console.log(res.data);
+     *
+     *   // Example response
+     *   // {
+     *   //   "basicPerfSampleSeries": {},
+     *   //   "executionId": "my_executionId",
+     *   //   "historyId": "my_historyId",
+     *   //   "projectId": "my_projectId",
+     *   //   "sampleSeriesId": "my_sampleSeriesId",
+     *   //   "stepId": "my_stepId"
+     *   // }
+     * }
+     *
+     * main().catch(e => {
+     *   console.error(e);
+     *   throw e;
+     * });
+     *
+     * ```
      *
      * @param params - Parameters for request
      * @param options - Optionally override request options, such as `url`, `method`, and `encoding`.
@@ -4420,6 +5861,63 @@ export namespace toolresults_v1beta3 {
 
     /**
      * Lists PerfSampleSeries for a given Step. The request provides an optional filter which specifies one or more PerfMetricsType to include in the result; if none returns all. The resulting PerfSampleSeries are sorted by ids. May return any of the following canonical error codes: - NOT_FOUND - The containing Step does not exist
+     * @example
+     * ```js
+     * // Before running the sample:
+     * // - Enable the API at:
+     * //   https://console.developers.google.com/apis/api/toolresults.googleapis.com
+     * // - Login into gcloud by running:
+     * //   ```sh
+     * //   $ gcloud auth application-default login
+     * //   ```
+     * // - Install the npm module by running:
+     * //   ```sh
+     * //   $ npm install googleapis
+     * //   ```
+     *
+     * const {google} = require('googleapis');
+     * const toolresults = google.toolresults('v1beta3');
+     *
+     * async function main() {
+     *   const auth = new google.auth.GoogleAuth({
+     *     // Scopes can be specified either as an array or as a single, space-delimited string.
+     *     scopes: ['https://www.googleapis.com/auth/cloud-platform'],
+     *   });
+     *
+     *   // Acquire an auth client, and bind it to all future calls
+     *   const authClient = await auth.getClient();
+     *   google.options({auth: authClient});
+     *
+     *   // Do the magic
+     *   const res =
+     *     await toolresults.projects.histories.executions.steps.perfSampleSeries.list(
+     *       {
+     *         // A tool results execution ID.
+     *         executionId: 'placeholder-value',
+     *         // Specify one or more PerfMetricType values such as CPU to filter the result
+     *         filter: 'placeholder-value',
+     *         // A tool results history ID.
+     *         historyId: 'placeholder-value',
+     *         // The cloud project
+     *         projectId: 'placeholder-value',
+     *         // A tool results step ID.
+     *         stepId: 'placeholder-value',
+     *       },
+     *     );
+     *   console.log(res.data);
+     *
+     *   // Example response
+     *   // {
+     *   //   "perfSampleSeries": []
+     *   // }
+     * }
+     *
+     * main().catch(e => {
+     *   console.error(e);
+     *   throw e;
+     * });
+     *
+     * ```
      *
      * @param params - Parameters for request
      * @param options - Optionally override request options, such as `url`, `method`, and `encoding`.
@@ -4596,6 +6094,71 @@ export namespace toolresults_v1beta3 {
 
     /**
      * Creates a batch of PerfSamples - a client can submit multiple batches of Perf Samples through repeated calls to this method in order to split up a large request payload - duplicates and existing timestamp entries will be ignored. - the batch operation may partially succeed - the set of elements successfully inserted is returned in the response (omits items which already existed in the database). May return any of the following canonical error codes: - NOT_FOUND - The containing PerfSampleSeries does not exist
+     * @example
+     * ```js
+     * // Before running the sample:
+     * // - Enable the API at:
+     * //   https://console.developers.google.com/apis/api/toolresults.googleapis.com
+     * // - Login into gcloud by running:
+     * //   ```sh
+     * //   $ gcloud auth application-default login
+     * //   ```
+     * // - Install the npm module by running:
+     * //   ```sh
+     * //   $ npm install googleapis
+     * //   ```
+     *
+     * const {google} = require('googleapis');
+     * const toolresults = google.toolresults('v1beta3');
+     *
+     * async function main() {
+     *   const auth = new google.auth.GoogleAuth({
+     *     // Scopes can be specified either as an array or as a single, space-delimited string.
+     *     scopes: ['https://www.googleapis.com/auth/cloud-platform'],
+     *   });
+     *
+     *   // Acquire an auth client, and bind it to all future calls
+     *   const authClient = await auth.getClient();
+     *   google.options({auth: authClient});
+     *
+     *   // Do the magic
+     *   const res =
+     *     await toolresults.projects.histories.executions.steps.perfSampleSeries.samples.batchCreate(
+     *       {
+     *         // A tool results execution ID.
+     *         executionId: 'placeholder-value',
+     *         // A tool results history ID.
+     *         historyId: 'placeholder-value',
+     *         // The cloud project
+     *         projectId: 'placeholder-value',
+     *         // A sample series id
+     *         sampleSeriesId: 'placeholder-value',
+     *         // A tool results step ID.
+     *         stepId: 'placeholder-value',
+     *
+     *         // Request body metadata
+     *         requestBody: {
+     *           // request body parameters
+     *           // {
+     *           //   "perfSamples": []
+     *           // }
+     *         },
+     *       },
+     *     );
+     *   console.log(res.data);
+     *
+     *   // Example response
+     *   // {
+     *   //   "perfSamples": []
+     *   // }
+     * }
+     *
+     * main().catch(e => {
+     *   console.error(e);
+     *   throw e;
+     * });
+     *
+     * ```
      *
      * @param params - Parameters for request
      * @param options - Optionally override request options, such as `url`, `method`, and `encoding`.
@@ -4706,6 +6269,68 @@ export namespace toolresults_v1beta3 {
 
     /**
      * Lists the Performance Samples of a given Sample Series - The list results are sorted by timestamps ascending - The default page size is 500 samples; and maximum size allowed 5000 - The response token indicates the last returned PerfSample timestamp - When the results size exceeds the page size, submit a subsequent request including the page token to return the rest of the samples up to the page limit May return any of the following canonical error codes: - OUT_OF_RANGE - The specified request page_token is out of valid range - NOT_FOUND - The containing PerfSampleSeries does not exist
+     * @example
+     * ```js
+     * // Before running the sample:
+     * // - Enable the API at:
+     * //   https://console.developers.google.com/apis/api/toolresults.googleapis.com
+     * // - Login into gcloud by running:
+     * //   ```sh
+     * //   $ gcloud auth application-default login
+     * //   ```
+     * // - Install the npm module by running:
+     * //   ```sh
+     * //   $ npm install googleapis
+     * //   ```
+     *
+     * const {google} = require('googleapis');
+     * const toolresults = google.toolresults('v1beta3');
+     *
+     * async function main() {
+     *   const auth = new google.auth.GoogleAuth({
+     *     // Scopes can be specified either as an array or as a single, space-delimited string.
+     *     scopes: ['https://www.googleapis.com/auth/cloud-platform'],
+     *   });
+     *
+     *   // Acquire an auth client, and bind it to all future calls
+     *   const authClient = await auth.getClient();
+     *   google.options({auth: authClient});
+     *
+     *   // Do the magic
+     *   const res =
+     *     await toolresults.projects.histories.executions.steps.perfSampleSeries.samples.list(
+     *       {
+     *         // A tool results execution ID.
+     *         executionId: 'placeholder-value',
+     *         // A tool results history ID.
+     *         historyId: 'placeholder-value',
+     *         // The default page size is 500 samples, and the maximum size is 5000. If the page_size is greater than 5000, the effective page size will be 5000
+     *         pageSize: 'placeholder-value',
+     *         // Optional, the next_page_token returned in the previous response
+     *         pageToken: 'placeholder-value',
+     *         // The cloud project
+     *         projectId: 'placeholder-value',
+     *         // A sample series id
+     *         sampleSeriesId: 'placeholder-value',
+     *         // A tool results step ID.
+     *         stepId: 'placeholder-value',
+     *       },
+     *     );
+     *   console.log(res.data);
+     *
+     *   // Example response
+     *   // {
+     *   //   "nextPageToken": "my_nextPageToken",
+     *   //   "perfSamples": []
+     *   // }
+     * }
+     *
+     * main().catch(e => {
+     *   console.error(e);
+     *   throw e;
+     * });
+     *
+     * ```
      *
      * @param params - Parameters for request
      * @param options - Optionally override request options, such as `url`, `method`, and `encoding`.
@@ -4879,6 +6504,69 @@ export namespace toolresults_v1beta3 {
 
     /**
      * Gets details of a Test Case for a Step. Experimental test cases API. Still in active development. May return any of the following canonical error codes: - PERMISSION_DENIED - if the user is not authorized to write to project - INVALID_ARGUMENT - if the request is malformed - NOT_FOUND - if the containing Test Case does not exist
+     * @example
+     * ```js
+     * // Before running the sample:
+     * // - Enable the API at:
+     * //   https://console.developers.google.com/apis/api/toolresults.googleapis.com
+     * // - Login into gcloud by running:
+     * //   ```sh
+     * //   $ gcloud auth application-default login
+     * //   ```
+     * // - Install the npm module by running:
+     * //   ```sh
+     * //   $ npm install googleapis
+     * //   ```
+     *
+     * const {google} = require('googleapis');
+     * const toolresults = google.toolresults('v1beta3');
+     *
+     * async function main() {
+     *   const auth = new google.auth.GoogleAuth({
+     *     // Scopes can be specified either as an array or as a single, space-delimited string.
+     *     scopes: ['https://www.googleapis.com/auth/cloud-platform'],
+     *   });
+     *
+     *   // Acquire an auth client, and bind it to all future calls
+     *   const authClient = await auth.getClient();
+     *   google.options({auth: authClient});
+     *
+     *   // Do the magic
+     *   const res =
+     *     await toolresults.projects.histories.executions.steps.testCases.get({
+     *       // A Execution id Required.
+     *       executionId: 'placeholder-value',
+     *       // A History id. Required.
+     *       historyId: 'placeholder-value',
+     *       // A Project id. Required.
+     *       projectId: 'placeholder-value',
+     *       // A Step id. Note: This step must include a TestExecutionStep. Required.
+     *       stepId: 'placeholder-value',
+     *       // A Test Case id. Required.
+     *       testCaseId: 'placeholder-value',
+     *     });
+     *   console.log(res.data);
+     *
+     *   // Example response
+     *   // {
+     *   //   "elapsedTime": {},
+     *   //   "endTime": {},
+     *   //   "skippedMessage": "my_skippedMessage",
+     *   //   "stackTraces": [],
+     *   //   "startTime": {},
+     *   //   "status": "my_status",
+     *   //   "testCaseId": "my_testCaseId",
+     *   //   "testCaseReference": {},
+     *   //   "toolOutputs": []
+     *   // }
+     * }
+     *
+     * main().catch(e => {
+     *   console.error(e);
+     *   throw e;
+     * });
+     *
+     * ```
      *
      * @param params - Parameters for request
      * @param options - Optionally override request options, such as `url`, `method`, and `encoding`.
@@ -4983,6 +6671,64 @@ export namespace toolresults_v1beta3 {
 
     /**
      * Lists Test Cases attached to a Step. Experimental test cases API. Still in active development. May return any of the following canonical error codes: - PERMISSION_DENIED - if the user is not authorized to write to project - INVALID_ARGUMENT - if the request is malformed - NOT_FOUND - if the containing Step does not exist
+     * @example
+     * ```js
+     * // Before running the sample:
+     * // - Enable the API at:
+     * //   https://console.developers.google.com/apis/api/toolresults.googleapis.com
+     * // - Login into gcloud by running:
+     * //   ```sh
+     * //   $ gcloud auth application-default login
+     * //   ```
+     * // - Install the npm module by running:
+     * //   ```sh
+     * //   $ npm install googleapis
+     * //   ```
+     *
+     * const {google} = require('googleapis');
+     * const toolresults = google.toolresults('v1beta3');
+     *
+     * async function main() {
+     *   const auth = new google.auth.GoogleAuth({
+     *     // Scopes can be specified either as an array or as a single, space-delimited string.
+     *     scopes: ['https://www.googleapis.com/auth/cloud-platform'],
+     *   });
+     *
+     *   // Acquire an auth client, and bind it to all future calls
+     *   const authClient = await auth.getClient();
+     *   google.options({auth: authClient});
+     *
+     *   // Do the magic
+     *   const res =
+     *     await toolresults.projects.histories.executions.steps.testCases.list({
+     *       // A Execution id Required.
+     *       executionId: 'placeholder-value',
+     *       // A History id. Required.
+     *       historyId: 'placeholder-value',
+     *       // The maximum number of TestCases to fetch. Default value: 100. The server will use this default if the field is not set or has a value of 0. Optional.
+     *       pageSize: 'placeholder-value',
+     *       // A continuation token to resume the query at the next item. Optional.
+     *       pageToken: 'placeholder-value',
+     *       // A Project id. Required.
+     *       projectId: 'placeholder-value',
+     *       // A Step id. Note: This step must include a TestExecutionStep. Required.
+     *       stepId: 'placeholder-value',
+     *     });
+     *   console.log(res.data);
+     *
+     *   // Example response
+     *   // {
+     *   //   "nextPageToken": "my_nextPageToken",
+     *   //   "testCases": []
+     *   // }
+     * }
+     *
+     * main().catch(e => {
+     *   console.error(e);
+     *   throw e;
+     * });
+     *
+     * ```
      *
      * @param params - Parameters for request
      * @param options - Optionally override request options, such as `url`, `method`, and `encoding`.
@@ -5135,6 +6881,64 @@ export namespace toolresults_v1beta3 {
 
     /**
      * Lists thumbnails of images attached to a step. May return any of the following canonical error codes: - PERMISSION_DENIED - if the user is not authorized to read from the project, or from any of the images - INVALID_ARGUMENT - if the request is malformed - NOT_FOUND - if the step does not exist, or if any of the images do not exist
+     * @example
+     * ```js
+     * // Before running the sample:
+     * // - Enable the API at:
+     * //   https://console.developers.google.com/apis/api/toolresults.googleapis.com
+     * // - Login into gcloud by running:
+     * //   ```sh
+     * //   $ gcloud auth application-default login
+     * //   ```
+     * // - Install the npm module by running:
+     * //   ```sh
+     * //   $ npm install googleapis
+     * //   ```
+     *
+     * const {google} = require('googleapis');
+     * const toolresults = google.toolresults('v1beta3');
+     *
+     * async function main() {
+     *   const auth = new google.auth.GoogleAuth({
+     *     // Scopes can be specified either as an array or as a single, space-delimited string.
+     *     scopes: ['https://www.googleapis.com/auth/cloud-platform'],
+     *   });
+     *
+     *   // Acquire an auth client, and bind it to all future calls
+     *   const authClient = await auth.getClient();
+     *   google.options({auth: authClient});
+     *
+     *   // Do the magic
+     *   const res =
+     *     await toolresults.projects.histories.executions.steps.thumbnails.list({
+     *       // An Execution id. Required.
+     *       executionId: 'placeholder-value',
+     *       // A History id. Required.
+     *       historyId: 'placeholder-value',
+     *       // The maximum number of thumbnails to fetch. Default value: 50. The server will use this default if the field is not set or has a value of 0. Optional.
+     *       pageSize: 'placeholder-value',
+     *       // A continuation token to resume the query at the next item. Optional.
+     *       pageToken: 'placeholder-value',
+     *       // A Project id. Required.
+     *       projectId: 'placeholder-value',
+     *       // A Step id. Required.
+     *       stepId: 'placeholder-value',
+     *     });
+     *   console.log(res.data);
+     *
+     *   // Example response
+     *   // {
+     *   //   "nextPageToken": "my_nextPageToken",
+     *   //   "thumbnails": []
+     *   // }
+     * }
+     *
+     * main().catch(e => {
+     *   console.error(e);
+     *   throw e;
+     * });
+     *
+     * ```
      *
      * @param params - Parameters for request
      * @param options - Optionally override request options, such as `url`, `method`, and `encoding`.