@google-ads/admanager 0.1.0

package/build/protos/google/ads/admanager/v1/custom_field_value.proto

@@ -0,0 +1,62 @@
+// Copyright 2024 Google LLC
+//
+// Licensed under the Apache License, Version 2.0 (the "License");
+// you may not use this file except in compliance with the License.
+// You may obtain a copy of the License at
+//
+//     http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+
+syntax = "proto3";
+
+package google.ads.admanager.v1;
+
+import "google/api/field_behavior.proto";
+import "google/api/resource.proto";
+
+option csharp_namespace = "Google.Ads.AdManager.V1";
+option go_package = "google.golang.org/genproto/googleapis/ads/admanager/v1;admanager";
+option java_multiple_files = true;
+option java_outer_classname = "CustomFieldValueProto";
+option java_package = "com.google.ads.admanager.v1";
+option php_namespace = "Google\\Ads\\AdManager\\V1";
+option ruby_package = "Google::Ads::AdManager::V1";
+
+// A value for a CustomField on a resource.
+message CustomFieldValue {
+  // Represent custom field value type.
+  // Next Id: 5
+  message Value {
+    // The value of this field.
+    oneof value {
+      // The custom_field_option_id, if the CustomFieldDataType is DROPDOWN.
+      int64 dropdown_value = 1;
+
+      // The value, if the CustomFieldDataType is STRING.
+      string string_value = 2;
+
+      // The value, if the CustomFieldDataType is NUMBER.
+      double number_value = 3;
+
+      // The value, if the CustomFieldDataType is TOGGLE.
+      bool toggle_value = 4;
+    }
+  }
+
+  // Required. The custom field for which this is a value.
+  // Format: "networks/{network_code}/customFields/{custom_field_id}"
+  string custom_field = 1 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = {
+      type: "admanager.googleapis.com/CustomField"
+    }
+  ];
+
+  // Required. A typed value representation of the value.
+  optional Value value = 2 [(google.api.field_behavior) = REQUIRED];
+}

package/build/protos/google/ads/admanager/v1/custom_targeting_key_enums.proto

@@ -0,0 +1,76 @@
+// Copyright 2024 Google LLC
+//
+// Licensed under the Apache License, Version 2.0 (the "License");
+// you may not use this file except in compliance with the License.
+// You may obtain a copy of the License at
+//
+//     http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+
+syntax = "proto3";
+
+package google.ads.admanager.v1;
+
+option csharp_namespace = "Google.Ads.AdManager.V1";
+option go_package = "google.golang.org/genproto/googleapis/ads/admanager/v1;admanager";
+option java_multiple_files = true;
+option java_outer_classname = "CustomTargetingKeyEnumsProto";
+option java_package = "com.google.ads.admanager.v1";
+option php_namespace = "Google\\Ads\\AdManager\\V1";
+option ruby_package = "Google::Ads::AdManager::V1";
+
+// Wrapper message for
+// [CustomTargetingKeyStatus][google.ads.admanager.v1.CustomTargetingKeyStatusEnum.CustomTargetingKeyStatus]
+message CustomTargetingKeyStatusEnum {
+  // Status of the custom targeting key.
+  enum CustomTargetingKeyStatus {
+    // Not specified value.
+    CUSTOM_TARGETING_KEY_STATUS_UNSPECIFIED = 0;
+
+    // Custom targeting key is active.
+    ACTIVE = 1;
+
+    // Custom targeting key is inactive.
+    INACTIVE = 2;
+  }
+}
+
+// Wrapper message for
+// [CustomTargetingKeyType][google.ads.admanager.v1.CustomTargetingKeyTypeEnum.CustomTargetingKeyType]
+message CustomTargetingKeyTypeEnum {
+  // Type of the custom targeting key.
+  enum CustomTargetingKeyType {
+    // Not specified value.
+    CUSTOM_TARGETING_KEY_TYPE_UNSPECIFIED = 0;
+
+    // Key with a fixed set of values.
+    PREDEFINED = 1;
+
+    // Key without a fixed set of values
+    FREEFORM = 2;
+  }
+}
+
+// Wrapper message for
+// [CustomTargetingKeyReportableType][google.ads.admanager.v1.CustomTargetingKeyReportableTypeEnum.CustomTargetingKeyReportableType]
+message CustomTargetingKeyReportableTypeEnum {
+  // Reportable type of the custom targeting key.
+  enum CustomTargetingKeyReportableType {
+    // Not specified value.
+    CUSTOM_TARGETING_KEY_REPORTABLE_TYPE_UNSPECIFIED = 0;
+
+    // Not available for reporting in the Ad Manager query tool.
+    OFF = 1;
+
+    // Available for reporting in the Ad Manager query tool.
+    ON = 2;
+
+    // Custom dimension available for reporting in the AdManager query tool.
+    CUSTOM_DIMENSION = 3;
+  }
+}

