feat(retail): update the api

#### retail:v2 The following keys were added: - schemas.GoogleCloudRetailV2Model.properties.modelFeaturesConfig.$ref (Total Keys: 1) - schemas.GoogleCloudRetailV2ModelFrequentlyBoughtTogetherFeaturesConfig (Total Keys: 3) - schemas.GoogleCloudRetailV2ModelModelFeaturesConfig (Total Keys: 3) - schemas.GoogleCloudRetailV2alphaMerchantCenterAccountLink.properties.source.type (Total Keys: 1) - schemas.GoogleCloudRetailV2alphaModel.properties.modelFeaturesConfig.$ref (Total Keys: 1) - schemas.GoogleCloudRetailV2alphaModelFrequentlyBoughtTogetherFeaturesConfig (Total Keys: 3) - schemas.GoogleCloudRetailV2alphaModelModelFeaturesConfig (Total Keys: 3) - schemas.GoogleCloudRetailV2betaMerchantCenterAccountLink.properties.source.type (Total Keys: 1) - schemas.GoogleCloudRetailV2betaModel.properties.modelFeaturesConfig.$ref (Total Keys: 1) - schemas.GoogleCloudRetailV2betaModelFrequentlyBoughtTogetherFeaturesConfig (Total Keys: 3) - schemas.GoogleCloudRetailV2betaModelModelFeaturesConfig (Total Keys: 3) #### retail:v2alpha The following keys were deleted: - resources.projects.resources.locations.resources.catalogs.resources.merchantCenterAccountLinks.methods.create (Total Keys: 14) The following keys were added: - resources.projects.resources.locations.resources.catalogs.resources.merchantCenterAccountLinks.methods.create (Total Keys: 12) - schemas.GoogleCloudRetailV2Model.properties.modelFeaturesConfig.$ref (Total Keys: 1) - schemas.GoogleCloudRetailV2ModelFrequentlyBoughtTogetherFeaturesConfig (Total Keys: 3) - schemas.GoogleCloudRetailV2ModelModelFeaturesConfig (Total Keys: 3) - schemas.GoogleCloudRetailV2alphaMerchantCenterAccountLink.properties.source.type (Total Keys: 1) - schemas.GoogleCloudRetailV2alphaModel.properties.modelFeaturesConfig.$ref (Total Keys: 1) - schemas.GoogleCloudRetailV2alphaModelFrequentlyBoughtTogetherFeaturesConfig (Total Keys: 3) - schemas.GoogleCloudRetailV2alphaModelModelFeaturesConfig (Total Keys: 3) - schemas.GoogleCloudRetailV2betaMerchantCenterAccountLink.properties.source.type (Total Keys: 1) - schemas.GoogleCloudRetailV2betaModel.properties.modelFeaturesConfig.$ref (Total Keys: 1) - schemas.GoogleCloudRetailV2betaModelFrequentlyBoughtTogetherFeaturesConfig (Total Keys: 3) - schemas.GoogleCloudRetailV2betaModelModelFeaturesConfig (Total Keys: 3) #### retail:v2beta The following keys were added: - schemas.GoogleCloudRetailV2Model.properties.modelFeaturesConfig.$ref (Total Keys: 1) - schemas.GoogleCloudRetailV2ModelFrequentlyBoughtTogetherFeaturesConfig (Total Keys: 3) - schemas.GoogleCloudRetailV2ModelModelFeaturesConfig (Total Keys: 3) - schemas.GoogleCloudRetailV2alphaMerchantCenterAccountLink.properties.source.type (Total Keys: 1) - schemas.GoogleCloudRetailV2alphaModel.properties.modelFeaturesConfig.$ref (Total Keys: 1) - schemas.GoogleCloudRetailV2alphaModelFrequentlyBoughtTogetherFeaturesConfig (Total Keys: 3) - schemas.GoogleCloudRetailV2alphaModelModelFeaturesConfig (Total Keys: 3) - schemas.GoogleCloudRetailV2betaMerchantCenterAccountLink.properties.source.type (Total Keys: 1) - schemas.GoogleCloudRetailV2betaModel.properties.modelFeaturesConfig.$ref (Total Keys: 1) - schemas.GoogleCloudRetailV2betaModelFrequentlyBoughtTogetherFeaturesConfig (Total Keys: 3) - schemas.GoogleCloudRetailV2betaModelModelFeaturesConfig (Total Keys: 3)
googleapis · May 24, 2023 · c0133e0 · c0133e0
1 parent 15897ed
commit c0133e0
Show file tree

