镜像站点 · 本页由第三方 GitHub 只读镜像提供,非 GitHub 官方站点,不接受任何登录或凭据输入。前往 github.com
Skip to content
Closed
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
The table of contents is too big for display.
Diff view
Diff view
  •  
  •  
  •  
4 changes: 2 additions & 2 deletions librarian.yaml
Original file line number Diff line number Diff line change
Expand Up @@ -16,8 +16,8 @@ version: v0.42.0
repo: googleapis/google-cloud-node
sources:
googleapis:
commit: 00ff8fcb95cafbac573cc449b0d1a039244f1b4b
sha256: 4adc70162aadcea34de8e9ec269851bca7486fa8dca31d70dc43cdeb1e7a2617
commit: 5cbe99334de40143f64b32e805dd8cfe38ef11d5
sha256: d7703651093e08c99568de99792c2372cb595ab739d01dd6d75254563ab4d7bf
tools:
pnpm:
- name: gapic-generator-typescript
Expand Down
Original file line number Diff line number Diff line change
@@ -0,0 +1,43 @@
// 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 = "AdBreakOptimizationTypeEnumProto";
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
// [AdBreakOptimizationType][google.ads.admanager.v1.AdBreakOptimizationTypeEnum.AdBreakOptimizationType]
message AdBreakOptimizationTypeEnum {
// Defines how non-required ad spots within in an ad break are filled.
enum AdBreakOptimizationType {
// Default value. This value is unused.
AD_BREAK_OPTIMIZATION_TYPE_UNSPECIFIED = 0;

// Non-required ad spots within the ad break will be filled according to the
// fill order direction, potentially reducing revenue for the break.
POSITION = 1;

// Non-required ad spots within the ad break will be filled using a revenue
// optimizing algorithm.
REVENUE = 2;
}
}
Original file line number Diff line number Diff line change
Expand Up @@ -64,7 +64,7 @@ message AdReviewCenterAd {
manual_review_statuses = 6 [(google.api.field_behavior) = OUTPUT_ONLY];

// Output only. The preview URL that can be embedded or accessed directly
// which will present the rendered contents of the ad. (This URL expires 72
// hours after being retrieved.).
// which will present the rendered contents of the ad. This URL expires 72
// hours after being retrieved.
optional string preview_url = 5 [(google.api.field_behavior) = OUTPUT_ONLY];
}
Original file line number Diff line number Diff line change
@@ -0,0 +1,45 @@
// 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 = "AdRuleFillOrderDirectionEnumProto";
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
// [AdRuleFillOrderDirection][google.ads.admanager.v1.AdRuleFillOrderDirectionEnum.AdRuleFillOrderDirection]
message AdRuleFillOrderDirectionEnum {
// Defines the fill order direction of ad breaks with
// AdBreakOptimizationType.POSITION.
enum AdRuleFillOrderDirection {
// Default value. This value is unused.
AD_RULE_FILL_ORDER_DIRECTION_UNSPECIFIED = 0;

// A break template should be filled from edge to center.
EDGE_TO_CENTER = 1;

// A break template should be filled from left to right.
LEFT_TO_RIGHT = 2;

// A break template should be filled from right to left.
RIGHT_TO_LEFT = 3;
}
}
Original file line number Diff line number Diff line change
@@ -0,0 +1,46 @@
// 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 = "AdSpotFillTypeEnumProto";
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
// [AdSpotFillType][google.ads.admanager.v1.AdSpotFillTypeEnum.AdSpotFillType]
message AdSpotFillTypeEnum {
// The different options for how ad spots are filled. Only some allocations of
// ads to subpods produce a valid final pod.
enum AdSpotFillType {
// Default value. This value is unused.
AD_SPOT_FILL_TYPE_UNSPECIFIED = 0;

// The ad spot may only contain an ad when all ad spots with higher fill
// priority are "satisfied".
CONDITIONAL = 1;

// The ad spot is always "satisfied", whether empty or nonempty.
OPTIONAL = 2;

// If this ad spot is empty, the overall pod is invalid.
REQUIRED = 3;
}
}
Original file line number Diff line number Diff line change
Expand Up @@ -54,6 +54,26 @@ service AudienceSegmentService {
option (google.api.method_signature) = "parent";
}

// Creates an `AudienceSegment` object.
rpc CreateAudienceSegment(CreateAudienceSegmentRequest)
returns (AudienceSegment) {
option (google.api.http) = {
post: "/v1/{parent=networks/*}/audienceSegments"
body: "audience_segment"
};
option (google.api.method_signature) = "parent,audience_segment";
}

// Creates `AudienceSegment` objects.
rpc BatchCreateAudienceSegments(BatchCreateAudienceSegmentsRequest)
returns (BatchCreateAudienceSegmentsResponse) {
option (google.api.http) = {
post: "/v1/{parent=networks/*}/audienceSegments:batchCreate"
body: "*"
};
option (google.api.method_signature) = "parent,requests";
}