package/build/protos/google/ads/admanager/v1/custom_targeting_key_messages.proto

@@ -0,0 +1,69 @@
+// Copyright 2024 Google LLC
+//
+// Licensed under the Apache License, Version 2.0 (the "License");
+// you may not use this file except in compliance with the License.
+// You may obtain a copy of the License at
+//
+//     http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+
+syntax = "proto3";
+
+package google.ads.admanager.v1;
+
+import "google/ads/admanager/v1/custom_targeting_key_enums.proto";
+import "google/api/field_behavior.proto";
+import "google/api/resource.proto";
+
+option csharp_namespace = "Google.Ads.AdManager.V1";
+option go_package = "google.golang.org/genproto/googleapis/ads/admanager/v1;admanager";
+option java_multiple_files = true;
+option java_outer_classname = "CustomTargetingKeyMessagesProto";
+option java_package = "com.google.ads.admanager.v1";
+option php_namespace = "Google\\Ads\\AdManager\\V1";
+option ruby_package = "Google::Ads::AdManager::V1";
+
+// The `CustomTargetingKey` resource.
+message CustomTargetingKey {
+  option (google.api.resource) = {
+    type: "admanager.googleapis.com/CustomTargetingKey"
+    pattern: "networks/{network_code}/customTargetingKeys/{custom_targeting_key}"
+    plural: "customTargetingKeys"
+    singular: "customTargetingKey"
+  };
+
+  // Identifier. The resource name of the `CustomTargetingKey`.
+  // Format:
+  // `networks/{network_code}/customTargetingKeys/{custom_targeting_key_id}`
+  string name = 1 [(google.api.field_behavior) = IDENTIFIER];
+
+  // Output only. `CustomTargetingKey` ID.
+  int64 custom_targeting_key_id = 2 [(google.api.field_behavior) = OUTPUT_ONLY];
+
+  // Immutable. Name of the key. Keys can contain up to 10 characters each. You
+  // can use alphanumeric characters and symbols other than the following:
+  // ", ', =, !, +, #, *, ~, ;, ^, (, ), <, >, [, ], the white space character.
+  string ad_tag_name = 3 [(google.api.field_behavior) = IMMUTABLE];
+
+  // Optional. Descriptive name for the `CustomTargetingKey`.
+  string display_name = 4 [(google.api.field_behavior) = OPTIONAL];
+
+  // Required. Indicates whether users will select from predefined values or
+  // create new targeting values, while specifying targeting criteria for a line
+  // item.
+  CustomTargetingKeyTypeEnum.CustomTargetingKeyType type = 5
+      [(google.api.field_behavior) = REQUIRED];
+
+  // Output only. Status of the `CustomTargetingKey`.
+  CustomTargetingKeyStatusEnum.CustomTargetingKeyStatus status = 6
+      [(google.api.field_behavior) = OUTPUT_ONLY];
+
+  // Required. Reportable state of the `CustomTargetingKey`.
+  CustomTargetingKeyReportableTypeEnum.CustomTargetingKeyReportableType
+      reportable_type = 7 [(google.api.field_behavior) = REQUIRED];
+}

package/build/protos/google/ads/admanager/v1/custom_targeting_key_service.proto

