Skip to content

Commit 42c22f5

Browse files
feat(realtimebidding): update the API
#### realtimebidding:v1 The following keys were added: - schemas.Creative.properties.declaredRestrictedCategories.deprecated The following keys were changed: - description - schemas.Bidder.properties.bypassNonguaranteedDealsPretargeting.description - schemas.CreativeServingDecision.properties.detectedCategories.description - schemas.CreativeServingDecision.properties.detectedCategoriesTaxonomy.enum - schemas.CreativeServingDecision.properties.detectedCategoriesTaxonomy.enumDescriptions
1 parent 6ca2030 commit 42c22f5

File tree

3 files changed

+11
-8
lines changed

3 files changed

+11
-8
lines changed

discovery/realtimebidding-v1.json

Lines changed: 7 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -12,7 +12,7 @@
1212
"baseUrl": "https://realtimebidding.googleapis.com/",
1313
"batchPath": "batch",
1414
"canonicalName": "Real-time Bidding",
15-
"description": "Allows external bidders to manage their RTB integration with Google. This includes managing bidder endpoints, QPS quotas, configuring what ad inventory to receive via pretargeting, submitting creatives for verification, and accessing creative metadata such as approval status.",
15+
"description": "Allows external bidders to manage their RTB integration with Google. This includes managing bidder endpoints, QPS quotas, configuring what ad inventory to receive with pretargeting, submitting creatives for verification, and accessing creative metadata such as approval status.",
1616
"discoveryVersion": "v1",
1717
"documentationLink": "https://developers.google.com/authorized-buyers/apis/realtimebidding/reference/rest/",
1818
"fullyEncodeReservedExpansion": true,
@@ -1305,7 +1305,7 @@
13051305
}
13061306
}
13071307
},
1308-
"revision": "20240930",
1308+
"revision": "20250306",
13091309
"rootUrl": "https://realtimebidding.googleapis.com/",
13101310
"schemas": {
13111311
"ActivatePretargetingConfigRequest": {
@@ -1529,7 +1529,7 @@
15291529
"id": "Bidder",
15301530
"properties": {
15311531
"bypassNonguaranteedDealsPretargeting": {
1532-
"description": "Output only. An option to bypass pretargeting for private auctions and preferred deals. When true, bid requests from these nonguaranteed deals will always be sent. When false, bid requests will be subject to regular pretargeting configurations. Programmatic Guaranteed deals will always be sent to the bidder, regardless of the value for this flag. Auction packages are not impacted by this value and are subject to the regular pretargeting configurations.",
1532+
"description": "Output only. An option to bypass pretargeting for private auctions and preferred deals. When true, bid requests from these nonguaranteed deals will always be sent. When false, bid requests will be subject to regular pretargeting configurations. Programmatic Guaranteed deals will always be sent to the bidder, regardless of the value for this option. Auction packages are not impacted by this value and are subject to the regular pretargeting configurations.",
15331533
"readOnly": true,
15341534
"type": "boolean"
15351535
},
@@ -1764,6 +1764,7 @@
17641764
"type": "array"
17651765
},
17661766
"declaredRestrictedCategories": {
1767+
"deprecated": true,
17671768
"description": "All declared restricted categories for the ads that may be shown from this creative. Can be used to filter the response of the creatives.list method.",
17681769
"items": {
17691770
"enum": [
@@ -1970,7 +1971,7 @@
19701971
"type": "array"
19711972
},
19721973
"detectedCategories": {
1973-
"description": "Output only. IDs of the detected categories, if any. The taxonomy in which the categories are expressed is specified by the detected_categories_taxonomy field. Can be used to filter the response of the creatives.list method.",
1974+
"description": "Output only. IDs of the detected categories. The taxonomy in which the categories are expressed is specified by the detected_categories_taxonomy field. Use this in conjunction with BidRequest.bcat to avoid bidding on impressions where a given ad category is blocked, or to troubleshoot filtered bids. Can be used to filter the response of the creatives.list method.",
19741975
"items": {
19751976
"type": "string"
19761977
},
@@ -1981,10 +1982,12 @@
19811982
"description": "Output only. The taxonomy in which the detected_categories field is expressed.",
19821983
"enum": [
19831984
"AD_CATEGORY_TAXONOMY_UNSPECIFIED",
1985+
"GOOGLE_AD_CATEGORY_TAXONOMY",
19841986
"IAB_CONTENT_1_0"
19851987
],
19861988
"enumDescriptions": [
19871989
"Default value that should never be used.",
1990+
"Google ad categories taxonomy, including product categories and sensitive categories. Find the category lists at https://developers.google.com/authorized-buyers/rtb/data#reference-data",
19881991
"IAB Content Taxonomy 1.0. See https://github.com/InteractiveAdvertisingBureau/Taxonomies/blob/main/Content%20Taxonomies/Content%20Taxonomy%201.0.tsv for more details."
19891992
],
19901993
"readOnly": true,

src/apis/realtimebidding/README.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -2,7 +2,7 @@
22

33
# realtimebidding
44

5-
> Allows external bidders to manage their RTB integration with Google. This includes managing bidder endpoints, QPS quotas, configuring what ad inventory to receive via pretargeting, submitting creatives for verification, and accessing creative metadata such as approval status.
5+
> Allows external bidders to manage their RTB integration with Google. This includes managing bidder endpoints, QPS quotas, configuring what ad inventory to receive with pretargeting, submitting creatives for verification, and accessing creative metadata such as approval status.
66
77
## Installation
88

src/apis/realtimebidding/v1.ts

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -102,7 +102,7 @@ export namespace realtimebidding_v1 {
102102
/**
103103
* Real-time Bidding API
104104
*
105-
* Allows external bidders to manage their RTB integration with Google. This includes managing bidder endpoints, QPS quotas, configuring what ad inventory to receive via pretargeting, submitting creatives for verification, and accessing creative metadata such as approval status.
105+
* Allows external bidders to manage their RTB integration with Google. This includes managing bidder endpoints, QPS quotas, configuring what ad inventory to receive with pretargeting, submitting creatives for verification, and accessing creative metadata such as approval status.
106106
*
107107
* @example
108108
* ```js
@@ -261,7 +261,7 @@ export namespace realtimebidding_v1 {
261261
*/
262262
export interface Schema$Bidder {
263263
/**
264-
* Output only. An option to bypass pretargeting for private auctions and preferred deals. When true, bid requests from these nonguaranteed deals will always be sent. When false, bid requests will be subject to regular pretargeting configurations. Programmatic Guaranteed deals will always be sent to the bidder, regardless of the value for this flag. Auction packages are not impacted by this value and are subject to the regular pretargeting configurations.
264+
* Output only. An option to bypass pretargeting for private auctions and preferred deals. When true, bid requests from these nonguaranteed deals will always be sent. When false, bid requests will be subject to regular pretargeting configurations. Programmatic Guaranteed deals will always be sent to the bidder, regardless of the value for this option. Auction packages are not impacted by this value and are subject to the regular pretargeting configurations.
265265
*/
266266
bypassNonguaranteedDealsPretargeting?: boolean | null;
267267
/**
@@ -441,7 +441,7 @@ export namespace realtimebidding_v1 {
441441
*/
442442
detectedAttributes?: string[] | null;
443443
/**
444-
* Output only. IDs of the detected categories, if any. The taxonomy in which the categories are expressed is specified by the detected_categories_taxonomy field. Can be used to filter the response of the creatives.list method.
444+
* Output only. IDs of the detected categories. The taxonomy in which the categories are expressed is specified by the detected_categories_taxonomy field. Use this in conjunction with BidRequest.bcat to avoid bidding on impressions where a given ad category is blocked, or to troubleshoot filtered bids. Can be used to filter the response of the creatives.list method.
445445
*/
446446
detectedCategories?: string[] | null;
447447
/**

0 commit comments

Comments
 (0)