@googleapis/merchantapi 5.0.0 → 8.0.0

package/reviews_v1beta.ts

@@ -23,7 +23,7 @@ import {
   Compute,
   UserRefreshClient,
   BaseExternalAccountClient,
-  GaxiosPromise,
+  GaxiosResponseWithHTTP2,
   GoogleConfigurable,
   createAPIRequest,
   MethodOptions,
@@ -411,7 +411,7 @@ export namespace merchantapi_reviews_v1beta {
      */
     cons?: string[] | null;
     /**
-     * Required. The content of the review.
+     * Optional. The content of the review. If empty, the content might still get populated from pros and cons.
      */
     content?: string | null;
     /**
@@ -595,7 +595,7 @@ export namespace merchantapi_reviews_v1beta {
      */
     eventTime?: string | null;
     /**
-     * Optional. The product expiration time. This field will not bet set if the notification is sent for a product deletion event.
+     * Optional. The product expiration time. This field will not be set if the notification is sent for a product deletion event.
      */
     expirationTime?: string | null;
     /**
@@ -650,6 +650,50 @@ export namespace merchantapi_reviews_v1beta {
 
     /**
      * Deletes merchant review.
+     * @example
+     * ```js
+     * // Before running the sample:
+     * // - Enable the API at:
+     * //   https://console.developers.google.com/apis/api/merchantapi.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 merchantapi = google.merchantapi('reviews_v1beta');
+     *
+     * 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/content'],
+     *   });
+     *
+     *   // 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 merchantapi.accounts.merchantReviews.delete({
+     *     // Required. The ID of the merchant review. Format: accounts/{account\}/merchantReviews/{merchantReview\}
+     *     name: 'accounts/my-account/merchantReviews/my-merchantReview',
+     *   });
+     *   console.log(res.data);
+     *
+     *   // Example response
+     *   // {}
+     * }
+     *
+     * 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`.
@@ -659,11 +703,11 @@ export namespace merchantapi_reviews_v1beta {
     delete(
       params: Params$Resource$Accounts$Merchantreviews$Delete,
       options: StreamMethodOptions
-    ): GaxiosPromise<Readable>;
+    ): Promise<GaxiosResponseWithHTTP2<Readable>>;
     delete(
       params?: Params$Resource$Accounts$Merchantreviews$Delete,
       options?: MethodOptions
-    ): GaxiosPromise<Schema$Empty>;
+    ): Promise<GaxiosResponseWithHTTP2<Schema$Empty>>;
     delete(
       params: Params$Resource$Accounts$Merchantreviews$Delete,
       options: StreamMethodOptions | BodyResponseCallback<Readable>,
@@ -692,7 +736,10 @@ export namespace merchantapi_reviews_v1beta {
       callback?:
         | BodyResponseCallback<Schema$Empty>
         | BodyResponseCallback<Readable>
-    ): void | GaxiosPromise<Schema$Empty> | GaxiosPromise<Readable> {
+    ):
+      | void
+      | Promise<GaxiosResponseWithHTTP2<Schema$Empty>>
+      | Promise<GaxiosResponseWithHTTP2<Readable>> {
       let params = (paramsOrCallback ||
         {}) as Params$Resource$Accounts$Merchantreviews$Delete;
       let options = (optionsOrCallback || {}) as MethodOptions;
@@ -738,6 +785,57 @@ export namespace merchantapi_reviews_v1beta {
 
     /**
      * Gets a merchant review.
+     * @example
+     * ```js
+     * // Before running the sample:
+     * // - Enable the API at:
+     * //   https://console.developers.google.com/apis/api/merchantapi.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 merchantapi = google.merchantapi('reviews_v1beta');
+     *
+     * 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/content'],
+     *   });
+     *
+     *   // 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 merchantapi.accounts.merchantReviews.get({
+     *     // Required. The ID of the merchant review. Format: accounts/{account\}/merchantReviews/{merchantReview\}
+     *     name: 'accounts/my-account/merchantReviews/my-merchantReview',
+     *   });
+     *   console.log(res.data);
+     *
+     *   // Example response
+     *   // {
+     *   //   "attributes": {},
+     *   //   "customAttributes": [],
+     *   //   "dataSource": "my_dataSource",
+     *   //   "merchantReviewId": "my_merchantReviewId",
+     *   //   "merchantReviewStatus": {},
+     *   //   "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`.
@@ -747,11 +845,11 @@ export namespace merchantapi_reviews_v1beta {
     get(
       params: Params$Resource$Accounts$Merchantreviews$Get,
       options: StreamMethodOptions
-    ): GaxiosPromise<Readable>;
+    ): Promise<GaxiosResponseWithHTTP2<Readable>>;
     get(
       params?: Params$Resource$Accounts$Merchantreviews$Get,
       options?: MethodOptions
-    ): GaxiosPromise<Schema$MerchantReview>;
+    ): Promise<GaxiosResponseWithHTTP2<Schema$MerchantReview>>;
     get(
       params: Params$Resource$Accounts$Merchantreviews$Get,
       options: StreamMethodOptions | BodyResponseCallback<Readable>,
@@ -780,7 +878,10 @@ export namespace merchantapi_reviews_v1beta {
       callback?:
         | BodyResponseCallback<Schema$MerchantReview>
         | BodyResponseCallback<Readable>
-    ): void | GaxiosPromise<Schema$MerchantReview> | GaxiosPromise<Readable> {
+    ):
+      | void
+      | Promise<GaxiosResponseWithHTTP2<Schema$MerchantReview>>
+      | Promise<GaxiosResponseWithHTTP2<Readable>> {
       let params = (paramsOrCallback ||
         {}) as Params$Resource$Accounts$Merchantreviews$Get;
       let options = (optionsOrCallback || {}) as MethodOptions;
@@ -826,6 +927,72 @@ export namespace merchantapi_reviews_v1beta {
 
     /**
      * Inserts a review for your Merchant Center account. If the review already exists, then the review is replaced with the new instance.
+     * @example
+     * ```js
+     * // Before running the sample:
+     * // - Enable the API at:
+     * //   https://console.developers.google.com/apis/api/merchantapi.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 merchantapi = google.merchantapi('reviews_v1beta');
+     *
+     * 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/content'],
+     *   });
+     *
+     *   // 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 merchantapi.accounts.merchantReviews.insert({
+     *     // Required. The data source of the [merchantreview](https://support.google.com/merchants/answer/7045996?sjid=5253581244217581976-EU) Format: `accounts/{account\}/dataSources/{datasource\}`.
+     *     dataSource: 'placeholder-value',
+     *     // Required. The account where the merchant review will be inserted. Format: accounts/{account\}
+     *     parent: 'accounts/my-account',
+     *
+     *     // Request body metadata
+     *     requestBody: {
+     *       // request body parameters
+     *       // {
+     *       //   "attributes": {},
+     *       //   "customAttributes": [],
+     *       //   "dataSource": "my_dataSource",
+     *       //   "merchantReviewId": "my_merchantReviewId",
+     *       //   "merchantReviewStatus": {},
+     *       //   "name": "my_name"
+     *       // }
+     *     },
+     *   });
+     *   console.log(res.data);
+     *
+     *   // Example response
+     *   // {
+     *   //   "attributes": {},
+     *   //   "customAttributes": [],
+     *   //   "dataSource": "my_dataSource",
+     *   //   "merchantReviewId": "my_merchantReviewId",
+     *   //   "merchantReviewStatus": {},
+     *   //   "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`.
@@ -835,11 +1002,11 @@ export namespace merchantapi_reviews_v1beta {
     insert(
       params: Params$Resource$Accounts$Merchantreviews$Insert,
       options: StreamMethodOptions
-    ): GaxiosPromise<Readable>;
+    ): Promise<GaxiosResponseWithHTTP2<Readable>>;
     insert(
       params?: Params$Resource$Accounts$Merchantreviews$Insert,
       options?: MethodOptions
-    ): GaxiosPromise<Schema$MerchantReview>;
+    ): Promise<GaxiosResponseWithHTTP2<Schema$MerchantReview>>;
     insert(
       params: Params$Resource$Accounts$Merchantreviews$Insert,
       options: StreamMethodOptions | BodyResponseCallback<Readable>,
@@ -868,7 +1035,10 @@ export namespace merchantapi_reviews_v1beta {
       callback?:
         | BodyResponseCallback<Schema$MerchantReview>
         | BodyResponseCallback<Readable>
-    ): void | GaxiosPromise<Schema$MerchantReview> | GaxiosPromise<Readable> {
+    ):
+      | void
+      | Promise<GaxiosResponseWithHTTP2<Schema$MerchantReview>>
+      | Promise<GaxiosResponseWithHTTP2<Readable>> {
       let params = (paramsOrCallback ||
         {}) as Params$Resource$Accounts$Merchantreviews$Insert;
       let options = (optionsOrCallback || {}) as MethodOptions;
@@ -913,6 +1083,57 @@ export namespace merchantapi_reviews_v1beta {
 
     /**
      * Lists merchant reviews.
+     * @example
+     * ```js
+     * // Before running the sample:
+     * // - Enable the API at:
+     * //   https://console.developers.google.com/apis/api/merchantapi.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 merchantapi = google.merchantapi('reviews_v1beta');
+     *
+     * 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/content'],
+     *   });
+     *
+     *   // 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 merchantapi.accounts.merchantReviews.list({
+     *     // Optional. The maximum number of merchant reviews to return. The service can return fewer than this value. The maximum value is 1000; values above 1000 are coerced to 1000. If unspecified, the maximum number of reviews is returned.
+     *     pageSize: 'placeholder-value',
+     *     // Optional. A page token, received from a previous `ListMerchantReviews` call. Provide this to retrieve the subsequent page. When paginating, all other parameters provided to `ListMerchantReviews` must match the call that provided the page token.
+     *     pageToken: 'placeholder-value',
+     *     // Required. The account to list merchant reviews for. Format: accounts/{account\}
+     *     parent: 'accounts/my-account',
+     *   });
+     *   console.log(res.data);
+     *
+     *   // Example response
+     *   // {
+     *   //   "merchantReviews": [],
+     *   //   "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`.
@@ -922,11 +1143,11 @@ export namespace merchantapi_reviews_v1beta {
     list(
       params: Params$Resource$Accounts$Merchantreviews$List,
       options: StreamMethodOptions
-    ): GaxiosPromise<Readable>;
+    ): Promise<GaxiosResponseWithHTTP2<Readable>>;
     list(
       params?: Params$Resource$Accounts$Merchantreviews$List,
       options?: MethodOptions
-    ): GaxiosPromise<Schema$ListMerchantReviewsResponse>;
+    ): Promise<GaxiosResponseWithHTTP2<Schema$ListMerchantReviewsResponse>>;
     list(
       params: Params$Resource$Accounts$Merchantreviews$List,
       options: StreamMethodOptions | BodyResponseCallback<Readable>,
@@ -961,8 +1182,8 @@ export namespace merchantapi_reviews_v1beta {
         | BodyResponseCallback<Readable>
     ):
       | void
-      | GaxiosPromise<Schema$ListMerchantReviewsResponse>
-      | GaxiosPromise<Readable> {
+      | Promise<GaxiosResponseWithHTTP2<Schema$ListMerchantReviewsResponse>>
+      | Promise<GaxiosResponseWithHTTP2<Readable>> {
       let params = (paramsOrCallback ||
         {}) as Params$Resource$Accounts$Merchantreviews$List;
       let options = (optionsOrCallback || {}) as MethodOptions;
@@ -1060,6 +1281,50 @@ export namespace merchantapi_reviews_v1beta {
 
     /**
      * Deletes a product review.
+     * @example
+     * ```js
+     * // Before running the sample:
+     * // - Enable the API at:
+     * //   https://console.developers.google.com/apis/api/merchantapi.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 merchantapi = google.merchantapi('reviews_v1beta');
+     *
+     * 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/content'],
+     *   });
+     *
+     *   // 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 merchantapi.accounts.productReviews.delete({
+     *     // Required. The ID of the Product review. Format: accounts/{account\}/productReviews/{productReview\}
+     *     name: 'accounts/my-account/productReviews/my-productReview',
+     *   });
+     *   console.log(res.data);
+     *
+     *   // Example response
+     *   // {}
+     * }
+     *
+     * 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`.
@@ -1069,11 +1334,11 @@ export namespace merchantapi_reviews_v1beta {
     delete(
       params: Params$Resource$Accounts$Productreviews$Delete,
       options: StreamMethodOptions
-    ): GaxiosPromise<Readable>;
+    ): Promise<GaxiosResponseWithHTTP2<Readable>>;
     delete(
       params?: Params$Resource$Accounts$Productreviews$Delete,
       options?: MethodOptions
-    ): GaxiosPromise<Schema$Empty>;
+    ): Promise<GaxiosResponseWithHTTP2<Schema$Empty>>;
     delete(
       params: Params$Resource$Accounts$Productreviews$Delete,
       options: StreamMethodOptions | BodyResponseCallback<Readable>,
@@ -1102,7 +1367,10 @@ export namespace merchantapi_reviews_v1beta {
       callback?:
         | BodyResponseCallback<Schema$Empty>
         | BodyResponseCallback<Readable>
-    ): void | GaxiosPromise<Schema$Empty> | GaxiosPromise<Readable> {
+    ):
+      | void
+      | Promise<GaxiosResponseWithHTTP2<Schema$Empty>>
+      | Promise<GaxiosResponseWithHTTP2<Readable>> {
       let params = (paramsOrCallback ||
         {}) as Params$Resource$Accounts$Productreviews$Delete;
       let options = (optionsOrCallback || {}) as MethodOptions;
@@ -1148,6 +1416,57 @@ export namespace merchantapi_reviews_v1beta {
 
     /**
      * Gets a product review.
+     * @example
+     * ```js
+     * // Before running the sample:
+     * // - Enable the API at:
+     * //   https://console.developers.google.com/apis/api/merchantapi.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 merchantapi = google.merchantapi('reviews_v1beta');
+     *
+     * 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/content'],
+     *   });
+     *
+     *   // 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 merchantapi.accounts.productReviews.get({
+     *     // Required. The ID of the merchant review. Format: accounts/{account\}/productReviews/{productReview\}
+     *     name: 'accounts/my-account/productReviews/my-productReview',
+     *   });
+     *   console.log(res.data);
+     *
+     *   // Example response
+     *   // {
+     *   //   "attributes": {},
+     *   //   "customAttributes": [],
+     *   //   "dataSource": "my_dataSource",
+     *   //   "name": "my_name",
+     *   //   "productReviewId": "my_productReviewId",
+     *   //   "productReviewStatus": {}
+     *   // }
+     * }
+     *
+     * 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`.
@@ -1157,11 +1476,11 @@ export namespace merchantapi_reviews_v1beta {
     get(
       params: Params$Resource$Accounts$Productreviews$Get,
       options: StreamMethodOptions
-    ): GaxiosPromise<Readable>;
+    ): Promise<GaxiosResponseWithHTTP2<Readable>>;
     get(
       params?: Params$Resource$Accounts$Productreviews$Get,
       options?: MethodOptions
-    ): GaxiosPromise<Schema$ProductReview>;
+    ): Promise<GaxiosResponseWithHTTP2<Schema$ProductReview>>;
     get(
       params: Params$Resource$Accounts$Productreviews$Get,
       options: StreamMethodOptions | BodyResponseCallback<Readable>,
@@ -1190,7 +1509,10 @@ export namespace merchantapi_reviews_v1beta {
       callback?:
         | BodyResponseCallback<Schema$ProductReview>
         | BodyResponseCallback<Readable>
-    ): void | GaxiosPromise<Schema$ProductReview> | GaxiosPromise<Readable> {
+    ):
+      | void
+      | Promise<GaxiosResponseWithHTTP2<Schema$ProductReview>>
+      | Promise<GaxiosResponseWithHTTP2<Readable>> {
       let params = (paramsOrCallback ||
         {}) as Params$Resource$Accounts$Productreviews$Get;
       let options = (optionsOrCallback || {}) as MethodOptions;
@@ -1236,6 +1558,72 @@ export namespace merchantapi_reviews_v1beta {
 
     /**
      * Inserts a product review.
+     * @example
+     * ```js
+     * // Before running the sample:
+     * // - Enable the API at:
+     * //   https://console.developers.google.com/apis/api/merchantapi.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 merchantapi = google.merchantapi('reviews_v1beta');
+     *
+     * 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/content'],
+     *   });
+     *
+     *   // 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 merchantapi.accounts.productReviews.insert({
+     *     // Required. Format: `accounts/{account\}/dataSources/{datasource\}`.
+     *     dataSource: 'placeholder-value',
+     *     // Required. The account where the product review will be inserted. Format: accounts/{account\}
+     *     parent: 'accounts/my-account',
+     *
+     *     // Request body metadata
+     *     requestBody: {
+     *       // request body parameters
+     *       // {
+     *       //   "attributes": {},
+     *       //   "customAttributes": [],
+     *       //   "dataSource": "my_dataSource",
+     *       //   "name": "my_name",
+     *       //   "productReviewId": "my_productReviewId",
+     *       //   "productReviewStatus": {}
+     *       // }
+     *     },
+     *   });
+     *   console.log(res.data);
+     *
+     *   // Example response
+     *   // {
+     *   //   "attributes": {},
+     *   //   "customAttributes": [],
+     *   //   "dataSource": "my_dataSource",
+     *   //   "name": "my_name",
+     *   //   "productReviewId": "my_productReviewId",
+     *   //   "productReviewStatus": {}
+     *   // }
+     * }
+     *
+     * 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`.
@@ -1245,11 +1633,11 @@ export namespace merchantapi_reviews_v1beta {
     insert(
       params: Params$Resource$Accounts$Productreviews$Insert,
       options: StreamMethodOptions
-    ): GaxiosPromise<Readable>;
+    ): Promise<GaxiosResponseWithHTTP2<Readable>>;
     insert(
       params?: Params$Resource$Accounts$Productreviews$Insert,
       options?: MethodOptions
-    ): GaxiosPromise<Schema$ProductReview>;
+    ): Promise<GaxiosResponseWithHTTP2<Schema$ProductReview>>;
     insert(
       params: Params$Resource$Accounts$Productreviews$Insert,
       options: StreamMethodOptions | BodyResponseCallback<Readable>,
@@ -1278,7 +1666,10 @@ export namespace merchantapi_reviews_v1beta {
       callback?:
         | BodyResponseCallback<Schema$ProductReview>
         | BodyResponseCallback<Readable>
-    ): void | GaxiosPromise<Schema$ProductReview> | GaxiosPromise<Readable> {
+    ):
+      | void
+      | Promise<GaxiosResponseWithHTTP2<Schema$ProductReview>>
+      | Promise<GaxiosResponseWithHTTP2<Readable>> {
       let params = (paramsOrCallback ||
         {}) as Params$Resource$Accounts$Productreviews$Insert;
       let options = (optionsOrCallback || {}) as MethodOptions;
@@ -1323,6 +1714,57 @@ export namespace merchantapi_reviews_v1beta {
 
     /**
      * Lists product reviews.
+     * @example
+     * ```js
+     * // Before running the sample:
+     * // - Enable the API at:
+     * //   https://console.developers.google.com/apis/api/merchantapi.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 merchantapi = google.merchantapi('reviews_v1beta');
+     *
+     * 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/content'],
+     *   });
+     *
+     *   // 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 merchantapi.accounts.productReviews.list({
+     *     // Optional. The maximum number of products to return. The service may return fewer than this value.
+     *     pageSize: 'placeholder-value',
+     *     // Optional. A page token, received from a previous `ListProductReviews` call. Provide this to retrieve the subsequent page. When paginating, all other parameters provided to `ListProductReviews` must match the call that provided the page token.
+     *     pageToken: 'placeholder-value',
+     *     // Required. The account to list product reviews for. Format: accounts/{account\}
+     *     parent: 'accounts/my-account',
+     *   });
+     *   console.log(res.data);
+     *
+     *   // Example response
+     *   // {
+     *   //   "nextPageToken": "my_nextPageToken",
+     *   //   "productReviews": []
+     *   // }
+     * }
+     *
+     * 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`.
@@ -1332,11 +1774,11 @@ export namespace merchantapi_reviews_v1beta {
     list(
       params: Params$Resource$Accounts$Productreviews$List,
       options: StreamMethodOptions
-    ): GaxiosPromise<Readable>;
+    ): Promise<GaxiosResponseWithHTTP2<Readable>>;
     list(
       params?: Params$Resource$Accounts$Productreviews$List,
       options?: MethodOptions
-    ): GaxiosPromise<Schema$ListProductReviewsResponse>;
+    ): Promise<GaxiosResponseWithHTTP2<Schema$ListProductReviewsResponse>>;
     list(
       params: Params$Resource$Accounts$Productreviews$List,
       options: StreamMethodOptions | BodyResponseCallback<Readable>,
@@ -1371,8 +1813,8 @@ export namespace merchantapi_reviews_v1beta {
         | BodyResponseCallback<Readable>
     ):
       | void
-      | GaxiosPromise<Schema$ListProductReviewsResponse>
-      | GaxiosPromise<Readable> {
+      | Promise<GaxiosResponseWithHTTP2<Schema$ListProductReviewsResponse>>
+      | Promise<GaxiosResponseWithHTTP2<Readable>> {
       let params = (paramsOrCallback ||
         {}) as Params$Resource$Accounts$Productreviews$List;
       let options = (optionsOrCallback || {}) as MethodOptions;