@@ -0,0 +1,129 @@
+// Copyright 2024 Google LLC
+//
+// Licensed under the Apache License, Version 2.0 (the "License");
+// you may not use this file except in compliance with the License.
+// You may obtain a copy of the License at
+//
+//     http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+
+syntax = "proto3";
+
+package google.ads.admanager.v1;
+
+import "google/ads/admanager/v1/custom_targeting_key_messages.proto";
+import "google/api/annotations.proto";
+import "google/api/client.proto";
+import "google/api/field_behavior.proto";
+import "google/api/resource.proto";
+
+option csharp_namespace = "Google.Ads.AdManager.V1";
+option go_package = "google.golang.org/genproto/googleapis/ads/admanager/v1;admanager";
+option java_multiple_files = true;
+option java_outer_classname = "CustomTargetingKeyServiceProto";
+option java_package = "com.google.ads.admanager.v1";
+option php_namespace = "Google\\Ads\\AdManager\\V1";
+option ruby_package = "Google::Ads::AdManager::V1";
+
+// Provides methods for handling `CustomTargetingKey` objects.
+service CustomTargetingKeyService {
+  option (google.api.default_host) = "admanager.googleapis.com";
+
+  // API to retrieve a `CustomTargetingKey` object.
+  rpc GetCustomTargetingKey(GetCustomTargetingKeyRequest)
+      returns (CustomTargetingKey) {
+    option (google.api.http) = {
+      get: "/v1/{name=networks/*/customTargetingKeys/*}"
+    };
+    option (google.api.method_signature) = "name";
+  }
+
+  // API to retrieve a list of `CustomTargetingKey` objects.
+  rpc ListCustomTargetingKeys(ListCustomTargetingKeysRequest)
+      returns (ListCustomTargetingKeysResponse) {
+    option (google.api.http) = {
+      get: "/v1/{parent=networks/*}/customTargetingKeys"
+    };
+    option (google.api.method_signature) = "parent";
+  }
+}
+
+// Request object for `GetCustomTargetingKey` method.
+message GetCustomTargetingKeyRequest {
+  // Required. The resource name of the CustomTargetingKey.
+  // Format:
+  // `networks/{network_code}/customTargetingKeys/{custom_targeting_key_id}`
+  string name = 1 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = {
+      type: "admanager.googleapis.com/CustomTargetingKey"
+    }
+  ];
+}
+
+// Request object for `ListCustomTargetingKeys` method.
+message ListCustomTargetingKeysRequest {
+  // Required. The parent, which owns this collection of CustomTargetingKeys.
+  // Format: `networks/{network_code}`
+  string parent = 1 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = {
+      type: "admanager.googleapis.com/Network"
+    }
+  ];
+
+  // Optional. The maximum number of `CustomTargetingKeys` to return. The
+  // service may return fewer than this value. If unspecified, at most 50
+  // `CustomTargetingKeys` will be returned. The maximum value is 1000; values
+  // above 1000 will be coerced to 1000.
+  int32 page_size = 2 [(google.api.field_behavior) = OPTIONAL];
+
+  // Optional. A page token, received from a previous `ListCustomTargetingKeys`
+  // call. Provide this to retrieve the subsequent page.
+  //
+  // When paginating, all other parameters provided to `ListCustomTargetingKeys`
+  // must match the call that provided the page token.
+  string page_token = 3 [(google.api.field_behavior) = OPTIONAL];
+
+  // Optional. Expression to filter the response.
+  // See syntax details at
+  // https://developers.google.com/ad-manager/api/beta/filters
+  string filter = 4 [(google.api.field_behavior) = OPTIONAL];
+
+  // Optional. Expression to specify sorting order.
+  // See syntax details at
+  // https://developers.google.com/ad-manager/api/beta/filters#order
+  string order_by = 5 [(google.api.field_behavior) = OPTIONAL];
+
+  // Optional. Number of individual resources to skip while paginating.
+  int32 skip = 6 [(google.api.field_behavior) = OPTIONAL];
+}
+
+// Response object for `ListCustomTargetingKeysRequest` containing matching
+// `CustomTargetingKey` objects.
+message ListCustomTargetingKeysResponse {
+  // The `CustomTargetingKey` objects from the specified network.
+  repeated CustomTargetingKey custom_targeting_keys = 1;
+
+  // A token, which can be sent as `page_token` to retrieve the next page.
+  // If this field is omitted, there are no subsequent pages.
+  string next_page_token = 2;
+
+  // Total number of `CustomTargetingKey` objects.
+  // If a filter was included in the request, this reflects the total number
+  // after the filtering is applied.
+  //
+  // `total_size` will not be calculated in the response unless it has been
+  // included in a response field mask. The response field mask can be provided
+  // to the method by using the URL parameter `$fields` or `fields`, or by using
+  // the HTTP/gRPC header `X-Goog-FieldMask`.
+  //
+  // For more information, see
+  // https://developers.google.com/ad-manager/api/beta/field-masks
+  int32 total_size = 3;
+}

