@google-ads/admanager 0.4.0 → 0.5.0

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

@@ -63,6 +63,14 @@ message Targeting {
   // Optional. Used to target data segments.
   DataSegmentTargeting data_segment_targeting = 13
       [(google.api.field_behavior) = OPTIONAL];
+
+  // Optional. Used to target content.
+  ContentTargeting content_targeting = 15
+      [(google.api.field_behavior) = OPTIONAL];
+
+  // Optional. Used to target mobile applications.
+  MobileApplicationTargeting mobile_application_targeting = 18
+      [(google.api.field_behavior) = OPTIONAL];
 }
 
 // Represents a list of targeted and excluded geos.
@@ -91,10 +99,30 @@ message TechnologyTargeting {
   BandwidthTargeting bandwidth_targeting = 3
       [(google.api.field_behavior) = OPTIONAL];
 
+  // Optional. Browser targeting dimension.
+  BrowserTargeting browser_targeting = 4
+      [(google.api.field_behavior) = OPTIONAL];
+
+  // Optional. Browser language targeting dimension.
+  BrowserLanguageTargeting browser_language_targeting = 5
+      [(google.api.field_behavior) = OPTIONAL];
+
+  // Optional. Device capability targeting dimension.
+  DeviceCapabilityTargeting device_capability_targeting = 6
+      [(google.api.field_behavior) = OPTIONAL];
+
   // Optional. Device category targeting dimension.
   DeviceCategoryTargeting device_category_targeting = 1
       [(google.api.field_behavior) = OPTIONAL];
 
+  // Optional. Device manufacturer targeting dimension.
+  DeviceManufacturerTargeting device_manufacturer_targeting = 7
+      [(google.api.field_behavior) = OPTIONAL];
+
+  // Optional. Mobile carrier targeting dimension.
+  MobileCarrierTargeting mobile_carrier_targeting = 8
+      [(google.api.field_behavior) = OPTIONAL];
+
   // Optional. Operating system targeting dimension.
   OperatingSystemTargeting operating_system_targeting = 2
       [(google.api.field_behavior) = OPTIONAL];
@@ -125,6 +153,57 @@ message BandwidthTargeting {
   ];
 }
 
+// Browser Targeting.
+//
+// Allows publishers to target/exclude a browser type (e.g. Chrome, Firefox,
+// Safari). For more information, see
+// https://support.google.com/admanager/answer/2884033 (Targeting types >
+// Browser).
+message BrowserTargeting {
+  // Optional. A list of browser resource names that should be
+  // targeted/included.
+  repeated string targeted_browsers = 3 [
+    (google.api.field_behavior) = OPTIONAL,
+    (google.api.resource_reference) = {
+      type: "admanager.googleapis.com/Browser"
+    }
+  ];
+
+  // Optional. A list of browser resource names that should be excluded.
+  repeated string excluded_browsers = 4 [
+    (google.api.field_behavior) = OPTIONAL,
+    (google.api.resource_reference) = {
+      type: "admanager.googleapis.com/Browser"
+    }
+  ];
+}
+
+// Browser Language Targeting.
+//
+// For ads targeting mobile apps and their associated WebViews, the language
+// used is based on the language specified by the user in their mobile device
+// settings. If a browser has more than one language assigned to it, each
+// language generates an impression.
+message BrowserLanguageTargeting {
+  // Optional. A list of browser language resource names that should be
+  // targeted/included.
+  repeated string targeted_browser_languages = 3 [
+    (google.api.field_behavior) = OPTIONAL,
+    (google.api.resource_reference) = {
+      type: "admanager.googleapis.com/BrowserLanguage"
+    }
+  ];
+
+  // Optional. A list of browser language resource names that should be
+  // excluded.
+  repeated string excluded_browser_languages = 4 [
+    (google.api.field_behavior) = OPTIONAL,
+    (google.api.resource_reference) = {
+      type: "admanager.googleapis.com/BrowserLanguage"
+    }
+  ];
+}
+
 // Represents a list of targeted and excluded device categories.
 message DeviceCategoryTargeting {
   // Optional. A list of device category resource names that should be
@@ -145,6 +224,116 @@ message DeviceCategoryTargeting {
   ];
 }
 