// Activates `AudienceSegment` objects.
rpc BatchActivateAudienceSegments(BatchActivateAudienceSegmentsRequest)
returns (BatchActivateAudienceSegmentsResponse) {
Expand Down Expand Up @@ -197,6 +217,47 @@ message ListAudienceSegmentsResponse {
int32 total_size = 3;
}

// Request object for `CreateAudienceSegment` method.
message CreateAudienceSegmentRequest {
// Required. The parent resource where this `AudienceSegment` 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 `AudienceSegment` to create. Only first-party segments can be
// created.
AudienceSegment audience_segment = 2 [(google.api.field_behavior) = REQUIRED];
}

// Request object for `BatchCreateAudienceSegments` method.
message BatchCreateAudienceSegmentsRequest {
// Required. The parent resource where `AudienceSegments` will be created.
// Format: `networks/{network_code}`
// The parent field in the CreateAudienceSegmentRequest must match this
// field.
string parent = 1 [
(google.api.field_behavior) = REQUIRED,
(google.api.resource_reference) = {
type: "admanager.googleapis.com/Network"
}
];

// Required. The `AudienceSegment` objects to create.
// A maximum of 100 objects can be created in a batch.
repeated CreateAudienceSegmentRequest requests = 2
[(google.api.field_behavior) = REQUIRED];
}

// Response object for `BatchCreateAudienceSegments` method.
message BatchCreateAudienceSegmentsResponse {
// The `AudienceSegment` objects created.
repeated AudienceSegment audience_segments = 1;
}

// Request message for `BatchActivateAudienceSegments` method.
message BatchActivateAudienceSegmentsRequest {
// Required. Format: `networks/{network_code}`
Expand Down
Original file line number Diff line number Diff line change
@@ -0,0 +1,99 @@
// 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;

import "google/ads/admanager/v1/ad_break_optimization_type_enum.proto";
import "google/ads/admanager/v1/ad_rule_fill_order_direction_enum.proto";
import "google/ads/admanager/v1/ad_spot_fill_type_enum.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 = "BreakTemplateMessagesProto";
option java_package = "com.google.ads.admanager.v1";
option php_namespace = "Google\\Ads\\AdManager\\V1";
option ruby_package = "Google::Ads::AdManager::V1";

// A `BreakTemplate` defines what kinds of ads show at which positions within a
// pod. Break templates are made up of `AdSpot` objects. A break template must
// have a single ad spot that has `flexible` set to `true`.
message BreakTemplate {
option (google.api.resource) = {
type: "admanager.googleapis.com/BreakTemplate"
pattern: "networks/{network_code}/breakTemplates/{break_template}"
plural: "breakTemplates"
singular: "breakTemplate"
};

// Identifier. The resource name of the `BreakTemplate`.
// Format: `networks/{network_code}/breakTemplates/{break_template_id}`
string name = 1 [(google.api.field_behavior) = IDENTIFIER];

// Optional. Whether this is a custom template. Custom templates get created
// outside of the ad rule workflow and can be referenced in ad tags. Only
// custom templates can have names and display names.
optional bool custom_template = 2 [(google.api.field_behavior) = OPTIONAL];

// Optional. Name of the `BreakTemplate`. The name is case insensitive and can
// be referenced in ad tags. This value is required if `customTemplate` is
// true, and cannot be set otherwise. You can use alphanumeric characters and
// symbols other than the following: ", ', =, !, +, #, ,, ~, ;, ^, (, ), <, >,
// [, ], the white space character.
optional string ad_tag_name = 8 [(google.api.field_behavior) = OPTIONAL];

// Optional. Descriptive name for the BreakTemplate. This value is optional if
// customTemplate is true, and cannot be set otherwise.
optional string display_name = 4 [(google.api.field_behavior) = OPTIONAL];

// Optional. The list of the `BreakTemplateMember` objects in the order in
// which they should appear in the ad pod. Each `BreakTemplateMember` has a
// reference to an `AdSpot`, which defines what kinds of ads can appear at
// that position, as well as other metadata that defines how each ad spot
// should be filled.
repeated BreakTemplateMember break_template_members = 5
[(google.api.field_behavior) = OPTIONAL];

// Optional. The optimization type of the pod. This field is optional and
// defaults to [AdBreakOptimizationType.REVENUE][].
optional AdBreakOptimizationTypeEnum.AdBreakOptimizationType
ad_break_optimization_type = 6 [(google.api.field_behavior) = OPTIONAL];

// Optional. The fill order direction of the pod. This value is required if
// `adBreakOptimizationType` is equal to
// [AdBreakOptimizationType.POSITION][] and should otherwise be unset.
optional AdRuleFillOrderDirectionEnum.AdRuleFillOrderDirection
fill_order_direction_type = 7 [(google.api.field_behavior) = OPTIONAL];
}

// A building block of a pod template.
message BreakTemplateMember {
// Required. The ID of the `AdSpot` that has the settings about what kinds of
// ads can appear in this position of the `BreakTemplate`.
optional string ad_spot = 1 [
(google.api.field_behavior) = REQUIRED,
(google.api.resource_reference) = {
type: "admanager.googleapis.com/AdSpot"
}
];

// Optional. The behavior for how the `AdSpot` should be filled in the context
// of the `BreakTemplate`.
optional AdSpotFillTypeEnum.AdSpotFillType ad_spot_fill_type = 2
[(google.api.field_behavior) = OPTIONAL];
}
Loading
Loading