package/build/protos/google/ads/admanager/v1/custom_targeting_value_enums.proto

@@ -0,0 +1,90 @@
+// Copyright 2024 Google LLC
+//
+// Licensed under the Apache License, Version 2.0 (the "License");
+// you may not use this file except in compliance with the License.
+// You may obtain a copy of the License at
+//
+//     http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+
+syntax = "proto3";
+
+package google.ads.admanager.v1;
+
+option csharp_namespace = "Google.Ads.AdManager.V1";
+option go_package = "google.golang.org/genproto/googleapis/ads/admanager/v1;admanager";
+option java_multiple_files = true;
+option java_outer_classname = "CustomTargetingValueEnumsProto";
+option java_package = "com.google.ads.admanager.v1";
+option php_namespace = "Google\\Ads\\AdManager\\V1";
+option ruby_package = "Google::Ads::AdManager::V1";
+
+// Wrapper message for
+// [CustomTargetingValueStatus][google.ads.admanager.v1.CustomTargetingValueStatusEnum.CustomTargetingValueStatus]
+message CustomTargetingValueStatusEnum {
+  // Status of the custom targeting value.
+  enum CustomTargetingValueStatus {
+    // Not specified value.
+    CUSTOM_TARGETING_VALUE_STATUS_UNSPECIFIED = 0;
+
+    // Custom targeting value is active.
+    ACTIVE = 1;
+
+    // Custom targeting value is inactive.
+    INACTIVE = 2;
+  }
+}
+
+// Wrapper message for
+// [CustomTargetingValueMatchType][google.ads.admanager.v1.CustomTargetingValueMatchTypeEnum.CustomTargetingValueMatchType]
+message CustomTargetingValueMatchTypeEnum {
+  // Match type of the custom targeting value.
+  enum CustomTargetingValueMatchType {
+    // Not specified value.
+    CUSTOM_TARGETING_VALUE_MATCH_TYPE_UNSPECIFIED = 0;
+
+    // Used for exact matching. For example, the targeting value car=honda will
+    // only match to the ad request car=honda.
+    EXACT = 1;
+
+    // Used for lenient matching when at least one of the words in the ad
+    // request matches the targeted value. The targeting value car=honda will
+    // match to ad requests containing the word honda. So ad requests car=honda
+    // or car=honda civic or car=buy honda or car=how much does a honda cost
+    // will all have the line item delivered.
+    // This match type can not be used within an audience segment rule.
+    BROAD = 2;
+
+    // Used for 'starts with' matching when the first few characters in the ad
+    // request match all of the characters in the targeted value. The targeting
+    // value car=honda will match to ad requests car=honda or car=hondas for
+    // sale but not to car=I want a honda.
+    PREFIX = 3;
+
+    // This is a combination of MatchType#BROAD and MatchType#PREFIX matching.
+    // The targeting value car=honda will match to ad requests that contain
+    // words that start with the characters in the targeted value, for example
+    // with car=civic hondas.
+    // This match type can not be used within an audience segment rule.
+    BROAD_PREFIX = 4;
+
+    // Used for 'ends with' matching when the last characters in the ad request
+    // match all of the characters in the targeted value. The targeting value
+    // car=honda will match with ad requests car=honda or car=I want a honda but
+    // not to car=hondas for sale.
+    // This match type can not be used within line item targeting.
+    SUFFIX = 5;
+
+    // Used for 'within' matching when the string in the ad request contains the
+    // string in the targeted value. The targeting value car=honda will match
+    // with ad requests car=honda, car=I want a honda, and also with car=hondas
+    // for sale, but not with car=misspelled hond a. This match type can not be
+    // used within line item targeting.
+    CONTAINS = 6;
+  }
+}