+// Device Capability Targeting.
+//
+// Can be used to target/exclude users using mobile apps, ad requests resulting
+// from apps built on the MRAID standard, or users on devices that are able to
+// make phone calls versus devices that aren't able to make phone calls, such as
+// tablets.
+message DeviceCapabilityTargeting {
+  // Optional. A list of device capability resource names that should be
+  // targeted/included.
+  repeated string targeted_capabilities = 3 [
+    (google.api.field_behavior) = OPTIONAL,
+    (google.api.resource_reference) = {
+      type: "admanager.googleapis.com/DeviceCapability"
+    }
+  ];
+
+  // Optional. A list of device capability resource names that should be
+  // excluded.
+  repeated string excluded_capabilities = 4 [
+    (google.api.field_behavior) = OPTIONAL,
+    (google.api.resource_reference) = {
+      type: "admanager.googleapis.com/DeviceCapability"
+    }
+  ];
+}
+
+// Device Manufacturer Targeting.
+//
+// Can be used to target/exclude users on devices made by specific brands or
+// companies, such as Apple, Google, Samsung and others. For more information,
+// see https://support.google.com/admanager/answer/2884033 ("Targeting types >
+// Device manufacturer").
+message DeviceManufacturerTargeting {
+  // Optional. A list of device manufacturer resource names that should be
+  // targeted/included.
+  repeated string targeted_device_manufacturers = 7 [
+    (google.api.field_behavior) = OPTIONAL,
+    (google.api.resource_reference) = {
+      type: "admanager.googleapis.com/DeviceManufacturer"
+    }
+  ];
+
+  // Optional. A list of device manufacturer resource names that should be
+  // excluded.
+  repeated string excluded_device_manufacturers = 8 [
+    (google.api.field_behavior) = OPTIONAL,
+    (google.api.resource_reference) = {
+      type: "admanager.googleapis.com/DeviceManufacturer"
+    }
+  ];
+
+  // Optional. A list of mobile device resource names that should be
+  // targeted/included.
+  repeated string targeted_mobile_devices = 9 [
+    (google.api.field_behavior) = OPTIONAL,
+    (google.api.resource_reference) = {
+      type: "admanager.googleapis.com/MobileDevice"
+    }
+  ];
+
+  // Optional. A list of mobile device resource names that should be excluded.
+  repeated string excluded_mobile_devices = 10 [
+    (google.api.field_behavior) = OPTIONAL,
+    (google.api.resource_reference) = {
+      type: "admanager.googleapis.com/MobileDevice"
+    }
+  ];
+
+  // Optional. A list of mobile device submodel resource names that should be
+  // targeted/included.
+  repeated string targeted_mobile_device_submodels = 11 [
+    (google.api.field_behavior) = OPTIONAL,
+    (google.api.resource_reference) = {
+      type: "admanager.googleapis.com/MobileDeviceSubmodel"
+    }
+  ];
+
+  // Optional. A list of mobile device submodel resource names that should be
+  // excluded.
+  repeated string excluded_mobile_device_submodels = 12 [
+    (google.api.field_behavior) = OPTIONAL,
+    (google.api.resource_reference) = {
+      type: "admanager.googleapis.com/MobileDeviceSubmodel"
+    }
+  ];
+}
+
+// Mobile Carrier Targeting.
+//
+// Can be used to target/exclude a variety of mobile carriers, such as AT&T,
+// Verizon, or T-Mobile.
+message MobileCarrierTargeting {
+  // Optional. A list of mobile carrier resource names that should be
+  // targeted/included.
+  repeated string targeted_mobile_carriers = 3 [
+    (google.api.field_behavior) = OPTIONAL,
+    (google.api.resource_reference) = {
+      type: "admanager.googleapis.com/MobileCarrier"
+    }
+  ];
+
+  // Optional. A list of mobile carrier resource names that should be excluded.
+  repeated string excluded_mobile_carriers = 4 [
+    (google.api.field_behavior) = OPTIONAL,
+    (google.api.resource_reference) = {
+      type: "admanager.googleapis.com/MobileCarrier"
+    }
+  ];
+}
+
 // Operating System Targeting
 message OperatingSystemTargeting {
   // Optional. A list of operating system resource names that should be
@@ -245,6 +434,14 @@ message CustomTargetingClause {
   // Optional. Leaf targeting expressions for custom key/values.
   repeated CustomTargetingLiteral custom_targeting_literals = 1
       [(google.api.field_behavior) = OPTIONAL];
+
+  // Optional. Leaf targeting expressions for audience segments.
+  repeated AudienceSegmentTargeting audience_segment_targetings = 2
+      [(google.api.field_behavior) = OPTIONAL];
+
+  // Optional. Leaf targeting expressions for cms metadata.
+  repeated CmsMetadataTargeting cms_metadata_targetings = 3
+      [(google.api.field_behavior) = OPTIONAL];
 }
 
 // Represents targeting for custom key/values. The values are ORed together.
@@ -270,6 +467,43 @@ message CustomTargetingLiteral {
   ];
 }
 
