feat: A new field automated_discounts is added to message google.shopping.merchant.products.v1beta.Product

Google APIs · copybara-github · commit df1d4b2fab44 · 2025-04-08T07:31:11.000-07:00
docs: Modified several comments

PiperOrigin-RevId: 745136106
diff --git a/google/shopping/merchant/products/v1beta/productinputs.proto b/google/shopping/merchant/products/v1beta/productinputs.proto
@@ -104,8 +104,7 @@ message ProductInput {
   };
 
   // Identifier. The name of the product input.
-  // Format:
-  // `"{productinput.name=accounts/{account}/productInputs/{productinput}}"`
+  // Format: 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
diff --git a/google/shopping/merchant/products/v1beta/products.proto b/google/shopping/merchant/products/v1beta/products.proto
@@ -33,7 +33,6 @@ option (google.api.resource_definition) = {
 };
 
 // Service to use Product resource.
-// This service works for products with online channel only.
 service ProductsService {
   option (google.api.default_host) = "merchantapi.googleapis.com";
   option (google.api.oauth_scopes) = "https://www.googleapis.com/auth/content";
@@ -50,8 +49,8 @@ service ProductsService {
   }
 
   // Lists the processed products in your Merchant Center account. The response
-  // might contain fewer items than specified by pageSize. Rely on pageToken to
-  // determine if there are more items to be requested.
+  // might contain fewer items than specified by `pageSize`. Rely on `pageToken`
+  // to determine if there are more items to be requested.
   //
   // After inserting, updating, or deleting a product input, it may take several
   // minutes before the updated processed product can be retrieved.
@@ -66,11 +65,11 @@ service ProductsService {
 // The processed product, built from multiple [product
 // inputs][google.shopping.merchant.products.v1main.ProductInput]
 // after applying rules and supplemental data sources. This processed product
-// matches what is shown in your Merchant Center account and in Shopping ads and
-// other surfaces across Google. Each product is built from exactly one primary
-// data source product input, and multiple supplemental data source inputs.
-// After inserting, updating, or deleting a product input, it may take
-// several minutes before the updated processed product can be retrieved.
+// matches what is shown in your Merchant Center account. Each product is built
+// from exactly one primary data source product input, and multiple supplemental
+// data source inputs. After inserting, updating, or deleting a product input,
+// it may take several minutes before the updated processed product can be
+// retrieved.
 //
 // All fields in the processed product and its sub-messages match the name of
 // their corresponding attribute in the [Product data
@@ -84,10 +83,10 @@ message Product {
 
   // The name of the product.
   // Format:
-  // `"{product.name=accounts/{account}/products/{product}}"` where the last
+  // `accounts/{account}/products/{product}` where the last
   // section `product` consists of 4 parts:
-  // channel~content_language~feed_label~offer_id
-  // example for product name is "accounts/123/products/online~en~US~sku123"
+  // `channel~content_language~feed_label~offer_id`
+  // example for product name is `accounts/123/products/online~en~US~sku123`
   string name = 1;
 
   // Output only. The
@@ -145,16 +144,20 @@ message Product {
   // Output only. The status of a product, data validation issues, that is,
   // information about a product computed asynchronously.
   ProductStatus product_status = 10 [(google.api.field_behavior) = OUTPUT_ONLY];
+
+  // Output only. The automated discounts information for the product.
+  AutomatedDiscounts automated_discounts = 12
+      [(google.api.field_behavior) = OUTPUT_ONLY];
 }
 
 // Request message for the GetProduct method.
 message GetProductRequest {
   // Required. The name of the product to retrieve.
   // Format: `accounts/{account}/products/{product}`
   // where the last section `product` consists of 4 parts:
-  // channel~content_language~feed_label~offer_id
+  // `channel~content_language~feed_label~offer_id`
   // example for product name is
-  // "accounts/123/products/online~en~US~sku123"
+  // `accounts/123/products/online~en~US~sku123`
   string name = 1 [
     (google.api.field_behavior) = REQUIRED,
     (google.api.resource_reference) = {
@@ -166,7 +169,7 @@ message GetProductRequest {
 // Request message for the ListProducts method.
 message ListProductsRequest {
   // Required. The account to list processed products for.
-  // Format: accounts/{account}
+  // Format: `accounts/{account}`
   string parent = 1 [
     (google.api.field_behavior) = REQUIRED,
     (google.api.resource_reference) = {
diff --git a/google/shopping/merchant/products/v1beta/products_common.proto b/google/shopping/merchant/products/v1beta/products_common.proto
@@ -880,3 +880,21 @@ message ProductSustainabilityIncentive {
   // Sustainability incentive program.
   optional Type type = 1;
 }
+
+// Information regarding Automated Discounts.
+message AutomatedDiscounts {
+  // The price prior to the application of the first price reduction.
+  // Absent if the information about the prior price of the product is not
+  // available.
+  google.shopping.type.Price prior_price = 1;
+
+  // The price prior to the application of consecutive price reductions.
+  // Absent if the information about the prior price of the product is not
+  // available.
+  google.shopping.type.Price prior_price_progressive = 2;
+
+  // The current sale price for products with a price optimized using Google
+  // Automated Discounts (GAD). Absent if the information about the GAD_price of
+  // the product is not available.
+  google.shopping.type.Price gad_price = 3;
+}