package/build/protos/google/ads/admanager/v1/custom_targeting_value_messages.proto

@@ -0,0 +1,66 @@
+// Copyright 2024 Google LLC
+//
+// Licensed under the Apache License, Version 2.0 (the "License");
+// you may not use this file except in compliance with the License.
+// You may obtain a copy of the License at
+//
+//     http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+
+syntax = "proto3";
+
+package google.ads.admanager.v1;
+
+import "google/ads/admanager/v1/custom_targeting_value_enums.proto";
+import "google/api/field_behavior.proto";
+import "google/api/resource.proto";
+
+option csharp_namespace = "Google.Ads.AdManager.V1";
+option go_package = "google.golang.org/genproto/googleapis/ads/admanager/v1;admanager";
+option java_multiple_files = true;
+option java_outer_classname = "CustomTargetingValueMessagesProto";
+option java_package = "com.google.ads.admanager.v1";
+option php_namespace = "Google\\Ads\\AdManager\\V1";
+option ruby_package = "Google::Ads::AdManager::V1";
+
+// The `CustomTargetingValue` resource.
+message CustomTargetingValue {
+  option (google.api.resource) = {
+    type: "admanager.googleapis.com/CustomTargetingValue"
+    pattern: "networks/{network_code}/customTargetingKeys/{custom_targeting_key}/customTargetingValues/{custom_targeting_value}"
+    plural: "customTargetingValues"
+    singular: "customTargetingValue"
+  };
+
+  // Identifier. The resource name of the `CustomTargetingValue`.
+  // Format:
+  // `networks/{network_code}/customTargetingKeys/{custom_targeting_key_id}/customTargetingValues/{custom_targeting_value_id}`
+  string name = 1 [(google.api.field_behavior) = IDENTIFIER];
+
+  // Immutable. Name of the `CustomTargetingValue`. Values can contain up to 40
+  // characters each. You can use alphanumeric characters and symbols other than
+  // the following: ", ', =, !, +, #, *, ~, ;, ^, (, ), <, >, [, ]. Values are
+  // not data-specific; all values are treated as strings. For example, instead
+  // of using "age>=18 AND <=34", try "18-34"
+  string ad_tag_name = 4 [(google.api.field_behavior) = IMMUTABLE];
+
+  // Optional. Descriptive name for the `CustomTargetingValue`.
+  string display_name = 5 [(google.api.field_behavior) = OPTIONAL];
+
+  // Required. Immutable. The way in which the CustomTargetingValue.name strings
+  // will be matched.
+  CustomTargetingValueMatchTypeEnum.CustomTargetingValueMatchType match_type = 6
+      [
+        (google.api.field_behavior) = IMMUTABLE,
+        (google.api.field_behavior) = REQUIRED
+      ];
+
+  // Output only. Status of the `CustomTargetingValue`.
+  CustomTargetingValueStatusEnum.CustomTargetingValueStatus status = 7
+      [(google.api.field_behavior) = OUTPUT_ONLY];
+}

package/build/protos/google/ads/admanager/v1/custom_targeting_value_service.proto

