Skip to content
Merged
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
  •  
  •  
  •  
5 changes: 3 additions & 2 deletions librarian.yaml
Original file line number Diff line number Diff line change
Expand Up @@ -16,8 +16,8 @@ version: v0.27.1
repo: googleapis/google-cloud-node
sources:
googleapis:
commit: 2b625c91510a2e8320a778bc88af8b65bc4a19a2
sha256: 503314c3f49e4de70138d35d5b9b12cca0c74d7c5ba34380895440b83aa45b94
commit: e82c753169134e7eb263394d5e77ba6ec28596c2
sha256: 4427fc14f395abf744386f8b5a21158bc81b2cff57eb29dbf873f040998afbdc
tools:
pnpm:
- name: gapic-generator-typescript
Expand Down Expand Up @@ -2251,6 +2251,7 @@ libraries:
- src/util/storage_control_utils.ts
- src/util/uber_client_builder.ts
- test/storage_control_compatibility.ts
skip_generate: true
nodejs:
default_version: v2
package_name: '@google-cloud/storage-control'
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -39,7 +39,7 @@ service AdBreakService {
"https://www.googleapis.com/auth/admanager,"
"https://www.googleapis.com/auth/admanager.readonly";

// API to retrieve an `AdBreak` object.
// Retrieves an `AdBreak` object.
//
// Query an ad break by its resource name or custom asset key. Check the
// resource's `breakState` field to determine its state.
Expand All @@ -56,7 +56,7 @@ service AdBreakService {
option (google.api.method_signature) = "name";
}

// API to retrieve a list of `AdBreak` objects.
// Lists `AdBreak` objects.
//
// By default, when no `orderBy` query parameter is specified, ad breaks are
// ordered reverse chronologically. However, ad breaks with a 'breakState' of
Expand All @@ -74,7 +74,7 @@ service AdBreakService {
option (google.api.method_signature) = "parent";
}

// API to create an `AdBreak` object.
// Creates an `AdBreak` object.
//
// Informs DAI of an upcoming ad break for a live stream event, with an
// optional expected start time. DAI will begin decisioning ads for the break
Expand Down Expand Up @@ -113,7 +113,7 @@ service AdBreakService {
option (google.api.method_signature) = "parent,ad_break";
}

// API to update an `AdBreak` object.
// Updates an `AdBreak` object.
//
// Modify an ad break when its state is
// [`SCHEDULED`][google.ads.admanager.v1.AdBreakStateEnum.AdBreakState.SCHEDULED].
Expand All @@ -125,7 +125,7 @@ service AdBreakService {
option (google.api.method_signature) = "ad_break,update_mask";
}

// API to delete an `AdBreak` object.
// Deletes an `AdBreak` object.
//
// Deletes and cancels an incomplete ad break, mitigating the need to wait
// for the current break to serve before recreating an ad break. You can
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -41,7 +41,7 @@ service AdReviewCenterAdService {
"https://www.googleapis.com/auth/admanager,"
"https://www.googleapis.com/auth/admanager.readonly";

// API to search for AdReviewCenterAds.
// Searches for AdReviewCenterAds.
rpc SearchAdReviewCenterAds(SearchAdReviewCenterAdsRequest)
returns (SearchAdReviewCenterAdsResponse) {
option (google.api.http) = {
Expand All @@ -50,7 +50,7 @@ service AdReviewCenterAdService {
option (google.api.method_signature) = "parent";
}

// API to batch allow AdReviewCenterAds.
// Batch allows AdReviewCenterAds.
// This method supports partial success. Some operations may succeed while
// others fail. Callers should check the failedRequests field in the response
// to determine which operations failed.
Expand All @@ -67,7 +67,7 @@ service AdReviewCenterAdService {
};
}

// API to batch block AdReviewCenterAds.
// Batch blocks AdReviewCenterAds.
// This method supports partial success. Some operations may succeed while
// others fail. Callers should check the failedRequests field in the response
// to determine which operations failed.
Expand Down
Original file line number Diff line number Diff line change
@@ -0,0 +1,61 @@
// 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 = "AdRuleEnumsProto";
option java_package = "com.google.ads.admanager.v1";
option php_namespace = "Google\\Ads\\AdManager\\V1";
option ruby_package = "Google::Ads::AdManager::V1";

message AdRuleStatusEnum {
// Represents the status of ad rules and ad rule slots.
enum AdRuleStatus {
// Default value. This value is unused.
AD_RULE_STATUS_UNSPECIFIED = 0;

// Created and ready to be served. Is user-visible.
ACTIVE = 1;

// Marked as deleted, not user-visible.
DELETED = 2;

// Inactive, not user-visible.
INACTIVE = 5;
}
}

// Wrapper message for
// [AdRuleFrequencyCapBehavior][google.ads.admanager.v1.AdRuleFrequencyCapBehaviorEnum.AdRuleFrequencyCapBehavior]
message AdRuleFrequencyCapBehaviorEnum {
// Types of behavior for frequency caps within ad rules.
enum AdRuleFrequencyCapBehavior {
// Default value. This value is unused.
AD_RULE_FREQUENCY_CAP_BEHAVIOR_UNSPECIFIED = 0;

// Defer frequency cap decisions to the next ad rule in priority order.
DEFER = 1;

// Turn off all frequency caps.
TURN_OFF = 2;

// Turn on at least one of the frequency caps.
TURN_ON = 3;
}
}
Original file line number Diff line number Diff line change
@@ -0,0 +1,168 @@
// 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_rule_enums.proto";
import "google/ads/admanager/v1/ad_rule_slot_behavior_enum.proto";
import "google/ads/admanager/v1/ad_rule_slot_bumper_enum.proto";
import "google/ads/admanager/v1/ad_rule_slot_midroll_frequency_type_enum.proto";
import "google/ads/admanager/v1/targeting.proto";
import "google/api/field_behavior.proto";
import "google/api/resource.proto";
import "google/protobuf/duration.proto";
import "google/protobuf/timestamp.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 = "AdRuleMessagesProto";
option java_package = "com.google.ads.admanager.v1";
option php_namespace = "Google\\Ads\\AdManager\\V1";
option ruby_package = "Google::Ads::AdManager::V1";

// An AdRule contains data that the ad server will use to generate a playlist of
// video ads.
message AdRule {
option (google.api.resource) = {
type: "admanager.googleapis.com/AdRule"
pattern: "networks/{network_code}/adRules/{ad_rule}"
plural: "adRules"
singular: "adRule"
};

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

// Required. The unique name of the AdRule. This attribute is required to
// create an ad rule and has a maximum length of 255 characters.
optional string display_name = 2 [(google.api.field_behavior) = REQUIRED];

// Optional. The priority of the AdRule. This attribute is required and can
// range from 1 to 1000, with 1 being the highest possible priority.
//
// Changing an ad rule's priority can affect the priorities of other ad rules.
// For example,
// increasing an ad rule's priority from 5 to 1 will shift the ad rules that
// were previously in
// priority positions 1 through 4 down one.
optional int32 priority = 3 [(google.api.field_behavior) = OPTIONAL];

// Required. The start time of the AdRule. This attribute is required and must
// be a date in the future for new ad rules.
optional google.protobuf.Timestamp start_time = 13
[(google.api.field_behavior) = REQUIRED];

// Optional. This end time of the AdRule. This attribute is required
// unless
// [end_time_unlimited][google.ads.admanager.v1.AdRule.end_time_unlimited] is
// set to true. If specified, it must be after the
// [start_time][google.ads.admanager.v1.AdRule.start_time].
optional google.protobuf.Timestamp end_time = 14
[(google.api.field_behavior) = OPTIONAL];

// Optional. Specifies whether or not the AdRule has an end time. This
// attribute is optional and defaults to false.
optional bool end_time_unlimited = 15
[(google.api.field_behavior) = OPTIONAL];

// Output only. The AdRuleStatus of the AdRule. This attribute is read-only
// and defaults to [AdRuleStatus.INACTIVE][].
optional AdRuleStatusEnum.AdRuleStatus status = 4
[(google.api.field_behavior) = OUTPUT_ONLY];

// Optional. The FrequencyCapBehavior of the AdRule. This attribute is
// optional and defaults to [FrequencyCapBehavior.DEFER][].
optional AdRuleFrequencyCapBehaviorEnum.AdRuleFrequencyCapBehavior
frequency_cap_behavior = 5 [(google.api.field_behavior) = OPTIONAL];

// Optional. This AdRule object's frequency cap for the maximum impressions
// per stream. This attribute is optional and defaults to 0.
optional int32 max_impressions_per_line_item_per_stream = 6
[(google.api.field_behavior) = OPTIONAL];

// Optional. This AdRule object's frequency cap for the maximum impressions
// per pod. This attribute is optional and defaults to 0.
optional int32 max_impressions_per_line_item_per_pod = 7
[(google.api.field_behavior) = OPTIONAL];

// Required. This AdRule object's pre-roll slot. This attribute is required.
optional AdRuleSlot preroll = 8 [(google.api.field_behavior) = REQUIRED];

// Required. This AdRule object's video mid-roll slots. This attribute is
// required, and there must be at least one mid-roll.
repeated AdRuleSlot midrolls = 9 [(google.api.field_behavior) = REQUIRED];

// Required. This AdRule object's post-roll slot. This attribute is required.
optional AdRuleSlot postroll = 10 [(google.api.field_behavior) = REQUIRED];

// Required. The targeting of the `AdRule`.
optional Targeting targeting = 11 [(google.api.field_behavior) = REQUIRED];
}

// Simple object representing an ad slot within an AdRule. Ad rule slots contain
// information about the types/number of ads to display, as well as additional
// information on how the ad server will generate playlists.
message AdRuleSlot {
// Optional. The AdRuleSlotBehavior for video ads for this slot. This
// attribute is optional and defaults to [AdRuleSlotBehavior.DEFER][].
// Indicates whether video ads are allowed for this slot, or if the decision
// is deferred to alower-priority ad rule.
optional AdRuleSlotBehaviorEnum.AdRuleSlotBehavior slot_behavior = 1
[(google.api.field_behavior) = OPTIONAL];

// Optional. The maximum duration in milliseconds of video ads within this
// slot. This attribute is optional and defaults to 0.
optional google.protobuf.Duration max_video_ad_duration = 4
[(google.api.field_behavior) = OPTIONAL];

// Optional. The frequency type for video ads in this ad rule slot. This
// attribute is required for mid-rolls, but if this is not a mid-roll, the
// value is set to [AdRuleSlotMidrollFrequencyType.NONE][].
optional AdRuleSlotMidrollFrequencyTypeEnum.AdRuleSlotMidrollFrequencyType
video_midroll_frequency_type = 5 [(google.api.field_behavior) = OPTIONAL];

// Optional. The mid-roll frequency of this ad rule slot for video ads. This
// attribute is required for mid-rolls, but if MidrollFrequencyType is set to
// [AdRuleSlotMidrollFrequencyType.NONE][], this value should be ignored. For
// example, if this slot has a frequency type of
// [AdRuleSlotMidrollFrequencyType.EVERY_N_SECONDS][] and
// # videoMidrollFrequency = "60", this would mean "play a mid-roll every 60
//
// seconds."
optional string video_midroll_frequency = 6
[(google.api.field_behavior) = OPTIONAL];

// Optional. The AdRuleSlotBumper for this slot. This attribute is optional
// and defaults to [AdRuleSlotBumper.NONE][].
optional AdRuleSlotBumperEnum.AdRuleSlotBumper bumper = 7
[(google.api.field_behavior) = OPTIONAL];

// Optional. The maximum duration of bumper ads within this slot. This
// attribute is optional and defaults to 0.
optional google.protobuf.Duration max_bumper_duration = 8
[(google.api.field_behavior) = OPTIONAL];

// Optional. The maximum pod duration for this slot. This attribute is
// optional and defaults to 0.
optional google.protobuf.Duration max_pod_duration = 9
[(google.api.field_behavior) = OPTIONAL];

// Optional. The maximum number of ads allowed in a pod in this slot. This
// attribute is optional and defaults to 0.
optional int32 pod_max_ad_count = 10 [(google.api.field_behavior) = OPTIONAL];
}
Loading
Loading