feat: Add a new destinations field

Google APIs · copybara-github · commit b2fc92c85219 · 2025-03-13T09:30:34.000-07:00
docs: A comment for field `promotion_data_source` in message `.google.shopping.merchant.datasources.v1beta.DataSource` is changed
docs: A comment for field `channel` in message `.google.shopping.merchant.datasources.v1beta.PrimaryProductDataSource` is changed

PiperOrigin-RevId: 736533159
diff --git a/google/shopping/merchant/datasources/v1beta/BUILD.bazel b/google/shopping/merchant/datasources/v1beta/BUILD.bazel
@@ -66,7 +66,10 @@ load(
 
 java_proto_library(
     name = "datasources_java_proto",
-    deps = [":datasources_proto"],
+    deps = [
+        ":datasources_proto",
+        "//google/shopping/type:type_proto",  # Added manually
+    ],
 )
 
 java_grpc_library(
@@ -178,21 +181,31 @@ load(
     "@com_google_googleapis_imports//:imports.bzl",
     "py_gapic_assembly_pkg",
     "py_gapic_library",
+    "py_import",
     "py_test",
 )
 
+py_import(
+    name = "shopping_type",
+    srcs = [
+        "//google/shopping/type:type_py_gapic",
+    ],
+)
+
 py_gapic_library(
     name = "datasources_py_gapic",
     srcs = [":datasources_proto"],
     grpc_service_config = "datasources_grpc_service_config.json",
     opt_args = [
+        "proto-plus-deps=google.shopping.type",  # Added manually
         "python-gapic-name=merchant_datasources",
         "python-gapic-namespace=google.shopping",
     ],
     rest_numeric_enums = True,
     service_yaml = "merchantapi_v1beta.yaml",
     transport = "grpc+rest",
     deps = [
+        ":shopping_type",  # Added manually
     ],
 )
 
@@ -280,6 +293,7 @@ nodejs_gapic_assembly_pkg(
     deps = [
         ":datasources_nodejs_gapic",
         ":datasources_proto",
+        "//google/shopping/type:type_proto",  # Added manually
     ],
 )
 
@@ -309,7 +323,10 @@ ruby_grpc_library(
 ruby_cloud_gapic_library(
     name = "datasources_ruby_gapic",
     srcs = [":datasources_proto_with_info"],
-    extra_protoc_parameters = ["ruby-cloud-gem-name=google-shopping-merchant-data_sources-v1beta"],
+    extra_protoc_parameters = [
+        "ruby-cloud-extra-dependencies=google-shopping-type=>0.0+<2.a",
+        "ruby-cloud-gem-name=google-shopping-merchant-data_sources-v1beta",
+    ],
     grpc_service_config = "datasources_grpc_service_config.json",
     rest_numeric_enums = True,
     service_yaml = "merchantapi_v1beta.yaml",
diff --git a/google/shopping/merchant/datasources/v1beta/datasources.proto b/google/shopping/merchant/datasources/v1beta/datasources.proto
@@ -167,9 +167,8 @@ message DataSource {
     // source.
     RegionalInventoryDataSource regional_inventory_data_source = 7;
 
-    // The
-    // [promotion](https://support.google.com/merchants/answer/2906014) data
-    // source.
+    // The [promotion](https://support.google.com/merchants/answer/2906014)
+    // data source.
     PromotionDataSource promotion_data_source = 8;
 
     // The [product
diff --git a/google/shopping/merchant/datasources/v1beta/datasourcetypes.proto b/google/shopping/merchant/datasources/v1beta/datasourcetypes.proto
@@ -17,6 +17,7 @@ syntax = "proto3";
 package google.shopping.merchant.datasources.v1beta;
 
 import "google/api/field_behavior.proto";
+import "google/shopping/type/types.proto";
 
 option csharp_namespace = "Google.Shopping.Merchant.DataSources.V1Beta";
 option go_package = "cloud.google.com/go/shopping/merchant/datasources/apiv1beta/datasourcespb;datasourcespb";
@@ -54,6 +55,29 @@ message PrimaryProductDataSource {
         [(google.api.field_behavior) = REQUIRED];
   }
 
+  // Destinations also known as [Marketing
+  // methods](https://support.google.com/merchants/answer/15130232) selections.
+  message Destination {
+    // The state of the destination.
+    enum State {
+      // Not specified.
+      STATE_UNSPECIFIED = 0;
+
+      // Indicates that the destination is enabled.
+      ENABLED = 1;
+
+      // Indicates that the destination is disabled.
+      DISABLED = 2;
+    }
+
+    // [Marketing methods](https://support.google.com/merchants/answer/15130232)
+    // (also known as destination) selections.
+    google.shopping.type.Destination.DestinationEnum destination = 1;
+
+    // The state of the destination.
+    State state = 2;
+  }
+
   // Data Source Channel.
   //
   // Channel is used to distinguish between data sources for different product
@@ -74,9 +98,9 @@ message PrimaryProductDataSource {
     PRODUCTS = 3;
   }
 
-  // Required. Immutable. Specifies the type of data source channel.
+  // Optional. Immutable. Specifies the type of data source channel.
   Channel channel = 3 [
-    (google.api.field_behavior) = REQUIRED,
+    (google.api.field_behavior) = OPTIONAL,
     (google.api.field_behavior) = IMMUTABLE
   ];
 
@@ -123,6 +147,26 @@ message PrimaryProductDataSource {
   // Optional. Default rule management of the data source. If set, the linked
   // data sources will be replaced.
   DefaultRule default_rule = 7 [(google.api.field_behavior) = OPTIONAL];
+
+  // Optional. A list of destinations describing where products of the data
+  // source can be shown.
+  //
+  // When retrieving the data source, the list contains all the destinations
+  // that can be used for the data source, including the ones that are disabled
+  // for the data source but enabled for the account.
+  //
+  // Only destinations that are enabled on the account, for example through
+  // program participation, can be enabled on the data source.
+  //
+  // If unset, during creation, the destinations will be inherited based on the
+  // account level program participation.
+  //
+  // If set, during creation or update, the data source will be set only for the
+  // specified destinations.
+  //
+  // Updating this field requires at least one destination.
+  repeated Destination destinations = 10
+      [(google.api.field_behavior) = OPTIONAL];
 }
 
 // The supplemental data source for local and online products. After creation,
diff --git a/google/shopping/merchant/datasources/v1beta/merchantapi_v1beta.yaml b/google/shopping/merchant/datasources/v1beta/merchantapi_v1beta.yaml
@@ -51,8 +51,6 @@ publishing:
       common:
         destinations:
         - PACKAGE_MANAGER
-    cpp_settings:
-      common: {}
     php_settings:
       common:
         destinations:
