Merge branch 'googleapis:main' into master

Author: Dargon789

.github/CODEOWNERS

@@ -6,4 +6,4 @@
 
 
 # The yoshi-nodejs team is the default owner for nodejs repositories.
-*     @googleapis/jsteam @yoshi-approver
+*     @googleapis/jsteam

packages/google-ads-admanager/README.md

@@ -65,9 +65,16 @@ Samples are in the [`samples/`][homepage_samples] directory. Each sample's `READ
 | batch allow ad review center ads | [source code](https://github.com/googleapis/google-cloud-node/blob/main/packages/google-ads-admanager/samples/generated/v1/ad_review_center_ad_service.batch_allow_ad_review_center_ads.js) |
 | batch block ad review center ads | [source code](https://github.com/googleapis/google-cloud-node/blob/main/packages/google-ads-admanager/samples/generated/v1/ad_review_center_ad_service.batch_block_ad_review_center_ads.js) |
 | search ad review center ads | [source code](https://github.com/googleapis/google-cloud-node/blob/main/packages/google-ads-admanager/samples/generated/v1/ad_review_center_ad_service.search_ad_review_center_ads.js) |
+| batch activate ad units | [source code](https://github.com/googleapis/google-cloud-node/blob/main/packages/google-ads-admanager/samples/generated/v1/ad_unit_service.batch_activate_ad_units.js) |
+| batch archive ad units | [source code](https://github.com/googleapis/google-cloud-node/blob/main/packages/google-ads-admanager/samples/generated/v1/ad_unit_service.batch_archive_ad_units.js) |
+| batch create ad units | [source code](https://github.com/googleapis/google-cloud-node/blob/main/packages/google-ads-admanager/samples/generated/v1/ad_unit_service.batch_create_ad_units.js) |
+| batch deactivate ad units | [source code](https://github.com/googleapis/google-cloud-node/blob/main/packages/google-ads-admanager/samples/generated/v1/ad_unit_service.batch_deactivate_ad_units.js) |
+| batch update ad units | [source code](https://github.com/googleapis/google-cloud-node/blob/main/packages/google-ads-admanager/samples/generated/v1/ad_unit_service.batch_update_ad_units.js) |
+| create ad unit | [source code](https://github.com/googleapis/google-cloud-node/blob/main/packages/google-ads-admanager/samples/generated/v1/ad_unit_service.create_ad_unit.js) |
 | get ad unit | [source code](https://github.com/googleapis/google-cloud-node/blob/main/packages/google-ads-admanager/samples/generated/v1/ad_unit_service.get_ad_unit.js) |
 | list ad unit sizes | [source code](https://github.com/googleapis/google-cloud-node/blob/main/packages/google-ads-admanager/samples/generated/v1/ad_unit_service.list_ad_unit_sizes.js) |
 | list ad units | [source code](https://github.com/googleapis/google-cloud-node/blob/main/packages/google-ads-admanager/samples/generated/v1/ad_unit_service.list_ad_units.js) |
+| update ad unit | [source code](https://github.com/googleapis/google-cloud-node/blob/main/packages/google-ads-admanager/samples/generated/v1/ad_unit_service.update_ad_unit.js) |
 | get application | [source code](https://github.com/googleapis/google-cloud-node/blob/main/packages/google-ads-admanager/samples/generated/v1/application_service.get_application.js) |
 | list applications | [source code](https://github.com/googleapis/google-cloud-node/blob/main/packages/google-ads-admanager/samples/generated/v1/application_service.list_applications.js) |
 | get audience segment | [source code](https://github.com/googleapis/google-cloud-node/blob/main/packages/google-ads-admanager/samples/generated/v1/audience_segment_service.get_audience_segment.js) |
@@ -106,8 +113,14 @@ Samples are in the [`samples/`][homepage_samples] directory. Each sample's `READ
 | get custom field | [source code](https://github.com/googleapis/google-cloud-node/blob/main/packages/google-ads-admanager/samples/generated/v1/custom_field_service.get_custom_field.js) |
 | list custom fields | [source code](https://github.com/googleapis/google-cloud-node/blob/main/packages/google-ads-admanager/samples/generated/v1/custom_field_service.list_custom_fields.js) |
 | update custom field | [source code](https://github.com/googleapis/google-cloud-node/blob/main/packages/google-ads-admanager/samples/generated/v1/custom_field_service.update_custom_field.js) |
+| batch activate custom targeting keys | [source code](https://github.com/googleapis/google-cloud-node/blob/main/packages/google-ads-admanager/samples/generated/v1/custom_targeting_key_service.batch_activate_custom_targeting_keys.js) |
+| batch create custom targeting keys | [source code](https://github.com/googleapis/google-cloud-node/blob/main/packages/google-ads-admanager/samples/generated/v1/custom_targeting_key_service.batch_create_custom_targeting_keys.js) |
+| batch deactivate custom targeting keys | [source code](https://github.com/googleapis/google-cloud-node/blob/main/packages/google-ads-admanager/samples/generated/v1/custom_targeting_key_service.batch_deactivate_custom_targeting_keys.js) |
+| batch update custom targeting keys | [source code](https://github.com/googleapis/google-cloud-node/blob/main/packages/google-ads-admanager/samples/generated/v1/custom_targeting_key_service.batch_update_custom_targeting_keys.js) |
+| create custom targeting key | [source code](https://github.com/googleapis/google-cloud-node/blob/main/packages/google-ads-admanager/samples/generated/v1/custom_targeting_key_service.create_custom_targeting_key.js) |
 | get custom targeting key | [source code](https://github.com/googleapis/google-cloud-node/blob/main/packages/google-ads-admanager/samples/generated/v1/custom_targeting_key_service.get_custom_targeting_key.js) |
 | list custom targeting keys | [source code](https://github.com/googleapis/google-cloud-node/blob/main/packages/google-ads-admanager/samples/generated/v1/custom_targeting_key_service.list_custom_targeting_keys.js) |
+| update custom targeting key | [source code](https://github.com/googleapis/google-cloud-node/blob/main/packages/google-ads-admanager/samples/generated/v1/custom_targeting_key_service.update_custom_targeting_key.js) |
 | get custom targeting value | [source code](https://github.com/googleapis/google-cloud-node/blob/main/packages/google-ads-admanager/samples/generated/v1/custom_targeting_value_service.get_custom_targeting_value.js) |
 | list custom targeting values | [source code](https://github.com/googleapis/google-cloud-node/blob/main/packages/google-ads-admanager/samples/generated/v1/custom_targeting_value_service.list_custom_targeting_values.js) |
 | get device capability | [source code](https://github.com/googleapis/google-cloud-node/blob/main/packages/google-ads-admanager/samples/generated/v1/device_capability_service.get_device_capability.js) |
@@ -124,6 +137,8 @@ Samples are in the [`samples/`][homepage_samples] directory. Each sample's `READ
 | update entity signals mapping | [source code](https://github.com/googleapis/google-cloud-node/blob/main/packages/google-ads-admanager/samples/generated/v1/entity_signals_mapping_service.update_entity_signals_mapping.js) |
 | get geo target | [source code](https://github.com/googleapis/google-cloud-node/blob/main/packages/google-ads-admanager/samples/generated/v1/geo_target_service.get_geo_target.js) |
 | list geo targets | [source code](https://github.com/googleapis/google-cloud-node/blob/main/packages/google-ads-admanager/samples/generated/v1/geo_target_service.list_geo_targets.js) |
+| get line item | [source code](https://github.com/googleapis/google-cloud-node/blob/main/packages/google-ads-admanager/samples/generated/v1/line_item_service.get_line_item.js) |
+| list line items | [source code](https://github.com/googleapis/google-cloud-node/blob/main/packages/google-ads-admanager/samples/generated/v1/line_item_service.list_line_items.js) |
 | get mobile carrier | [source code](https://github.com/googleapis/google-cloud-node/blob/main/packages/google-ads-admanager/samples/generated/v1/mobile_carrier_service.get_mobile_carrier.js) |
 | list mobile carriers | [source code](https://github.com/googleapis/google-cloud-node/blob/main/packages/google-ads-admanager/samples/generated/v1/mobile_carrier_service.list_mobile_carriers.js) |
 | get mobile device | [source code](https://github.com/googleapis/google-cloud-node/blob/main/packages/google-ads-admanager/samples/generated/v1/mobile_device_service.get_mobile_device.js) |

packages/google-ads-admanager/protos/google/ads/admanager/v1/ad_review_center_ad_service.proto

@@ -117,11 +117,12 @@ message SearchAdReviewCenterAdsRequest {
   // is the value returned from a previous Search request, or empty.
   string page_token = 3 [(google.api.field_behavior) = OPTIONAL];
 
-  // Required. Only return ads with the given status.
+  // Optional. Only return ads with the given status.
   AdReviewCenterAdStatusEnum.AdReviewCenterAdStatus status = 4
-      [(google.api.field_behavior) = REQUIRED];
+      [(google.api.field_behavior) = OPTIONAL];
 
-  // Optional. If provided, only return ads with the given AdReviewCenterAd IDs.
+  // Optional. Only return ads with the given AdReviewCenterAd IDs. If provided,
+  // no other filter can be set (other than page size and page token).
   repeated string ad_review_center_ad_id = 5
       [(google.api.field_behavior) = OPTIONAL];
 

packages/google-ads-admanager/protos/google/ads/admanager/v1/ad_unit_service.proto

@@ -21,6 +21,7 @@ import "google/api/annotations.proto";
 import "google/api/client.proto";
 import "google/api/field_behavior.proto";
 import "google/api/resource.proto";
+import "google/protobuf/field_mask.proto";
 
 option csharp_namespace = "Google.Ads.AdManager.V1";
 option go_package = "google.golang.org/genproto/googleapis/ads/admanager/v1;admanager";
@@ -60,6 +61,74 @@ service AdUnitService {
     };
     option (google.api.method_signature) = "parent";
   }
+
+  // API to create an `AdUnit` object.
+  rpc CreateAdUnit(CreateAdUnitRequest) returns (AdUnit) {
+    option (google.api.http) = {
+      post: "/v1/{parent=networks/*}/adUnits"
+      body: "ad_unit"
+    };
+    option (google.api.method_signature) = "parent,ad_unit";
+  }
+
+  // API to update an `AdUnit` object.
+  rpc UpdateAdUnit(UpdateAdUnitRequest) returns (AdUnit) {
+    option (google.api.http) = {
+      patch: "/v1/{ad_unit.name=networks/*/adUnits/*}"
+      body: "ad_unit"
+    };
+    option (google.api.method_signature) = "ad_unit,update_mask";
+  }
+
+  // API to batch create `AdUnit` objects.
+  rpc BatchCreateAdUnits(BatchCreateAdUnitsRequest)
+      returns (BatchCreateAdUnitsResponse) {
+    option (google.api.http) = {
+      post: "/v1/{parent=networks/*}/adUnits:batchCreate"
+      body: "*"
+    };
+    option (google.api.method_signature) = "parent,requests";
+  }
+
+  // API to batch update `AdUnit` objects.
+  rpc BatchUpdateAdUnits(BatchUpdateAdUnitsRequest)
+      returns (BatchUpdateAdUnitsResponse) {
+    option (google.api.http) = {
+      post: "/v1/{parent=networks/*}/adUnits:batchUpdate"
+      body: "*"
+    };
+    option (google.api.method_signature) = "parent,requests";
+  }
+
+  // API to batch activate `AdUnit` objects.
+  rpc BatchActivateAdUnits(BatchActivateAdUnitsRequest)
+      returns (BatchActivateAdUnitsResponse) {
+    option (google.api.http) = {
+      post: "/v1/{parent=networks/*}/adUnits:batchActivate"
+      body: "*"
+    };
+    option (google.api.method_signature) = "parent,names";
+  }
+
+  // Deactivates a list of `AdUnit` objects.
+  rpc BatchDeactivateAdUnits(BatchDeactivateAdUnitsRequest)
+      returns (BatchDeactivateAdUnitsResponse) {
+    option (google.api.http) = {
+      post: "/v1/{parent=networks/*}/adUnits:batchDeactivate"
+      body: "*"
+    };
+    option (google.api.method_signature) = "parent,names";
+  }
+
+  // Archives a list of `AdUnit` objects.
+  rpc BatchArchiveAdUnits(BatchArchiveAdUnitsRequest)
+      returns (BatchArchiveAdUnitsResponse) {
+    option (google.api.http) = {
+      post: "/v1/{parent=networks/*}/adUnits:batchArchive"
+      body: "*"
+    };
+    option (google.api.method_signature) = "parent,names";
+  }
 }
 
 // Request object for GetAdUnit method.
@@ -135,6 +204,84 @@ message ListAdUnitsResponse {
   int32 total_size = 3;
 }
 
+// Request object for `CreateAdUnit` method.
+message CreateAdUnitRequest {
+  // Required. The parent resource where this `AdUnit` will be created.
+  // Format: `networks/{network_code}`
+  string parent = 1 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = {
+      type: "admanager.googleapis.com/Network"
+    }
+  ];
+
+  // Required. The `AdUnit` to create.
+  AdUnit ad_unit = 2 [(google.api.field_behavior) = REQUIRED];
+}
+
+// Request object for `UpdateAdUnit` method.
+message UpdateAdUnitRequest {
+  // Required. The `AdUnit` to update.
+  //
+  // The `AdUnit`'s name is used to identify the `AdUnit` to update. Format:
+  // `networks/{network_code}/adUnits/{ad_unit_id}`
+  AdUnit ad_unit = 1 [(google.api.field_behavior) = REQUIRED];
+
+  // Required. The list of fields to update.
+  google.protobuf.FieldMask update_mask = 2
+      [(google.api.field_behavior) = REQUIRED];
+}
+
+// Request object for `BatchCreateAdUnits` method.
+message BatchCreateAdUnitsRequest {
+  // Required. The parent resource where `AdUnits` will be created.
+  // Format: `networks/{network_code}`
+  // The parent field in the CreateAdUnitRequest must match this
+  // field.
+  string parent = 1 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = {
+      type: "admanager.googleapis.com/Network"
+    }
+  ];
+
+  // Required. The `AdUnit` objects to create.
+  // A maximum of 100 objects can be created in a batch.
+  repeated CreateAdUnitRequest requests = 2
+      [(google.api.field_behavior) = REQUIRED];
+}
+
+// Response object for `BatchCreateAdUnits` method.
+message BatchCreateAdUnitsResponse {
+  // The `AdUnit` objects created.
+  repeated AdUnit ad_units = 1;
+}
+
+// Request object for `BatchUpdateAdUnits` method.
+message BatchUpdateAdUnitsRequest {
+  // Required. The parent resource where `AdUnits` will be updated.
+  // Format: `networks/{network_code}`
+  // The parent field in the UpdateAdUnitRequest must match this
+  // field.
+  string parent = 1 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = {
+      type: "admanager.googleapis.com/Network"
+    }
+  ];
+
+  // Required. The `AdUnit` objects to update.
+  // A maximum of 100 objects can be updated in a batch.
+  repeated UpdateAdUnitRequest requests = 2
+      [(google.api.field_behavior) = REQUIRED];
+}
+
+// Response object for `BatchUpdateAdUnits` method.
+message BatchUpdateAdUnitsResponse {
+  // The `AdUnit` objects updated.
+  repeated AdUnit ad_units = 1;
+}
+
 // Request object for ListAdUnitSizes method.
 message ListAdUnitSizesRequest {
   // Required. The parent, which owns this collection of AdUnitSizes.
@@ -195,3 +342,72 @@ message ListAdUnitSizesResponse {
   // https://developers.google.com/ad-manager/api/beta/field-masks
   int32 total_size = 3;
 }
+
+// Request object for `BatchActivateAdUnits` method.
+message BatchActivateAdUnitsRequest {
+  // Required. Format: `networks/{network_code}`
+  string parent = 1 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = {
+      type: "admanager.googleapis.com/Network"
+    }
+  ];
+
+  // Required. The resource names of the `AdUnit`s to activate.
+  // Format: `networks/{network_code}/adUnits/{ad_unit_id}`
+  repeated string names = 2 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = {
+      type: "admanager.googleapis.com/AdUnit"
+    }
+  ];
+}
+
+// Response object for `BatchActivateAdUnits` method.
+message BatchActivateAdUnitsResponse {}
+
+// Request object for `BatchDeactivateAdUnits` method.
+message BatchDeactivateAdUnitsRequest {
+  // Required. Format: `networks/{network_code}`
+  string parent = 1 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = {
+      type: "admanager.googleapis.com/Network"
+    }
+  ];
+
+  // Required. The resource names of the `AdUnit`s to deactivate.
+  // Format: `networks/{network_code}/adUnits/{ad_unit_id}`
+  repeated string names = 2 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = {
+      type: "admanager.googleapis.com/AdUnit"
+    }
+  ];
+}
+
+// Response object for `BatchDeactivateAdUnits` method.
+message BatchDeactivateAdUnitsResponse {}
+
+// Request object for `BatchArchiveAdUnits` method.
+message BatchArchiveAdUnitsRequest {
+  // Required. Format: `networks/{network_code}`
+  string parent = 1 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = {
+      type: "admanager.googleapis.com/Network"
+    }
+  ];
+
+  // Required. The resource names of the `AdUnit`s to archive.
+  // Format: `networks/{network_code}/adUnits/{ad_unit_id}`
+  repeated string names = 2 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = {
+      type: "admanager.googleapis.com/AdUnit"
+    }
+  ];
+}
+
+// Response object for `BatchArchiveAdUnits` method.
+message BatchArchiveAdUnitsResponse {}

packages/google-ads-admanager/protos/google/ads/admanager/v1/cms_metadata_value_service.proto

@@ -36,7 +36,7 @@ service CmsMetadataValueService {
   option (google.api.oauth_scopes) =
       "https://www.googleapis.com/auth/admanager";
 
-  // API to retrieve a `CmsMetadataKey` object.
+  // API to retrieve a `CmsMetadataValue` object.
   rpc GetCmsMetadataValue(GetCmsMetadataValueRequest)
       returns (CmsMetadataValue) {
     option (google.api.http) = {
@@ -57,7 +57,7 @@ service CmsMetadataValueService {
 
 // Request object for `GetCmsMetadataValue` method.
 message GetCmsMetadataValueRequest {
-  // Required. The resource name of the CmsMetadataKey.
+  // Required. The resource name of the CmsMetadataValue.
   // Format: `networks/{network_code}/cmsMetadataValues/{cms_metadata_value_id}`
   string name = 1 [
     (google.api.field_behavior) = REQUIRED,