Hide file tree

Showing 28 changed files with 848 additions and 399 deletions.
diff --git a/docs/dyn/retail_v2.projects.locations.catalogs.attributesConfig.html b/docs/dyn/retail_v2.projects.locations.catalogs.attributesConfig.html
diff --git a/docs/dyn/retail_v2.projects.locations.catalogs.branches.products.html b/docs/dyn/retail_v2.projects.locations.catalogs.branches.products.html
@@ -76,7 +76,7 @@ <h1><a href="retail_v2.html">Retail API</a> . <a href="retail_v2.projects.html">
 <h2>Instance Methods</h2>
 <p class="toc_element">
   <code><a href="#addFulfillmentPlaces">addFulfillmentPlaces(product, body=None, x__xgafv=None)</a></code></p>
-<p class="firstline">It is recommended to use the ProductService.AddLocalInventories method instead of ProductService.AddFulfillmentPlaces. ProductService.AddLocalInventories achieves the same results but provides more fine-grained control over ingesting local inventory data. Incrementally adds place IDs to Product.fulfillment_info.place_ids. This process is asynchronous and does not require the Product to exist before updating fulfillment information. If the request is valid, the update will be enqueued and processed downstream. As a consequence, when a response is returned, the added place IDs are not immediately manifested in the Product queried by ProductService.GetProduct or ProductService.ListProducts. The returned Operations will be obsolete after 1 day, and GetOperation API will return NOT_FOUND afterwards. If conflicting updates are issued, the Operations associated with the stale updates will not be marked as done until being obsolete.</p>
+<p class="firstline">We recommend that you use the ProductService.AddLocalInventories method instead of the ProductService.AddFulfillmentPlaces method. ProductService.AddLocalInventories achieves the same results but provides more fine-grained control over ingesting local inventory data. Incrementally adds place IDs to Product.fulfillment_info.place_ids. This process is asynchronous and does not require the Product to exist before updating fulfillment information. If the request is valid, the update will be enqueued and processed downstream. As a consequence, when a response is returned, the added place IDs are not immediately manifested in the Product queried by ProductService.GetProduct or ProductService.ListProducts. The returned Operations will be obsolete after 1 day, and GetOperation API will return NOT_FOUND afterwards. If conflicting updates are issued, the Operations associated with the stale updates will not be marked as done until being obsolete.</p>
 <p class="toc_element">
   <code><a href="#addLocalInventories">addLocalInventories(product, body=None, x__xgafv=None)</a></code></p>
 <p class="firstline">Updates local inventory information for a Product at a list of places, while respecting the last update timestamps of each inventory field. This process is asynchronous and does not require the Product to exist before updating inventory information. If the request is valid, the update will be enqueued and processed downstream. As a consequence, when a response is returned, updates are not immediately manifested in the Product queried by ProductService.GetProduct or ProductService.ListProducts. Local inventory information can only be modified using this method. ProductService.CreateProduct and ProductService.UpdateProduct has no effect on local inventories. The returned Operations will be obsolete after 1 day, and GetOperation API will return NOT_FOUND afterwards. If conflicting updates are issued, the Operations associated with the stale updates will not be marked as done until being obsolete.</p>
@@ -106,7 +106,7 @@ <h2>Instance Methods</h2>
 <p class="firstline">Updates a Product.</p>
 <p class="toc_element">
   <code><a href="#removeFulfillmentPlaces">removeFulfillmentPlaces(product, body=None, x__xgafv=None)</a></code></p>
