@googleapis/merchantapi 3.0.0 → 4.1.0

package/inventories_v1beta.ts

@@ -255,19 +255,19 @@ export namespace merchantapi_inventories_v1beta {
    */
   export interface Schema$ProductChange {
     /**
-     * The new value of the changed resource or attribute.
+     * The new value of the changed resource or attribute. If empty, it means that the product was deleted. Will have one of these values : (`approved`, `pending`, `disapproved`, ``)
      */
     newValue?: string | null;
     /**
-     * The old value of the changed resource or attribute.
+     * The old value of the changed resource or attribute. If empty, it means that the product was created. Will have one of these values : (`approved`, `pending`, `disapproved`, ``)
      */
     oldValue?: string | null;
     /**
-     * Countries that have the change (if applicable)
+     * Countries that have the change (if applicable). Represented in the ISO 3166 format.
      */
     regionCode?: string | null;
     /**
-     * Reporting contexts that have the change (if applicable)
+     * Reporting contexts that have the change (if applicable). Currently this field supports only (`SHOPPING_ADS`, `LOCAL_INVENTORY_ADS`, `YOUTUBE_SHOPPING`, `YOUTUBE_CHECKOUT`, `YOUTUBE_AFFILIATE`) from the enum value [ReportingContextEnum](/merchant/api/reference/rest/Shared.Types/ReportingContextEnum)
      */
     reportingContext?: string | null;
   }
@@ -288,7 +288,11 @@ export namespace merchantapi_inventories_v1beta {
      */
     changes?: Schema$ProductChange[];
     /**
-     * The product expiration time. This field will not bet set if the notification is sent for a product deletion event.
+     * The time at which the event was generated. If you want to order the notification messages you receive you should rely on this field not on the order of receiving the notifications.
+     */
+    eventTime?: string | null;
+    /**
+     * Optional. The product expiration time. This field will not bet set if the notification is sent for a product deletion event.
      */
     expirationTime?: string | null;
     /**
@@ -296,7 +300,7 @@ export namespace merchantapi_inventories_v1beta {
      */
     managingAccount?: string | null;
     /**
-     * The product name. Format: `{product.name=accounts/{account\}/products/{product\}\}`
+     * The product name. Format: `accounts/{account\}/products/{product\}`
      */
     resource?: string | null;
     /**

package/lfp_v1beta.ts

@@ -322,19 +322,19 @@ export namespace merchantapi_lfp_v1beta {
    */
   export interface Schema$ProductChange {
     /**
-     * The new value of the changed resource or attribute.
+     * The new value of the changed resource or attribute. If empty, it means that the product was deleted. Will have one of these values : (`approved`, `pending`, `disapproved`, ``)
      */
     newValue?: string | null;
     /**
-     * The old value of the changed resource or attribute.
+     * The old value of the changed resource or attribute. If empty, it means that the product was created. Will have one of these values : (`approved`, `pending`, `disapproved`, ``)
      */
     oldValue?: string | null;
     /**
-     * Countries that have the change (if applicable)
+     * Countries that have the change (if applicable). Represented in the ISO 3166 format.
      */
     regionCode?: string | null;
     /**
-     * Reporting contexts that have the change (if applicable)
+     * Reporting contexts that have the change (if applicable). Currently this field supports only (`SHOPPING_ADS`, `LOCAL_INVENTORY_ADS`, `YOUTUBE_SHOPPING`, `YOUTUBE_CHECKOUT`, `YOUTUBE_AFFILIATE`) from the enum value [ReportingContextEnum](/merchant/api/reference/rest/Shared.Types/ReportingContextEnum)
      */
     reportingContext?: string | null;
   }
@@ -355,7 +355,11 @@ export namespace merchantapi_lfp_v1beta {
      */
     changes?: Schema$ProductChange[];
     /**
-     * The product expiration time. This field will not bet set if the notification is sent for a product deletion event.
+     * The time at which the event was generated. If you want to order the notification messages you receive you should rely on this field not on the order of receiving the notifications.
+     */
+    eventTime?: string | null;
+    /**
+     * Optional. The product expiration time. This field will not bet set if the notification is sent for a product deletion event.
      */
     expirationTime?: string | null;
     /**
@@ -363,7 +367,7 @@ export namespace merchantapi_lfp_v1beta {
      */
     managingAccount?: string | null;
     /**
-     * The product name. Format: `{product.name=accounts/{account\}/products/{product\}\}`
+     * The product name. Format: `accounts/{account\}/products/{product\}`
      */
     resource?: string | null;
     /**

package/notifications_v1beta.ts

@@ -171,19 +171,19 @@ export namespace merchantapi_notifications_v1beta {
    */
   export interface Schema$ProductChange {
     /**
-     * The new value of the changed resource or attribute.
+     * The new value of the changed resource or attribute. If empty, it means that the product was deleted. Will have one of these values : (`approved`, `pending`, `disapproved`, ``)
      */
     newValue?: string | null;
     /**
-     * The old value of the changed resource or attribute.
+     * The old value of the changed resource or attribute. If empty, it means that the product was created. Will have one of these values : (`approved`, `pending`, `disapproved`, ``)
      */
     oldValue?: string | null;
     /**
-     * Countries that have the change (if applicable)
+     * Countries that have the change (if applicable). Represented in the ISO 3166 format.
      */
     regionCode?: string | null;
     /**
-     * Reporting contexts that have the change (if applicable)
+     * Reporting contexts that have the change (if applicable). Currently this field supports only (`SHOPPING_ADS`, `LOCAL_INVENTORY_ADS`, `YOUTUBE_SHOPPING`, `YOUTUBE_CHECKOUT`, `YOUTUBE_AFFILIATE`) from the enum value [ReportingContextEnum](/merchant/api/reference/rest/Shared.Types/ReportingContextEnum)
      */
     reportingContext?: string | null;
   }
@@ -204,7 +204,11 @@ export namespace merchantapi_notifications_v1beta {
      */
     changes?: Schema$ProductChange[];
     /**
-     * The product expiration time. This field will not bet set if the notification is sent for a product deletion event.
+     * The time at which the event was generated. If you want to order the notification messages you receive you should rely on this field not on the order of receiving the notifications.
+     */
+    eventTime?: string | null;
+    /**
+     * Optional. The product expiration time. This field will not bet set if the notification is sent for a product deletion event.
      */
     expirationTime?: string | null;
     /**
@@ -212,7 +216,7 @@ export namespace merchantapi_notifications_v1beta {
      */
     managingAccount?: string | null;
     /**
-     * The product name. Format: `{product.name=accounts/{account\}/products/{product\}\}`
+     * The product name. Format: `accounts/{account\}/products/{product\}`
      */
     resource?: string | null;
     /**

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@googleapis/merchantapi",
-  "version": "3.0.0",
+  "version": "4.1.0",
   "description": "merchantapi",
   "main": "build/index.js",
   "types": "build/index.d.ts",

package/products_v1beta.ts

@@ -815,19 +815,19 @@ export namespace merchantapi_products_v1beta {
    */
   export interface Schema$ProductChange {
     /**
-     * The new value of the changed resource or attribute.
+     * The new value of the changed resource or attribute. If empty, it means that the product was deleted. Will have one of these values : (`approved`, `pending`, `disapproved`, ``)
      */
     newValue?: string | null;
     /**
-     * The old value of the changed resource or attribute.
+     * The old value of the changed resource or attribute. If empty, it means that the product was created. Will have one of these values : (`approved`, `pending`, `disapproved`, ``)
      */
     oldValue?: string | null;
     /**
-     * Countries that have the change (if applicable)
+     * Countries that have the change (if applicable). Represented in the ISO 3166 format.
      */
     regionCode?: string | null;
     /**
-     * Reporting contexts that have the change (if applicable)
+     * Reporting contexts that have the change (if applicable). Currently this field supports only (`SHOPPING_ADS`, `LOCAL_INVENTORY_ADS`, `YOUTUBE_SHOPPING`, `YOUTUBE_CHECKOUT`, `YOUTUBE_AFFILIATE`) from the enum value [ReportingContextEnum](/merchant/api/reference/rest/Shared.Types/ReportingContextEnum)
      */
     reportingContext?: string | null;
   }
@@ -944,7 +944,11 @@ export namespace merchantapi_products_v1beta {
      */
     changes?: Schema$ProductChange[];
     /**
-     * The product expiration time. This field will not bet set if the notification is sent for a product deletion event.
+     * The time at which the event was generated. If you want to order the notification messages you receive you should rely on this field not on the order of receiving the notifications.
+     */
+    eventTime?: string | null;
+    /**
+     * Optional. The product expiration time. This field will not bet set if the notification is sent for a product deletion event.
      */
     expirationTime?: string | null;
     /**
@@ -952,7 +956,7 @@ export namespace merchantapi_products_v1beta {
      */
     managingAccount?: string | null;
     /**
-     * The product name. Format: `{product.name=accounts/{account\}/products/{product\}\}`
+     * The product name. Format: `accounts/{account\}/products/{product\}`
      */
     resource?: string | null;
     /**
@@ -1359,6 +1363,94 @@ export namespace merchantapi_products_v1beta {
         return createAPIRequest<Schema$ProductInput>(parameters);
       }
     }
+
+    /**
+     * Updates the existing product input in your Merchant Center account. After inserting, updating, or deleting a product input, it may take several minutes before the processed product can be retrieved.
+     *
+     * @param params - Parameters for request
+     * @param options - Optionally override request options, such as `url`, `method`, and `encoding`.
+     * @param callback - Optional callback that handles the response.
+     * @returns A promise if used with async/await, or void if used with a callback.
+     */
+    patch(
+      params: Params$Resource$Accounts$Productinputs$Patch,
+      options: StreamMethodOptions
+    ): GaxiosPromise<Readable>;
+    patch(
+      params?: Params$Resource$Accounts$Productinputs$Patch,
+      options?: MethodOptions
+    ): GaxiosPromise<Schema$ProductInput>;
+    patch(
+      params: Params$Resource$Accounts$Productinputs$Patch,
+      options: StreamMethodOptions | BodyResponseCallback<Readable>,
+      callback: BodyResponseCallback<Readable>
+    ): void;
+    patch(
+      params: Params$Resource$Accounts$Productinputs$Patch,
+      options: MethodOptions | BodyResponseCallback<Schema$ProductInput>,
+      callback: BodyResponseCallback<Schema$ProductInput>
+    ): void;
+    patch(
+      params: Params$Resource$Accounts$Productinputs$Patch,
+      callback: BodyResponseCallback<Schema$ProductInput>
+    ): void;
+    patch(callback: BodyResponseCallback<Schema$ProductInput>): void;
+    patch(
+      paramsOrCallback?:
+        | Params$Resource$Accounts$Productinputs$Patch
+        | BodyResponseCallback<Schema$ProductInput>
+        | BodyResponseCallback<Readable>,
+      optionsOrCallback?:
+        | MethodOptions
+        | StreamMethodOptions
+        | BodyResponseCallback<Schema$ProductInput>
+        | BodyResponseCallback<Readable>,
+      callback?:
+        | BodyResponseCallback<Schema$ProductInput>
+        | BodyResponseCallback<Readable>
+    ): void | GaxiosPromise<Schema$ProductInput> | GaxiosPromise<Readable> {
+      let params = (paramsOrCallback ||
+        {}) as Params$Resource$Accounts$Productinputs$Patch;
+      let options = (optionsOrCallback || {}) as MethodOptions;
+
+      if (typeof paramsOrCallback === 'function') {
+        callback = paramsOrCallback;
+        params = {} as Params$Resource$Accounts$Productinputs$Patch;
+        options = {};
+      }
+
+      if (typeof optionsOrCallback === 'function') {
+        callback = optionsOrCallback;
+        options = {};
+      }
+
+      const rootUrl = options.rootUrl || 'https://merchantapi.googleapis.com/';
+      const parameters = {
+        options: Object.assign(
+          {
+            url: (rootUrl + '/products/v1beta/{+name}').replace(
+              /([^:]\/)\/+/g,
+              '$1'
+            ),
+            method: 'PATCH',
+            apiVersion: '',
+          },
+          options
+        ),
+        params,
+        requiredParams: ['name'],
+        pathParams: ['name'],
+        context: this.context,
+      };
+      if (callback) {
+        createAPIRequest<Schema$ProductInput>(
+          parameters,
+          callback as BodyResponseCallback<unknown>
+        );
+      } else {
+        return createAPIRequest<Schema$ProductInput>(parameters);
+      }
+    }
   }
 
   export interface Params$Resource$Accounts$Productinputs$Delete
@@ -1375,7 +1467,7 @@ export namespace merchantapi_products_v1beta {
   export interface Params$Resource$Accounts$Productinputs$Insert
     extends StandardParameters {
     /**
-     * Required. The primary or supplemental product data source name. If the product already exists and data source provided is different, then the product will be moved to a new data source. Format: `accounts/{account\}/dataSources/{datasource\}`.
+     * Required. The primary or supplemental product data source name. If the product already exists and data source provided is different, then the product will be moved to a new data source. Only API data sources are supported. Format: `accounts/{account\}/dataSources/{datasource\}`.
      */
     dataSource?: string;
     /**
@@ -1388,6 +1480,26 @@ export namespace merchantapi_products_v1beta {
      */
     requestBody?: Schema$ProductInput;
   }
+  export interface Params$Resource$Accounts$Productinputs$Patch
+    extends StandardParameters {
+    /**
+     * Required. The primary or supplemental product data source where `data_source` name identifies the product input to be updated. Only API data sources are supported. Format: `accounts/{account\}/dataSources/{datasource\}`.
+     */
+    dataSource?: string;
+    /**
+     * Identifier. The name of the product input. Format: `"{productinput.name=accounts/{account\}/productInputs/{productinput\}\}"` where the last section `productinput` consists of 4 parts: channel~content_language~feed_label~offer_id example for product input name is "accounts/123/productInputs/online~en~US~sku123"
+     */
+    name?: string;
+    /**
+     * Optional. The list of product attributes to be updated. If the update mask is omitted, then it is treated as implied field mask equivalent to all fields that are populated (have a non-empty value). Attributes specified in the update mask without a value specified in the body will be deleted from the product. Update mask can only be specified for top level fields in attributes and custom attributes. To specify the update mask for custom attributes you need to add the `custom_attribute.` prefix. Providing special "*" value for full product replacement is not supported.
+     */
+    updateMask?: string;
+
+    /**
+     * Request body metadata
+     */
+    requestBody?: Schema$ProductInput;
+  }
 
   export class Resource$Accounts$Products {
     context: APIRequestContext;

package/promotions_v1beta.ts

@@ -377,19 +377,19 @@ export namespace merchantapi_promotions_v1beta {
    */
   export interface Schema$ProductChange {
     /**
-     * The new value of the changed resource or attribute.
+     * The new value of the changed resource or attribute. If empty, it means that the product was deleted. Will have one of these values : (`approved`, `pending`, `disapproved`, ``)
      */
     newValue?: string | null;
     /**
-     * The old value of the changed resource or attribute.
+     * The old value of the changed resource or attribute. If empty, it means that the product was created. Will have one of these values : (`approved`, `pending`, `disapproved`, ``)
      */
     oldValue?: string | null;
     /**
-     * Countries that have the change (if applicable)
+     * Countries that have the change (if applicable). Represented in the ISO 3166 format.
      */
     regionCode?: string | null;
     /**
-     * Reporting contexts that have the change (if applicable)
+     * Reporting contexts that have the change (if applicable). Currently this field supports only (`SHOPPING_ADS`, `LOCAL_INVENTORY_ADS`, `YOUTUBE_SHOPPING`, `YOUTUBE_CHECKOUT`, `YOUTUBE_AFFILIATE`) from the enum value [ReportingContextEnum](/merchant/api/reference/rest/Shared.Types/ReportingContextEnum)
      */
     reportingContext?: string | null;
   }
@@ -410,7 +410,11 @@ export namespace merchantapi_promotions_v1beta {
      */
     changes?: Schema$ProductChange[];
     /**
-     * The product expiration time. This field will not bet set if the notification is sent for a product deletion event.
+     * The time at which the event was generated. If you want to order the notification messages you receive you should rely on this field not on the order of receiving the notifications.
+     */
+    eventTime?: string | null;
+    /**
+     * Optional. The product expiration time. This field will not bet set if the notification is sent for a product deletion event.
      */
     expirationTime?: string | null;
     /**
@@ -418,7 +422,7 @@ export namespace merchantapi_promotions_v1beta {
      */
     managingAccount?: string | null;
     /**
-     * The product name. Format: `{product.name=accounts/{account\}/products/{product\}\}`
+     * The product name. Format: `accounts/{account\}/products/{product\}`
      */
     resource?: string | null;
     /**

package/quota_v1beta.ts

@@ -163,19 +163,19 @@ export namespace merchantapi_quota_v1beta {
    */
   export interface Schema$ProductChange {
     /**
-     * The new value of the changed resource or attribute.
+     * The new value of the changed resource or attribute. If empty, it means that the product was deleted. Will have one of these values : (`approved`, `pending`, `disapproved`, ``)
      */
     newValue?: string | null;
     /**
-     * The old value of the changed resource or attribute.
+     * The old value of the changed resource or attribute. If empty, it means that the product was created. Will have one of these values : (`approved`, `pending`, `disapproved`, ``)
      */
     oldValue?: string | null;
     /**
-     * Countries that have the change (if applicable)
+     * Countries that have the change (if applicable). Represented in the ISO 3166 format.
      */
     regionCode?: string | null;
     /**
-     * Reporting contexts that have the change (if applicable)
+     * Reporting contexts that have the change (if applicable). Currently this field supports only (`SHOPPING_ADS`, `LOCAL_INVENTORY_ADS`, `YOUTUBE_SHOPPING`, `YOUTUBE_CHECKOUT`, `YOUTUBE_AFFILIATE`) from the enum value [ReportingContextEnum](/merchant/api/reference/rest/Shared.Types/ReportingContextEnum)
      */
     reportingContext?: string | null;
   }
@@ -196,7 +196,11 @@ export namespace merchantapi_quota_v1beta {
      */
     changes?: Schema$ProductChange[];
     /**
-     * The product expiration time. This field will not bet set if the notification is sent for a product deletion event.
+     * The time at which the event was generated. If you want to order the notification messages you receive you should rely on this field not on the order of receiving the notifications.
+     */
+    eventTime?: string | null;
+    /**
+     * Optional. The product expiration time. This field will not bet set if the notification is sent for a product deletion event.
      */
     expirationTime?: string | null;
     /**
@@ -204,7 +208,7 @@ export namespace merchantapi_quota_v1beta {
      */
     managingAccount?: string | null;
     /**
-     * The product name. Format: `{product.name=accounts/{account\}/products/{product\}\}`
+     * The product name. Format: `accounts/{account\}/products/{product\}`
      */
     resource?: string | null;
     /**

package/reports_v1beta.ts

@@ -651,19 +651,19 @@ export namespace merchantapi_reports_v1beta {
    */
   export interface Schema$ProductChange {
     /**
-     * The new value of the changed resource or attribute.
+     * The new value of the changed resource or attribute. If empty, it means that the product was deleted. Will have one of these values : (`approved`, `pending`, `disapproved`, ``)
      */
     newValue?: string | null;
     /**
-     * The old value of the changed resource or attribute.
+     * The old value of the changed resource or attribute. If empty, it means that the product was created. Will have one of these values : (`approved`, `pending`, `disapproved`, ``)
      */
     oldValue?: string | null;
     /**
-     * Countries that have the change (if applicable)
+     * Countries that have the change (if applicable). Represented in the ISO 3166 format.
      */
     regionCode?: string | null;
     /**
-     * Reporting contexts that have the change (if applicable)
+     * Reporting contexts that have the change (if applicable). Currently this field supports only (`SHOPPING_ADS`, `LOCAL_INVENTORY_ADS`, `YOUTUBE_SHOPPING`, `YOUTUBE_CHECKOUT`, `YOUTUBE_AFFILIATE`) from the enum value [ReportingContextEnum](/merchant/api/reference/rest/Shared.Types/ReportingContextEnum)
      */
     reportingContext?: string | null;
   }
@@ -801,7 +801,11 @@ export namespace merchantapi_reports_v1beta {
      */
     changes?: Schema$ProductChange[];
     /**
-     * The product expiration time. This field will not bet set if the notification is sent for a product deletion event.
+     * The time at which the event was generated. If you want to order the notification messages you receive you should rely on this field not on the order of receiving the notifications.
+     */
+    eventTime?: string | null;
+    /**
+     * Optional. The product expiration time. This field will not bet set if the notification is sent for a product deletion event.
      */
     expirationTime?: string | null;
     /**
@@ -809,7 +813,7 @@ export namespace merchantapi_reports_v1beta {
      */
     managingAccount?: string | null;
     /**
-     * The product name. Format: `{product.name=accounts/{account\}/products/{product\}\}`
+     * The product name. Format: `accounts/{account\}/products/{product\}`
      */
     resource?: string | null;
     /**

package/reviews_v1beta.ts

@@ -180,7 +180,7 @@ export namespace merchantapi_reviews_v1beta {
      */
     attributes?: Schema$MerchantReviewAttributes;
     /**
-     * Required. A list of custom (merchant-provided) attributes. It can also be used for submitting any attribute of the data specification in its generic form (for example, `{ "name": "size type", "value": "regular" \}`). This is useful for submitting attributes not explicitly exposed by the API, such as experimental attributes. Maximum allowed number of characters for each custom attribute is 10240 (represents sum of characters for name and value). Maximum 2500 custom attributes can be set per product, with total size of 102.4kB. Underscores in custom attribute names are replaced by spaces upon insertion.
+     * Optional. A list of custom (merchant-provided) attributes. It can also be used for submitting any attribute of the data specification in its generic form (for example, `{ "name": "size type", "value": "regular" \}`). This is useful for submitting attributes not explicitly exposed by the API, such as experimental attributes. Maximum allowed number of characters for each custom attribute is 10240 (represents sum of characters for name and value). Maximum 2500 custom attributes can be set per product, with total size of 102.4kB. Underscores in custom attribute names are replaced by spaces upon insertion.
      */
     customAttributes?: Schema$CustomAttribute[];
     /**
@@ -257,7 +257,7 @@ export namespace merchantapi_reviews_v1beta {
      */
     reviewerUsername?: string | null;
     /**
-     * Required. The language of the review defined by BCP-47 language code.
+     * Optional. The language of the review defined by BCP-47 language code.
      */
     reviewLanguage?: string | null;
     /**
@@ -341,19 +341,19 @@ export namespace merchantapi_reviews_v1beta {
    */
   export interface Schema$ProductChange {
     /**
-     * The new value of the changed resource or attribute.
+     * The new value of the changed resource or attribute. If empty, it means that the product was deleted. Will have one of these values : (`approved`, `pending`, `disapproved`, ``)
      */
     newValue?: string | null;
     /**
-     * The old value of the changed resource or attribute.
+     * The old value of the changed resource or attribute. If empty, it means that the product was created. Will have one of these values : (`approved`, `pending`, `disapproved`, ``)
      */
     oldValue?: string | null;
     /**
-     * Countries that have the change (if applicable)
+     * Countries that have the change (if applicable). Represented in the ISO 3166 format.
      */
     regionCode?: string | null;
     /**
-     * Reporting contexts that have the change (if applicable)
+     * Reporting contexts that have the change (if applicable). Currently this field supports only (`SHOPPING_ADS`, `LOCAL_INVENTORY_ADS`, `YOUTUBE_SHOPPING`, `YOUTUBE_CHECKOUT`, `YOUTUBE_AFFILIATE`) from the enum value [ReportingContextEnum](/merchant/api/reference/rest/Shared.Types/ReportingContextEnum)
      */
     reportingContext?: string | null;
   }
@@ -591,7 +591,11 @@ export namespace merchantapi_reviews_v1beta {
      */
     changes?: Schema$ProductChange[];
     /**
-     * The product expiration time. This field will not bet set if the notification is sent for a product deletion event.
+     * The time at which the event was generated. If you want to order the notification messages you receive you should rely on this field not on the order of receiving the notifications.
+     */
+    eventTime?: string | null;
+    /**
+     * Optional. The product expiration time. This field will not bet set if the notification is sent for a product deletion event.
      */
     expirationTime?: string | null;
     /**
@@ -599,7 +603,7 @@ export namespace merchantapi_reviews_v1beta {
      */
     managingAccount?: string | null;
     /**
-     * The product name. Format: `{product.name=accounts/{account\}/products/{product\}\}`
+     * The product name. Format: `accounts/{account\}/products/{product\}`
      */
     resource?: string | null;
     /**