@@ -0,0 +1,132 @@
+// Copyright 2024 Google LLC
+//
+// Licensed under the Apache License, Version 2.0 (the "License");
+// you may not use this file except in compliance with the License.
+// You may obtain a copy of the License at
+//
+//     http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+
+syntax = "proto3";
+
+package google.ads.admanager.v1;
+
+import "google/ads/admanager/v1/custom_targeting_value_messages.proto";
+import "google/api/annotations.proto";
+import "google/api/client.proto";
+import "google/api/field_behavior.proto";
+import "google/api/resource.proto";
+
+option csharp_namespace = "Google.Ads.AdManager.V1";
+option go_package = "google.golang.org/genproto/googleapis/ads/admanager/v1;admanager";
+option java_multiple_files = true;
+option java_outer_classname = "CustomTargetingValueServiceProto";
+option java_package = "com.google.ads.admanager.v1";
+option php_namespace = "Google\\Ads\\AdManager\\V1";
+option ruby_package = "Google::Ads::AdManager::V1";
+
+// Provides methods for handling `CustomTargetingValue` objects.
+service CustomTargetingValueService {
+  option (google.api.default_host) = "admanager.googleapis.com";
+
+  // API to retrieve a `CustomTargetingValue` object.
+  rpc GetCustomTargetingValue(GetCustomTargetingValueRequest)
+      returns (CustomTargetingValue) {
+    option (google.api.http) = {
+      get: "/v1/{name=networks/*/customTargetingKeys/*/customTargetingValues/*}"
+    };
+    option (google.api.method_signature) = "name";
+  }
+
+  // API to retrieve a list of `CustomTargetingValue` objects.
+  rpc ListCustomTargetingValues(ListCustomTargetingValuesRequest)
+      returns (ListCustomTargetingValuesResponse) {
+    option (google.api.http) = {
+      get: "/v1/{parent=networks/*/customTargetingKeys/*}/customTargetingValues"
+    };
+    option (google.api.method_signature) = "parent";
+  }
+}
+
+// Request object for `GetCustomTargetingValue` method.
+message GetCustomTargetingValueRequest {
+  // Required. The resource name of the CustomTargetingValue.
+  // Format:
+  // `networks/{network_code}/customTargetingKeys/{custom_targeting_key_id}/customTargetingValues/{custom_targeting_value_id}`
+  string name = 1 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = {
+      type: "admanager.googleapis.com/CustomTargetingValue"
+    }
+  ];
+}
+
+// Request object for `ListCustomTargetingValues` method.
+message ListCustomTargetingValuesRequest {
+  // Required. The parent, which owns this collection of CustomTargetingValues.
+  // Format:
+  // `networks/{network_code}/customTargetingKeys/{custom_targeting_key_id}`
+  string parent = 1 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = {
+      type: "admanager.googleapis.com/CustomTargetingKey"
+    }
+  ];
+
+  // Optional. The maximum number of `CustomTargetingValues` to return. The
+  // service may return fewer than this value. If unspecified, at most 50
+  // `CustomTargetingValues` will be returned. The maximum value is 1000; values
+  // above 1000 will be coerced to 1000.
+  int32 page_size = 2 [(google.api.field_behavior) = OPTIONAL];
+
+  // Optional. A page token, received from a previous
+  // `ListCustomTargetingValues` call. Provide this to retrieve the subsequent
+  // page.
+  //
+  // When paginating, all other parameters provided to
+  // `ListCustomTargetingValues` must match the call that provided the page
+  // token.
+  string page_token = 3 [(google.api.field_behavior) = OPTIONAL];
+
+  // Optional. Expression to filter the response.
+  // See syntax details at
+  // https://developers.google.com/ad-manager/api/beta/filters
+  string filter = 4 [(google.api.field_behavior) = OPTIONAL];
+
+  // Optional. Expression to specify sorting order.
+  // See syntax details at
+  // https://developers.google.com/ad-manager/api/beta/filters#order
+  string order_by = 5 [(google.api.field_behavior) = OPTIONAL];
+
+  // Optional. Number of individual resources to skip while paginating.
+  int32 skip = 6 [(google.api.field_behavior) = OPTIONAL];
+}
+
+// Response object for `ListCustomTargetingValuesRequest` containing matching
+// `CustomTargetingValue` objects.
+message ListCustomTargetingValuesResponse {
+  // The `CustomTargetingValue` objects from the specified network.
+  repeated CustomTargetingValue custom_targeting_values = 1;
+
+  // A token, which can be sent as `page_token` to retrieve the next page.
+  // If this field is omitted, there are no subsequent pages.
+  string next_page_token = 2;
+
+  // Total number of `CustomTargetingValue` objects.
+  // If a filter was included in the request, this reflects the total number
+  // after the filtering is applied.
+  //
+  // `total_size` will not be calculated in the response unless it has been
+  // included in a response field mask. The response field mask can be provided
+  // to the method by using the URL parameter `$fields` or `fields`, or by using
+  // the HTTP/gRPC header `X-Goog-FieldMask`.
+  //
+  // For more information, see
+  // https://developers.google.com/ad-manager/api/beta/field-masks
+  int32 total_size = 3;
+}