-<p class="firstline">It is recommended to use the ProductService.RemoveLocalInventories method instead of ProductService.RemoveFulfillmentPlaces. ProductService.RemoveLocalInventories achieves the same results but provides more fine-grained control over ingesting local inventory data. Incrementally removes place IDs from a Product.fulfillment_info.place_ids. This process is asynchronous and does not require the Product to exist before updating fulfillment information. If the request is valid, the update will be enqueued and processed downstream. As a consequence, when a response is returned, the removed place IDs are not immediately manifested in the Product queried by ProductService.GetProduct or ProductService.ListProducts. The returned Operations will be obsolete after 1 day, and GetOperation API will return NOT_FOUND afterwards. If conflicting updates are issued, the Operations associated with the stale updates will not be marked as done until being obsolete.</p>
+<p class="firstline">We recommend that you use the ProductService.RemoveLocalInventories method instead of the ProductService.RemoveFulfillmentPlaces method. ProductService.RemoveLocalInventories achieves the same results but provides more fine-grained control over ingesting local inventory data. Incrementally removes place IDs from a Product.fulfillment_info.place_ids. This process is asynchronous and does not require the Product to exist before updating fulfillment information. If the request is valid, the update will be enqueued and processed downstream. As a consequence, when a response is returned, the removed place IDs are not immediately manifested in the Product queried by ProductService.GetProduct or ProductService.ListProducts. The returned Operations will be obsolete after 1 day, and GetOperation API will return NOT_FOUND afterwards. If conflicting updates are issued, the Operations associated with the stale updates will not be marked as done until being obsolete.</p>
 <p class="toc_element">
   <code><a href="#removeLocalInventories">removeLocalInventories(product, body=None, x__xgafv=None)</a></code></p>
 <p class="firstline">Remove local inventory information for a Product at a list of places at a removal timestamp. This process is asynchronous. If the request is valid, the removal will be enqueued and processed downstream. As a consequence, when a response is returned, removals are not immediately manifested in the Product queried by ProductService.GetProduct or ProductService.ListProducts. Local inventory information can only be removed using this method. ProductService.CreateProduct and ProductService.UpdateProduct has no effect on local inventories. The returned Operations will be obsolete after 1 day, and GetOperation API will return NOT_FOUND afterwards. If conflicting updates are issued, the Operations associated with the stale updates will not be marked as done until being obsolete.</p>
@@ -116,7 +116,7 @@ <h2>Instance Methods</h2>
 <h3>Method Details</h3>
 <div class="method">
     <code class="details" id="addFulfillmentPlaces">addFulfillmentPlaces(product, body=None, x__xgafv=None)</code>
-  <pre>It is recommended to use the ProductService.AddLocalInventories method instead of ProductService.AddFulfillmentPlaces. ProductService.AddLocalInventories achieves the same results but provides more fine-grained control over ingesting local inventory data. Incrementally adds place IDs to Product.fulfillment_info.place_ids. This process is asynchronous and does not require the Product to exist before updating fulfillment information. If the request is valid, the update will be enqueued and processed downstream. As a consequence, when a response is returned, the added place IDs are not immediately manifested in the Product queried by ProductService.GetProduct or ProductService.ListProducts. The returned Operations will be obsolete after 1 day, and GetOperation API will return NOT_FOUND afterwards. If conflicting updates are issued, the Operations associated with the stale updates will not be marked as done until being obsolete.
+  <pre>We recommend that you use the ProductService.AddLocalInventories method instead of the ProductService.AddFulfillmentPlaces method. ProductService.AddLocalInventories achieves the same results but provides more fine-grained control over ingesting local inventory data. Incrementally adds place IDs to Product.fulfillment_info.place_ids. This process is asynchronous and does not require the Product to exist before updating fulfillment information. If the request is valid, the update will be enqueued and processed downstream. As a consequence, when a response is returned, the added place IDs are not immediately manifested in the Product queried by ProductService.GetProduct or ProductService.ListProducts. The returned Operations will be obsolete after 1 day, and GetOperation API will return NOT_FOUND afterwards. If conflicting updates are issued, the Operations associated with the stale updates will not be marked as done until being obsolete.
 
 Args:
   product: string, Required. Full resource name of Product, such as `projects/*/locations/global/catalogs/default_catalog/branches/default_branch/products/some_product_id`. If the caller does not have permission to access the Product, regardless of whether or not it exists, a PERMISSION_DENIED error is returned. (required)
@@ -1000,7 +1000,7 @@ <h3>Method Details</h3>
       ],
     },
   },
-  &quot;notificationPubsubTopic&quot;: &quot;A String&quot;, # Full Pub/Sub topic name for receiving notification. If this field is set, when the import is finished, a notification is sent to specified Pub/Sub topic. The message data is JSON string of a Operation. Format of the Pub/Sub topic is `projects/{project}/topics/{topic}`. It has to be within the same project as ImportProductsRequest.parent. Make sure that `service-@gcp-sa-retail.iam.gserviceaccount.com` has the `pubsub.topics.publish` IAM permission on the topic.
+  &quot;notificationPubsubTopic&quot;: &quot;A String&quot;, # Full Pub/Sub topic name for receiving notification. If this field is set, when the import is finished, a notification is sent to specified Pub/Sub topic. The message data is JSON string of a Operation. Format of the Pub/Sub topic is `projects/{project}/topics/{topic}`. It has to be within the same project as ImportProductsRequest.parent. Make sure that both `cloud-retail-customer-data-access@system.gserviceaccount.com` and `service-@gcp-sa-retail.iam.gserviceaccount.com` have the `pubsub.topics.publish` IAM permission on the topic. Only supported when ImportProductsRequest.reconciliation_mode is set to `FULL`.
   &quot;reconciliationMode&quot;: &quot;A String&quot;, # The mode of reconciliation between existing products and the products to be imported. Defaults to ReconciliationMode.INCREMENTAL.
   &quot;requestId&quot;: &quot;A String&quot;, # Deprecated. This field has no effect.
   &quot;updateMask&quot;: &quot;A String&quot;, # Indicates which fields in the provided imported `products` to update. If not set, all fields are updated.
@@ -1590,7 +1590,7 @@ <h3>Method Details</h3>
 
 <div class="method">
     <code class="details" id="removeFulfillmentPlaces">removeFulfillmentPlaces(product, body=None, x__xgafv=None)</code>
-  <pre>It is recommended to use the ProductService.RemoveLocalInventories method instead of ProductService.RemoveFulfillmentPlaces. ProductService.RemoveLocalInventories achieves the same results but provides more fine-grained control over ingesting local inventory data. Incrementally removes place IDs from a Product.fulfillment_info.place_ids. This process is asynchronous and does not require the Product to exist before updating fulfillment information. If the request is valid, the update will be enqueued and processed downstream. As a consequence, when a response is returned, the removed place IDs are not immediately manifested in the Product queried by ProductService.GetProduct or ProductService.ListProducts. The returned Operations will be obsolete after 1 day, and GetOperation API will return NOT_FOUND afterwards. If conflicting updates are issued, the Operations associated with the stale updates will not be marked as done until being obsolete.
+  <pre>We recommend that you use the ProductService.RemoveLocalInventories method instead of the ProductService.RemoveFulfillmentPlaces method. ProductService.RemoveLocalInventories achieves the same results but provides more fine-grained control over ingesting local inventory data. Incrementally removes place IDs from a Product.fulfillment_info.place_ids. This process is asynchronous and does not require the Product to exist before updating fulfillment information. If the request is valid, the update will be enqueued and processed downstream. As a consequence, when a response is returned, the removed place IDs are not immediately manifested in the Product queried by ProductService.GetProduct or ProductService.ListProducts. The returned Operations will be obsolete after 1 day, and GetOperation API will return NOT_FOUND afterwards. If conflicting updates are issued, the Operations associated with the stale updates will not be marked as done until being obsolete.
 
 Args:
   product: string, Required. Full resource name of Product, such as `projects/*/locations/global/catalogs/default_catalog/branches/default_branch/products/some_product_id`. If the caller does not have permission to access the Product, regardless of whether or not it exists, a PERMISSION_DENIED error is returned. (required)