+// Represents targeting for audience segments. The values are combined in a
+// logical `OR`.
+message AudienceSegmentTargeting {
+  // Whether this expression is negatively targeted, meaning it matches
+  // ad requests that exclude the below values.
+  optional bool negative = 1;
+
+  // Optional. The targeted audience segments.
+  //
+  // This is either the resource name of a first-party audience segment or an
+  // alias to the effective third-party audience segment. Third-party audience
+  // segment resource names containing `~direct` or `~global` will be normalized
+  // by the server. For example, `networks/1234/audienceSegments/4567~direct`
+  // will be normalized to `networks/1234/audienceSegments/4567`.
+  repeated string audience_segments = 3 [
+    (google.api.field_behavior) = OPTIONAL,
+    (google.api.resource_reference) = {
+      type: "admanager.googleapis.com/AudienceSegment"
+    }
+  ];
+}
+
+// Represents targeting for CMS metadata. The values are ORed together.
+message CmsMetadataTargeting {
+  // Whether this expression is negatively targeted, meaning it matches
+  // ad requests that exclude the below values.
+  optional bool negative = 1;
+
+  // Optional. The resource names of the targeted CMS metadata values.
+  repeated string cms_metadata_values = 3 [
+    (google.api.field_behavior) = OPTIONAL,
+    (google.api.resource_reference) = {
+      type: "admanager.googleapis.com/CmsMetadataValue"
+    }
+  ];
+}
+
 // User Domain Targeting
 message UserDomainTargeting {
   // Optional. A list of user domains that should be targeted/included.
@@ -326,3 +560,80 @@ message DataSegmentTargeting {
   bool has_data_segment_targeting = 2
       [(google.api.field_behavior) = OUTPUT_ONLY];
 }
+
+// Content Targeting
+//
+// Targeted/excluded content entities and bundles.
+//
+message ContentTargeting {
+  // Optional. The resource names of the
+  // [Content][google.ads.admanager.v1.Content] that should be
+  // targeted/included.
+  repeated string targeted_content = 5 [
+    (google.api.field_behavior) = OPTIONAL,
+    (google.api.resource_reference) = {
+      type: "admanager.googleapis.com/Content"
+    }
+  ];
+
+  // Optional. The resource names of the
+  // [Content][google.ads.admanager.v1.Content] that should be
+  // excluded.
+  repeated string excluded_content = 6 [
+    (google.api.field_behavior) = OPTIONAL,
+    (google.api.resource_reference) = {
+      type: "admanager.googleapis.com/Content"
+    }
+  ];
+
+  // Optional. The resource names of the
+  // [ContentBundles][google.ads.admanager.v1.ContentBundle] that
+  // should be targeted/included.
+  repeated string targeted_content_bundles = 7 [
+    (google.api.field_behavior) = OPTIONAL,
+    (google.api.resource_reference) = {
+      type: "admanager.googleapis.com/ContentBundle"
+    }
+  ];
+
+  // Optional. The resource names of the
+  // [ContentBundles][google.ads.admanager.v1.ContentBundle] that
+  // should be excluded.
+  repeated string excluded_content_bundles = 8 [
+    (google.api.field_behavior) = OPTIONAL,
+    (google.api.resource_reference) = {
+      type: "admanager.googleapis.com/ContentBundle"
+    }
+  ];
+}
+
+// Mobile Application Targeting
+message MobileApplicationTargeting {
+  // The mobile application targeting.
+  oneof targeting {
+    // Optional. The targeted/excluded first-party mobile applications.
+    FirstPartyMobileApplicationTargeting first_party_targeting = 1
+        [(google.api.field_behavior) = OPTIONAL];
+  }
+}
+
+// First-party mobile application targeting.
+message FirstPartyMobileApplicationTargeting {
+  // Optional. The resource names of the first-party applications that should be
+  // targeted.
+  repeated string targeted_applications = 3 [
+    (google.api.field_behavior) = OPTIONAL,
+    (google.api.resource_reference) = {
+      type: "admanager.googleapis.com/Application"
+    }
+  ];
+
+  // Optional. The resource names of the first-party applications that should be
+  // excluded.
+  repeated string excluded_applications = 4 [
+    (google.api.field_behavior) = OPTIONAL,
+    (google.api.resource_reference) = {
+      type: "admanager.googleapis.com/Application"
+    }
+  ];
+}

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

@@ -119,7 +119,7 @@ message ListTaxonomyCategoriesResponse {
   // 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
+  // `total_size` won't 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`.

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

@@ -36,6 +36,9 @@ message TaxonomyTypeEnum {
     // The IAB Audience Taxonomy v1.1.
     TAXONOMY_IAB_AUDIENCE_1_1 = 3;
 
+    // The IAB Content Taxonomy v1.0.
+    TAXONOMY_IAB_CONTENT_1_0 = 8;
+
     // The IAB Content Taxonomy v2.1.
     TAXONOMY_IAB_CONTENT_2_1 = 4;
 

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

@@ -0,0 +1,62 @@
+// Copyright 2025 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 = "TeamEnumsProto";
+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
+// [TeamStatus][google.ads.admanager.v1.TeamStatusEnum.TeamStatus]
+message TeamStatusEnum {
+  // Represents the status of a team, whether it is active or inactive.
+  enum TeamStatus {
+    // Default value. This value is unused.
+    TEAM_STATUS_UNSPECIFIED = 0;
+
+    // The status of an active team.
+    ACTIVE = 1;
+
+    // The status of an inactive team.
+    INACTIVE = 2;
+  }
+}
+
+// Wrapper message for
+// [TeamAccessType][google.ads.admanager.v1.TeamAccessTypeEnum.TeamAccessType]
+message TeamAccessTypeEnum {
+  // Represents the types of team access supported for orders.
+  enum TeamAccessType {
+    // Default value. This value is unused.
+    TEAM_ACCESS_TYPE_UNSPECIFIED = 0;
+
+    // The level of access in which team members can't view or edit a team's
+    // orders.
+    NONE = 1;
+
+    // The level of access in which team members can only view a team's orders.
+    READ_ONLY = 2;
+
+    // The level of access in which team members can view and edit a team's
+    // orders.
+    READ_WRITE = 3;
+  }
+}

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

@@ -16,6 +16,7 @@ syntax = "proto3";
 
 package google.ads.admanager.v1;
 
+import "google/ads/admanager/v1/team_enums.proto";
 import "google/api/field_behavior.proto";
 import "google/api/resource.proto";
 
@@ -39,4 +40,33 @@ message Team {
   // Identifier. The resource name of the `Team`.
   // Format: `networks/{network_code}/teams/{team_id}`
   string name = 1 [(google.api.field_behavior) = IDENTIFIER];
+
+  // Required. The name of the Team. This value has a maximum length of 127
+  // characters.
+  optional string display_name = 3 [(google.api.field_behavior) = REQUIRED];
+
+  // Optional. The description of the Team. This value has a maximum length of
+  // 255 characters.
+  optional string description = 4 [(google.api.field_behavior) = OPTIONAL];
+
+  // Output only. The status of the Team. This value determines the visibility
+  // of the team in the UI.
+  optional TeamStatusEnum.TeamStatus status = 5
+      [(google.api.field_behavior) = OUTPUT_ONLY];
+
+  // Optional. Whether or not users on this team have access to all companies.
+  // If this value is true, then an error will be thrown if an attempt is made
+  // to associate this team with a Company.
+  optional bool all_companies_access = 6
+      [(google.api.field_behavior) = OPTIONAL];
+
+  // Optional. Whether or not users on this team have access to all inventory.
+  // If this value is true, then an error will be thrown if an attempt is made
+  // to associate this team with an AdUnit.
+  optional bool all_inventory_access = 7
+      [(google.api.field_behavior) = OPTIONAL];
+
+  // Optional. The default access to orders for users on this team.
+  optional TeamAccessTypeEnum.TeamAccessType access_type = 8
+      [(google.api.field_behavior) = OPTIONAL];
 }