@google-ads/admanager 0.9.0 → 0.10.0

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

@@ -115,12 +115,11 @@ message ListCmsMetadataKeysRequest {
   //  See syntax details at
   //  https://developers.google.com/ad-manager/api/beta/filters
   //
-  // <b>Filterable fields:</b>
-  // <ul style="list-style-type:none">
-  //   <li><code>displayName</code></li>
-  //   <li><code>name</code></li>
-  //   <li><code>status</code></li>
-  // </ul>
+  // **Filterable fields:**
+  //
+  // * `displayName`
+  // * `name`
+  // * `status`
   string filter = 4 [(google.api.field_behavior) = OPTIONAL];
 
   // Optional. Expression to specify sorting order.

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

@@ -116,13 +116,12 @@ message ListCmsMetadataValuesRequest {
   //  See syntax details at
   //  https://developers.google.com/ad-manager/api/beta/filters
   //
-  // <b>Filterable fields:</b>
-  // <ul style="list-style-type:none">
-  //   <li><code>displayName</code></li>
-  //   <li><code>key</code></li>
-  //   <li><code>name</code></li>
-  //   <li><code>status</code></li>
-  // </ul>
+  // **Filterable fields:**
+  //
+  // * `displayName`
+  // * `key`
+  // * `name`
+  // * `status`
   string filter = 4 [(google.api.field_behavior) = OPTIONAL];
 
   // Optional. Expression to specify sorting order.

package/build/protos/google/ads/admanager/v1/company_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";
@@ -30,14 +31,15 @@ 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 `Company` objects.
+// Provides methods for handling [Company][google.ads.admanager.v1.Company]
+// objects.
 service CompanyService {
   option (google.api.default_host) = "admanager.googleapis.com";
   option (google.api.oauth_scopes) =
       "https://www.googleapis.com/auth/admanager,"
       "https://www.googleapis.com/auth/admanager.readonly";
 
-  // Retrieves a `Company` object.
+  // Retrieves a [Company][google.ads.admanager.v1.Company] object.
   rpc GetCompany(GetCompanyRequest) returns (Company) {
     option (google.api.http) = {
       get: "/v1/{name=networks/*/companies/*}"
@@ -45,16 +47,54 @@ service CompanyService {
     option (google.api.method_signature) = "name";
   }
 
-  // Lists `Company` objects.
+  // Lists [Company][google.ads.admanager.v1.Company] objects.
   rpc ListCompanies(ListCompaniesRequest) returns (ListCompaniesResponse) {
     option (google.api.http) = {
       get: "/v1/{parent=networks/*}/companies"
     };
     option (google.api.method_signature) = "parent";
   }
+
+  // Creates a [Company][google.ads.admanager.v1.Company] object.
+  rpc CreateCompany(CreateCompanyRequest) returns (Company) {
+    option (google.api.http) = {
+      post: "/v1/{parent=networks/*}/companies"
+      body: "company"
+    };
+    option (google.api.method_signature) = "parent,company";
+  }
+
+  // Creates [Company][google.ads.admanager.v1.Company] objects.
+  rpc BatchCreateCompanies(BatchCreateCompaniesRequest)
+      returns (BatchCreateCompaniesResponse) {
+    option (google.api.http) = {
+      post: "/v1/{parent=networks/*}/companies:batchCreate"
+      body: "*"
+    };
+    option (google.api.method_signature) = "parent,requests";
+  }
+
+  // Updates a [Company][google.ads.admanager.v1.Company] object.
+  rpc UpdateCompany(UpdateCompanyRequest) returns (Company) {
+    option (google.api.http) = {
+      patch: "/v1/{company.name=networks/*/companies/*}"
+      body: "company"
+    };
+    option (google.api.method_signature) = "company,update_mask";
+  }
+
+  // Batch updates [Company][google.ads.admanager.v1.Company] objects.
+  rpc BatchUpdateCompanies(BatchUpdateCompaniesRequest)
+      returns (BatchUpdateCompaniesResponse) {
+    option (google.api.http) = {
+      post: "/v1/{parent=networks/*}/companies:batchUpdate"
+      body: "*"
+    };
+    option (google.api.method_signature) = "parent,requests";
+  }
 }
 
-// Request object for `GetCompany` method.
+// Request object for [GetCompany][] method.
 message GetCompanyRequest {
   // Required. The resource name of the Company.
   // Format: `networks/{network_code}/companies/{company_id}`
@@ -66,9 +106,9 @@ message GetCompanyRequest {
   ];
 }
 
-// Request object for `ListCompanies` method.
+// Request object for [ListCompanies][] method.
 message ListCompaniesRequest {
-  // Required. The parent, which owns this collection of Companies.
+  // Required. The parent, which owns this collection of [Companies][].
   // Format: `networks/{network_code}`
   string parent = 1 [
     (google.api.field_behavior) = REQUIRED,
@@ -77,16 +117,16 @@ message ListCompaniesRequest {
     }
   ];
 
-  // Optional. The maximum number of `Companies` to return. The service may
-  // return fewer than this value. If unspecified, at most 50 `Companies` will
+  // Optional. The maximum number of [Companies][] to return. The service may
+  // return fewer than this value. If unspecified, at most 50 [Companies][] will
   // be returned. The maximum value is 1000; values greater than 1000 will be
   // coerced to 1000.
   int32 page_size = 2 [(google.api.field_behavior) = OPTIONAL];
 
-  // Optional. A page token, received from a previous `ListCompanies` call.
+  // Optional. A page token, received from a previous [ListCompanies][] call.
   // Provide this to retrieve the subsequent page.
   //
-  // When paginating, all other parameters provided to `ListCompanies` must
+  // When paginating, all other parameters provided to [ListCompanies][] must
   // match the call that provided the page token.
   string page_token = 3 [(google.api.field_behavior) = OPTIONAL];
 
@@ -94,22 +134,21 @@ message ListCompaniesRequest {
   //  See syntax details at
   //  https://developers.google.com/ad-manager/api/beta/filters
   //
-  // <b>Filterable fields:</b>
-  // <ul style="list-style-type:none">
-  //   <li><code>address</code></li>
-  //   <li><code>comment</code></li>
-  //   <li><code>companyId</code></li>
-  //   <li><code>creditStatus</code></li>
-  //   <li><code>displayName</code></li>
-  //   <li><code>email</code></li>
-  //   <li><code>externalId</code></li>
-  //   <li><code>fax</code></li>
-  //   <li><code>name</code></li>
-  //   <li><code>phone</code></li>
-  //   <li><code>thirdPartyCompanyId</code></li>
-  //   <li><code>type</code></li>
-  //   <li><code>updateTime</code></li>
-  // </ul>
+  // **Filterable fields:**
+  //
+  // * `address`
+  // * `comment`
+  // * `companyId`
+  // * `creditStatus`
+  // * `displayName`
+  // * `email`
+  // * `externalId`
+  // * `fax`
+  // * `name`
+  // * `phone`
+  // * `thirdPartyCompanyId`
+  // * `type`
+  // * `updateTime`
   string filter = 4 [(google.api.field_behavior) = OPTIONAL];
 
   // Optional. Expression to specify sorting order.
@@ -121,17 +160,19 @@ message ListCompaniesRequest {
   int32 skip = 6 [(google.api.field_behavior) = OPTIONAL];
 }
 
-// Response object for `ListCompaniesRequest` containing matching `Company`
-// objects.
+// Response object for
+// [ListCompaniesRequest][google.ads.admanager.v1.ListCompaniesRequest]
+// containing matching [Company][google.ads.admanager.v1.Company] objects.
 message ListCompaniesResponse {
-  // The `Company` objects from the specified network.
+  // The [Company][google.ads.admanager.v1.Company] objects from the specified
+  // network.
   repeated Company companies = 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 `Company` objects.
+  // Total number of [Company][google.ads.admanager.v1.Company] objects.
   // If a filter was included in the request, this reflects the total number
   // after the filtering is applied.
   //
@@ -144,3 +185,82 @@ message ListCompaniesResponse {
   // https://developers.google.com/ad-manager/api/beta/field-masks
   int32 total_size = 3;
 }
+
+// Request object for [CreateCompany][] method.
+message CreateCompanyRequest {
+  // Required. The parent resource where this
+  // [Company][google.ads.admanager.v1.Company] 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 [Company][google.ads.admanager.v1.Company] to create.
+  Company company = 2 [(google.api.field_behavior) = REQUIRED];
+}
+
+// Request object for [BatchCreateCompanies][] method.
+message BatchCreateCompaniesRequest {
+  // Required. The parent resource where [Companies][] will be created.
+  // Format: `networks/{network_code}`
+  // The parent field in the CreateCompanyRequest must match this
+  // field.
+  string parent = 1 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = {
+      type: "admanager.googleapis.com/Network"
+    }
+  ];
+
+  // Required. The [Company][google.ads.admanager.v1.Company] objects to create.
+  // A maximum of 100 objects can be created in a batch.
+  repeated CreateCompanyRequest requests = 2
+      [(google.api.field_behavior) = REQUIRED];
+}
+
+// Response object for [BatchCreateCompanies][] method.
+message BatchCreateCompaniesResponse {
+  // The [Company][google.ads.admanager.v1.Company] objects created.
+  repeated Company companies = 1;
+}
+
+// Request object for [UpdateCompany][] method.
+message UpdateCompanyRequest {
+  // Required. The [Company][google.ads.admanager.v1.Company] to update.
+  //
+  // The [Company][google.ads.admanager.v1.Company]'s `name` is used to identify
+  // the [Company][google.ads.admanager.v1.Company] to update.
+  Company company = 1 [(google.api.field_behavior) = REQUIRED];
+
+  // Optional. The list of fields to update.
+  google.protobuf.FieldMask update_mask = 2
+      [(google.api.field_behavior) = OPTIONAL];
+}
+
+// Request object for [BatchUpdateCompanies][] method.
+message BatchUpdateCompaniesRequest {
+  // Required. The parent resource where [Companies][] will be updated.
+  // Format: `networks/{network_code}`
+  // The parent field in the UpdateCompanyRequest must match this
+  // field.
+  string parent = 1 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = {
+      type: "admanager.googleapis.com/Network"
+    }
+  ];
+
+  // Required. The [Company][google.ads.admanager.v1.Company] objects to update.
+  // A maximum of 100 objects can be updated in a batch.
+  repeated UpdateCompanyRequest requests = 2
+      [(google.api.field_behavior) = REQUIRED];
+}
+
+// Response object for [BatchUpdateCompanies][] method.
+message BatchUpdateCompaniesResponse {
+  // The [Company][google.ads.admanager.v1.Company] objects updated.
+  repeated Company companies = 1;
+}

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

@@ -133,20 +133,19 @@ message ListContactsRequest {
   //  See syntax details at
   //  https://developers.google.com/ad-manager/api/beta/filters
   //
-  // <b>Filterable fields:</b>
-  // <ul style="list-style-type:none">
-  //   <li><code>address</code></li>
-  //   <li><code>cellPhone</code></li>
-  //   <li><code>comment</code></li>
-  //   <li><code>company</code></li>
-  //   <li><code>displayName</code></li>
-  //   <li><code>email</code></li>
-  //   <li><code>fax</code></li>
-  //   <li><code>name</code></li>
-  //   <li><code>status</code></li>
-  //   <li><code>title</code></li>
-  //   <li><code>workPhone</code></li>
-  // </ul>
+  // **Filterable fields:**
+  //
+  // * `address`
+  // * `cellPhone`
+  // * `comment`
+  // * `company`
+  // * `displayName`
+  // * `email`
+  // * `fax`
+  // * `name`
+  // * `status`
+  // * `title`
+  // * `workPhone`
   string filter = 4 [(google.api.field_behavior) = OPTIONAL];
 
   // Optional. Expression to specify sorting order.

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

@@ -115,13 +115,12 @@ message ListContentBundlesRequest {
   //  See syntax details at
   //  https://developers.google.com/ad-manager/api/beta/filters
   //
-  // <b>Filterable fields:</b>
-  // <ul style="list-style-type:none">
-  //   <li><code>displayName</code></li>
-  //   <li><code>name</code></li>
-  //   <li><code>status</code></li>
-  //   <li><code>updateTime</code></li>
-  // </ul>
+  // **Filterable fields:**
+  //
+  // * `displayName`
+  // * `name`
+  // * `status`
+  // * `updateTime`
   string filter = 4 [(google.api.field_behavior) = OPTIONAL];
 
   // Optional. Expression to specify sorting order.

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

@@ -95,11 +95,10 @@ message ListContentLabelsRequest {
   //  See syntax details at
   //  https://developers.google.com/ad-manager/api/beta/filters
   //
-  // <b>Filterable fields:</b>
-  // <ul style="list-style-type:none">
-  //   <li><code>displayName</code></li>
-  //   <li><code>name</code></li>
-  // </ul>
+  // **Filterable fields:**
+  //
+  // * `displayName`
+  // * `name`
   string filter = 4 [(google.api.field_behavior) = OPTIONAL];
 
   // Optional. Expression to specify sorting order.

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

@@ -94,24 +94,23 @@ message ListContentRequest {
   //  See syntax details at
   //  https://developers.google.com/ad-manager/api/beta/filters
   //
-  // <b>Filterable fields:</b>
-  // <ul style="list-style-type:none">
-  //   <li><code>cmsMetadataValues</code></li>
-  //   <li><code>cmsSources.contentSource</code></li>
-  //   <li><code>cmsSources.contentSourceDisplayName</code></li>
-  //   <li><code>contentBundles</code></li>
-  //   <li><code>contentStatusSource</code></li>
-  //   <li><code>dashIngestStatus</code></li>
-  //   <li><code>displayName</code></li>
-  //   <li><code>duration</code></li>
-  //   <li><code>hlsIngestStatus</code></li>
-  //   <li><code>importTime</code></li>
-  //   <li><code>lastDashIngestTime</code></li>
-  //   <li><code>lastHlsIngestTime</code></li>
-  //   <li><code>name</code></li>
-  //   <li><code>status</code></li>
-  //   <li><code>updateTime</code></li>
-  // </ul>
+  // **Filterable fields:**
+  //
+  // * `cmsMetadataValues`
+  // * `cmsSources.contentSource`
+  // * `cmsSources.contentSourceDisplayName`
+  // * `contentBundles`
+  // * `contentStatusSource`
+  // * `dashIngestStatus`
+  // * `displayName`
+  // * `duration`
+  // * `hlsIngestStatus`
+  // * `importTime`
+  // * `lastDashIngestTime`
+  // * `lastHlsIngestTime`
+  // * `name`
+  // * `status`
+  // * `updateTime`
   string filter = 4 [(google.api.field_behavior) = OPTIONAL];
 
   // Optional. Expression to specify sorting order.

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

@@ -0,0 +1,123 @@
+// Copyright 2026 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 = "ConversionEventEnumProto";
+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
+// [ConversionEvent][google.ads.admanager.v1.ConversionEventEnum.ConversionEvent]
+message ConversionEventEnum {
+  // All possible tracking event types. Not all events are supported by every
+  // kind of creative.
+  enum ConversionEvent {
+    // Default value. This value is unused.
+    CONVERSION_EVENT_UNSPECIFIED = 0;
+
+    // Corresponds to the `acceptInvitation` tracking event.
+    ACCEPT_INVITATION = 1;
+
+    // Corresponds to the `Linear.VideoClicks.ClickTracking` node.
+    CLICK_TRACKING = 2;
+
+    // Corresponds to the `close` tracking event.
+    CLOSE = 3;
+
+    // Corresponds to the `collapse` tracking event.
+    COLLAPSE = 4;
+
+    // Corresponds to the `complete` tracking event.
+    COMPLETE = 5;
+
+    // Corresponds to the `creativeView` tracking event.
+    CREATIVE_VIEW = 6;
+
+    // Corresponds to the `Linear.VideoClicks.CustomClick` node.
+    CUSTOM_CLICK = 7;
+
+    // An event that is fired after 30 seconds of viewing the video
+    // or when the video finished (if the video duration is less than 30
+    // seconds). This event does not correspond to any VAST element and is
+    // implemented using an extension.
+    ENGAGED_VIEW = 8;
+
+    // Corresponds to the `expand` tracking event.
+    EXPAND = 9;
+
+    // Corresponds to the `firstQuartile` tracking event.
+    FIRST_QUARTILE = 10;
+
+    // Corresponds to the `fullscreen` tracking event.
+    FULLSCREEN = 11;
+
+    // Corresponds to the `fullyViewableAudibleHalfDurationImpression` tracking
+    // event.
+    FULLY_VIEWABLE_AUDIBLE_HALF_DURATION_IMPRESSION = 12;
+
+    // Corresponds to the `measurableImpression` tracking event.
+    MEASURABLE_IMPRESSION = 13;
+
+    // Corresponds to the `midpoint` tracking event.
+    MIDPOINT = 14;
+
+    // Corresponds to the `mute` tracking event.
+    MUTE = 15;
+
+    // Corresponds to the `pause` tracking event.
+    PAUSE = 16;
+
+    // Corresponds to the `resume` tracking event.
+    RESUME = 17;
+
+    // Corresponds to the `rewind` tracking event.
+    REWIND = 18;
+
+    // An event that is fired when a video was skipped.
+    // This event does not correspond to any VAST element and is implemented
+    // using an extension.
+    SKIPPED = 19;
+
+    // An event that is fired when a video skip button is shown,
+    // usually after 5 seconds of viewing the video.
+    // This event does not correspond to any VAST element and is implemented
+    // using an extension.
+    SKIP_SHOWN = 20;
+
+    // Corresponds to the `start` tracking event.
+    START = 21;
+
+    // Corresponds to the `InLine.Survey` node.
+    SURVEY = 22;
+
+    // Corresponds to the `thirdQuartile` tracking event.
+    THIRD_QUARTILE = 23;
+
+    // Corresponds to the `unmute` tracking event.
+    UNMUTE = 24;
+
+    // Corresponds to the `abandon` tracking event.
+    VIDEO_ABANDON = 25;
+
+    // Corresponds to the `viewableImpression` tracking event.
+    VIEWABLE_IMPRESSION = 26;
+  }
+}

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

@@ -114,14 +114,13 @@ message ListCreativeSetsRequest {
   //  See syntax details at
   //  https://developers.google.com/ad-manager/api/beta/filters
   //
-  // <b>Filterable fields:</b>
-  // <ul style="list-style-type:none">
-  //   <li><code>companionCreatives</code></li>
-  //   <li><code>displayName</code></li>
-  //   <li><code>masterCreative</code></li>
-  //   <li><code>name</code></li>
-  //   <li><code>updateTime</code></li>
-  // </ul>
+  // **Filterable fields:**
+  //
+  // * `companionCreatives`
+  // * `displayName`
+  // * `masterCreative`
+  // * `name`
+  // * `updateTime`
   string filter = 4 [(google.api.field_behavior) = OPTIONAL];
 
   // Optional. Expression to specify sorting order.

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

@@ -96,18 +96,17 @@ message ListCreativeTemplatesRequest {
   //  See syntax details at
   //  https://developers.google.com/ad-manager/api/beta/filters
   //
-  // <b>Filterable fields:</b>
-  // <ul style="list-style-type:none">
-  //   <li><code>description</code></li>
-  //   <li><code>displayName</code></li>
-  //   <li><code>interstitial</code></li>
-  //   <li><code>name</code></li>
-  //   <li><code>nativeEligible</code></li>
-  //   <li><code>nativeVideoEligible</code></li>
-  //   <li><code>safeFrameCompatible</code></li>
-  //   <li><code>status</code></li>
-  //   <li><code>type</code></li>
-  // </ul>
+  // **Filterable fields:**
+  //
+  // * `description`
+  // * `displayName`
+  // * `interstitial`
+  // * `name`
+  // * `nativeEligible`
+  // * `nativeVideoEligible`
+  // * `safeFrameCompatible`
+  // * `status`
+  // * `type`
   string filter = 4 [(google.api.field_behavior) = OPTIONAL];
 
   // Optional. Expression to specify sorting order.