chore: update docs/dyn , add static discovery files to discovery_cache/documents (#1111)
This PR was generated using Autosynth. :rainbow:
Synth log will be available here:
https://source.cloud.google.com/results/invocations/78f53313-0c78-4a29-8841-f031665a4c6a/targets
- [ ] To automatically regenerate this PR, check this box.
Source-Link: https://github.com/googleapis/synthtool/commit/c2de32114ec484aa708d32012d1fa8d75232daf5
diff --git a/googleapiclient/discovery_cache/documents/adexchangebuyer2.v2beta1.json b/googleapiclient/discovery_cache/documents/adexchangebuyer2.v2beta1.json
new file mode 100644
index 0000000..38fa70e
--- /dev/null
+++ b/googleapiclient/discovery_cache/documents/adexchangebuyer2.v2beta1.json
@@ -0,0 +1,5960 @@
+{
+ "mtlsRootUrl": "https://adexchangebuyer.mtls.googleapis.com/",
+ "title": "Ad Exchange Buyer API II",
+ "icons": {
+ "x16": "http://www.google.com/images/icons/product/search-16.gif",
+ "x32": "http://www.google.com/images/icons/product/search-32.gif"
+ },
+ "resources": {
+ "accounts": {
+ "resources": {
+ "proposals": {
+ "methods": {
+ "create": {
+ "request": {
+ "$ref": "Proposal"
+ },
+ "flatPath": "v2beta1/accounts/{accountId}/proposals",
+ "id": "adexchangebuyer2.accounts.proposals.create",
+ "response": {
+ "$ref": "Proposal"
+ },
+ "description": "Create the given proposal. Each created proposal and any deals it contains are assigned a unique ID by the server.",
+ "httpMethod": "POST",
+ "scopes": [
+ "https://www.googleapis.com/auth/adexchange.buyer"
+ ],
+ "parameters": {
+ "accountId": {
+ "required": true,
+ "location": "path",
+ "description": "Account ID of the buyer.",
+ "type": "string"
+ }
+ },
+ "parameterOrder": [
+ "accountId"
+ ],
+ "path": "v2beta1/accounts/{accountId}/proposals"
+ },
+ "get": {
+ "parameterOrder": [
+ "accountId",
+ "proposalId"
+ ],
+ "response": {
+ "$ref": "Proposal"
+ },
+ "id": "adexchangebuyer2.accounts.proposals.get",
+ "flatPath": "v2beta1/accounts/{accountId}/proposals/{proposalId}",
+ "scopes": [
+ "https://www.googleapis.com/auth/adexchange.buyer"
+ ],
+ "httpMethod": "GET",
+ "parameters": {
+ "proposalId": {
+ "location": "path",
+ "description": "The unique ID of the proposal",
+ "type": "string",
+ "required": true
+ },
+ "accountId": {
+ "type": "string",
+ "required": true,
+ "description": "Account ID of the buyer.",
+ "location": "path"
+ }
+ },
+ "path": "v2beta1/accounts/{accountId}/proposals/{proposalId}",
+ "description": "Gets a proposal given its ID. The proposal is returned at its head revision."
+ },
+ "pause": {
+ "request": {
+ "$ref": "PauseProposalRequest"
+ },
+ "id": "adexchangebuyer2.accounts.proposals.pause",
+ "parameterOrder": [
+ "accountId",
+ "proposalId"
+ ],
+ "scopes": [
+ "https://www.googleapis.com/auth/adexchange.buyer"
+ ],
+ "response": {
+ "$ref": "Proposal"
+ },
+ "httpMethod": "POST",
+ "flatPath": "v2beta1/accounts/{accountId}/proposals/{proposalId}:pause",
+ "description": "Update the given proposal to pause serving. This method will set the `DealServingMetadata.DealPauseStatus.has_buyer_paused` bit to true for all deals in the proposal. It is a no-op to pause an already-paused proposal. It is an error to call PauseProposal for a proposal that is not finalized or renegotiating.",
+ "parameters": {
+ "proposalId": {
+ "required": true,
+ "description": "The ID of the proposal to pause.",
+ "location": "path",
+ "type": "string"
+ },
+ "accountId": {
+ "description": "Account ID of the buyer.",
+ "location": "path",
+ "required": true,
+ "type": "string"
+ }
+ },
+ "path": "v2beta1/accounts/{accountId}/proposals/{proposalId}:pause"
+ },
+ "cancelNegotiation": {
+ "httpMethod": "POST",
+ "parameterOrder": [
+ "accountId",
+ "proposalId"
+ ],
+ "path": "v2beta1/accounts/{accountId}/proposals/{proposalId}:cancelNegotiation",
+ "flatPath": "v2beta1/accounts/{accountId}/proposals/{proposalId}:cancelNegotiation",
+ "id": "adexchangebuyer2.accounts.proposals.cancelNegotiation",
+ "parameters": {
+ "proposalId": {
+ "type": "string",
+ "required": true,
+ "location": "path",
+ "description": "The ID of the proposal to cancel negotiation for."
+ },
+ "accountId": {
+ "location": "path",
+ "description": "Account ID of the buyer.",
+ "required": true,
+ "type": "string"
+ }
+ },
+ "response": {
+ "$ref": "Proposal"
+ },
+ "request": {
+ "$ref": "CancelNegotiationRequest"
+ },
+ "description": "Cancel an ongoing negotiation on a proposal. This does not cancel or end serving for the deals if the proposal has been finalized, but only cancels a negotiation unilaterally.",
+ "scopes": [
+ "https://www.googleapis.com/auth/adexchange.buyer"
+ ]
+ },
+ "list": {
+ "flatPath": "v2beta1/accounts/{accountId}/proposals",
+ "id": "adexchangebuyer2.accounts.proposals.list",
+ "scopes": [
+ "https://www.googleapis.com/auth/adexchange.buyer"
+ ],
+ "response": {
+ "$ref": "ListProposalsResponse"
+ },
+ "parameters": {
+ "pageToken": {
+ "type": "string",
+ "description": "The page token as returned from ListProposalsResponse.",
+ "location": "query"
+ },
+ "pageSize": {
+ "format": "int32",
+ "type": "integer",
+ "location": "query",
+ "description": "Requested page size. The server may return fewer results than requested. If unspecified, the server will pick an appropriate default."
+ },
+ "filter": {
+ "location": "query",
+ "type": "string",
+ "description": "An optional PQL filter query used to query for proposals. Nested repeated fields, such as proposal.deals.targetingCriterion, cannot be filtered."
+ },
+ "accountId": {
+ "type": "string",
+ "description": "Account ID of the buyer.",
+ "required": true,
+ "location": "path"
+ },
+ "filterSyntax": {
+ "description": "Syntax the filter is written in. Current implementation defaults to PQL but in the future it will be LIST_FILTER.",
+ "location": "query",
+ "type": "string",
+ "enum": [
+ "FILTER_SYNTAX_UNSPECIFIED",
+ "PQL",
+ "LIST_FILTER"
+ ],
+ "enumDescriptions": [
+ "A placeholder for an undefined filter syntax.",
+ "PQL query syntax. Visit https://developers.google.com/ad-manager/api/pqlreference for PQL documentation and examples.",
+ "API list filtering syntax. Read about syntax and usage at https://developers.google.com/authorized-buyers/apis/guides/v2/list-filters."
+ ]
+ }
+ },
+ "path": "v2beta1/accounts/{accountId}/proposals",
+ "httpMethod": "GET",
+ "parameterOrder": [
+ "accountId"
+ ],
+ "description": "List proposals. A filter expression (PQL query) may be specified to filter the results. To retrieve all finalized proposals, regardless if a proposal is being renegotiated, see the FinalizedProposals resource. Note that Bidder/ChildSeat relationships differ from the usual behavior. A Bidder account can only see its child seats' proposals by specifying the ChildSeat's accountId in the request path."
+ },
+ "accept": {
+ "parameterOrder": [
+ "accountId",
+ "proposalId"
+ ],
+ "request": {
+ "$ref": "AcceptProposalRequest"
+ },
+ "flatPath": "v2beta1/accounts/{accountId}/proposals/{proposalId}:accept",
+ "httpMethod": "POST",
+ "id": "adexchangebuyer2.accounts.proposals.accept",
+ "parameters": {
+ "proposalId": {
+ "required": true,
+ "location": "path",
+ "description": "The ID of the proposal to accept.",
+ "type": "string"
+ },
+ "accountId": {
+ "type": "string",
+ "description": "Account ID of the buyer.",
+ "location": "path",
+ "required": true
+ }
+ },
+ "path": "v2beta1/accounts/{accountId}/proposals/{proposalId}:accept",
+ "description": "Mark the proposal as accepted at the given revision number. If the number does not match the server's revision number an `ABORTED` error message will be returned. This call updates the proposal_state from `PROPOSED` to `BUYER_ACCEPTED`, or from `SELLER_ACCEPTED` to `FINALIZED`.",
+ "response": {
+ "$ref": "Proposal"
+ },
+ "scopes": [
+ "https://www.googleapis.com/auth/adexchange.buyer"
+ ]
+ },
+ "completeSetup": {
+ "description": "Update the given proposal to indicate that setup has been completed. This method is called by the buyer when the line items have been created on their end for a finalized proposal and all the required creatives have been uploaded using the creatives API. This call updates the `is_setup_completed` bit on the proposal and also notifies the seller. The server will advance the revision number of the most recent proposal.",
+ "flatPath": "v2beta1/accounts/{accountId}/proposals/{proposalId}:completeSetup",
+ "id": "adexchangebuyer2.accounts.proposals.completeSetup",
+ "httpMethod": "POST",
+ "response": {
+ "$ref": "Proposal"
+ },
+ "parameters": {
+ "proposalId": {
+ "location": "path",
+ "type": "string",
+ "description": "The ID of the proposal to mark as setup completed.",
+ "required": true
+ },
+ "accountId": {
+ "type": "string",
+ "required": true,
+ "location": "path",
+ "description": "Account ID of the buyer."
+ }
+ },
+ "parameterOrder": [
+ "accountId",
+ "proposalId"
+ ],
+ "request": {
+ "$ref": "CompleteSetupRequest"
+ },
+ "scopes": [
+ "https://www.googleapis.com/auth/adexchange.buyer"
+ ],
+ "path": "v2beta1/accounts/{accountId}/proposals/{proposalId}:completeSetup"
+ },
+ "addNote": {
+ "response": {
+ "$ref": "Note"
+ },
+ "request": {
+ "$ref": "AddNoteRequest"
+ },
+ "httpMethod": "POST",
+ "parameters": {
+ "accountId": {
+ "required": true,
+ "location": "path",
+ "type": "string",
+ "description": "Account ID of the buyer."
+ },
+ "proposalId": {
+ "type": "string",
+ "description": "The ID of the proposal to attach the note to.",
+ "required": true,
+ "location": "path"
+ }
+ },
+ "description": "Create a new note and attach it to the proposal. The note is assigned a unique ID by the server. The proposal revision number will not increase when associated with a new note.",
+ "flatPath": "v2beta1/accounts/{accountId}/proposals/{proposalId}:addNote",
+ "parameterOrder": [
+ "accountId",
+ "proposalId"
+ ],
+ "scopes": [
+ "https://www.googleapis.com/auth/adexchange.buyer"
+ ],
+ "path": "v2beta1/accounts/{accountId}/proposals/{proposalId}:addNote",
+ "id": "adexchangebuyer2.accounts.proposals.addNote"
+ },
+ "resume": {
+ "scopes": [
+ "https://www.googleapis.com/auth/adexchange.buyer"
+ ],
+ "parameters": {
+ "accountId": {
+ "type": "string",
+ "required": true,
+ "location": "path",
+ "description": "Account ID of the buyer."
+ },
+ "proposalId": {
+ "location": "path",
+ "type": "string",
+ "description": "The ID of the proposal to resume.",
+ "required": true
+ }
+ },
+ "request": {
+ "$ref": "ResumeProposalRequest"
+ },
+ "id": "adexchangebuyer2.accounts.proposals.resume",
+ "description": "Update the given proposal to resume serving. This method will set the `DealServingMetadata.DealPauseStatus.has_buyer_paused` bit to false for all deals in the proposal. Note that if the `has_seller_paused` bit is also set, serving will not resume until the seller also resumes. It is a no-op to resume an already-running proposal. It is an error to call ResumeProposal for a proposal that is not finalized or renegotiating.",
+ "path": "v2beta1/accounts/{accountId}/proposals/{proposalId}:resume",
+ "httpMethod": "POST",
+ "flatPath": "v2beta1/accounts/{accountId}/proposals/{proposalId}:resume",
+ "parameterOrder": [
+ "accountId",
+ "proposalId"
+ ],
+ "response": {
+ "$ref": "Proposal"
+ }
+ },
+ "update": {
+ "path": "v2beta1/accounts/{accountId}/proposals/{proposalId}",
+ "description": "Update the given proposal at the client known revision number. If the server revision has advanced since the passed-in `proposal.proposal_revision`, an `ABORTED` error message will be returned. Only the buyer-modifiable fields of the proposal will be updated. Note that the deals in the proposal will be updated to match the passed-in copy. If a passed-in deal does not have a `deal_id`, the server will assign a new unique ID and create the deal. If passed-in deal has a `deal_id`, it will be updated to match the passed-in copy. Any existing deals not present in the passed-in proposal will be deleted. It is an error to pass in a deal with a `deal_id` not present at head.",
+ "response": {
+ "$ref": "Proposal"
+ },
+ "parameterOrder": [
+ "accountId",
+ "proposalId"
+ ],
+ "flatPath": "v2beta1/accounts/{accountId}/proposals/{proposalId}",
+ "parameters": {
+ "proposalId": {
+ "location": "path",
+ "required": true,
+ "type": "string",
+ "description": "The unique ID of the proposal."
+ },
+ "accountId": {
+ "location": "path",
+ "description": "Account ID of the buyer.",
+ "required": true,
+ "type": "string"
+ }
+ },
+ "request": {
+ "$ref": "Proposal"
+ },
+ "httpMethod": "PUT",
+ "id": "adexchangebuyer2.accounts.proposals.update",
+ "scopes": [
+ "https://www.googleapis.com/auth/adexchange.buyer"
+ ]
+ }
+ }
+ },
+ "products": {
+ "methods": {
+ "get": {
+ "flatPath": "v2beta1/accounts/{accountId}/products/{productId}",
+ "parameters": {
+ "productId": {
+ "description": "The ID for the product to get the head revision for.",
+ "required": true,
+ "location": "path",
+ "type": "string"
+ },
+ "accountId": {
+ "description": "Account ID of the buyer.",
+ "type": "string",
+ "required": true,
+ "location": "path"
+ }
+ },
+ "scopes": [
+ "https://www.googleapis.com/auth/adexchange.buyer"
+ ],
+ "description": "Gets the requested product by ID.",
+ "path": "v2beta1/accounts/{accountId}/products/{productId}",
+ "httpMethod": "GET",
+ "response": {
+ "$ref": "Product"
+ },
+ "parameterOrder": [
+ "accountId",
+ "productId"
+ ],
+ "id": "adexchangebuyer2.accounts.products.get"
+ },
+ "list": {
+ "parameters": {
+ "filter": {
+ "description": "An optional PQL query used to query for products. See https://developers.google.com/ad-manager/docs/pqlreference for documentation about PQL and examples. Nested repeated fields, such as product.targetingCriterion.inclusions, cannot be filtered.",
+ "location": "query",
+ "type": "string"
+ },
+ "pageSize": {
+ "location": "query",
+ "type": "integer",
+ "description": "Requested page size. The server may return fewer results than requested. If unspecified, the server will pick an appropriate default.",
+ "format": "int32"
+ },
+ "accountId": {
+ "required": true,
+ "description": "Account ID of the buyer.",
+ "location": "path",
+ "type": "string"
+ },
+ "pageToken": {
+ "type": "string",
+ "description": "The page token as returned from ListProductsResponse.",
+ "location": "query"
+ }
+ },
+ "description": "List all products visible to the buyer (optionally filtered by the specified PQL query).",
+ "response": {
+ "$ref": "ListProductsResponse"
+ },
+ "httpMethod": "GET",
+ "flatPath": "v2beta1/accounts/{accountId}/products",
+ "path": "v2beta1/accounts/{accountId}/products",
+ "parameterOrder": [
+ "accountId"
+ ],
+ "id": "adexchangebuyer2.accounts.products.list",
+ "scopes": [
+ "https://www.googleapis.com/auth/adexchange.buyer"
+ ]
+ }
+ }
+ },
+ "publisherProfiles": {
+ "methods": {
+ "list": {
+ "parameters": {
+ "pageToken": {
+ "description": "The page token as return from ListPublisherProfilesResponse.",
+ "location": "query",
+ "type": "string"
+ },
+ "pageSize": {
+ "location": "query",
+ "type": "integer",
+ "format": "int32",
+ "description": "Specify the number of results to include per page."
+ },
+ "accountId": {
+ "required": true,
+ "description": "Account ID of the buyer.",
+ "location": "path",
+ "type": "string"
+ }
+ },
+ "scopes": [
+ "https://www.googleapis.com/auth/adexchange.buyer"
+ ],
+ "id": "adexchangebuyer2.accounts.publisherProfiles.list",
+ "response": {
+ "$ref": "ListPublisherProfilesResponse"
+ },
+ "httpMethod": "GET",
+ "parameterOrder": [
+ "accountId"
+ ],
+ "path": "v2beta1/accounts/{accountId}/publisherProfiles",
+ "description": "List all publisher profiles visible to the buyer",
+ "flatPath": "v2beta1/accounts/{accountId}/publisherProfiles"
+ },
+ "get": {
+ "scopes": [
+ "https://www.googleapis.com/auth/adexchange.buyer"
+ ],
+ "parameters": {
+ "accountId": {
+ "description": "Account ID of the buyer.",
+ "location": "path",
+ "type": "string",
+ "required": true
+ },
+ "publisherProfileId": {
+ "required": true,
+ "location": "path",
+ "type": "string",
+ "description": "The id for the publisher profile to get."
+ }
+ },
+ "flatPath": "v2beta1/accounts/{accountId}/publisherProfiles/{publisherProfileId}",
+ "description": "Gets the requested publisher profile by id.",
+ "httpMethod": "GET",
+ "parameterOrder": [
+ "accountId",
+ "publisherProfileId"
+ ],
+ "path": "v2beta1/accounts/{accountId}/publisherProfiles/{publisherProfileId}",
+ "id": "adexchangebuyer2.accounts.publisherProfiles.get",
+ "response": {
+ "$ref": "PublisherProfile"
+ }
+ }
+ }
+ },
+ "creatives": {
+ "resources": {
+ "dealAssociations": {
+ "methods": {
+ "remove": {
+ "response": {
+ "$ref": "Empty"
+ },
+ "flatPath": "v2beta1/accounts/{accountId}/creatives/{creativeId}/dealAssociations:remove",
+ "parameters": {
+ "creativeId": {
+ "location": "path",
+ "required": true,
+ "type": "string",
+ "description": "The ID of the creative associated with the deal."
+ },
+ "accountId": {
+ "description": "The account the creative belongs to.",
+ "type": "string",
+ "required": true,
+ "location": "path"
+ }
+ },
+ "scopes": [
+ "https://www.googleapis.com/auth/adexchange.buyer"
+ ],
+ "parameterOrder": [
+ "accountId",
+ "creativeId"
+ ],
+ "request": {
+ "$ref": "RemoveDealAssociationRequest"
+ },
+ "description": "Remove the association between a deal and a creative.",
+ "httpMethod": "POST",
+ "path": "v2beta1/accounts/{accountId}/creatives/{creativeId}/dealAssociations:remove",
+ "id": "adexchangebuyer2.accounts.creatives.dealAssociations.remove"
+ },
+ "list": {
+ "description": "List all creative-deal associations.",
+ "httpMethod": "GET",
+ "id": "adexchangebuyer2.accounts.creatives.dealAssociations.list",
+ "response": {
+ "$ref": "ListDealAssociationsResponse"
+ },
+ "parameterOrder": [
+ "accountId",
+ "creativeId"
+ ],
+ "scopes": [
+ "https://www.googleapis.com/auth/adexchange.buyer"
+ ],
+ "path": "v2beta1/accounts/{accountId}/creatives/{creativeId}/dealAssociations",
+ "flatPath": "v2beta1/accounts/{accountId}/creatives/{creativeId}/dealAssociations",
+ "parameters": {
+ "pageSize": {
+ "description": "Requested page size. Server may return fewer associations than requested. If unspecified, server will pick an appropriate default.",
+ "location": "query",
+ "format": "int32",
+ "type": "integer"
+ },
+ "accountId": {
+ "required": true,
+ "description": "The account to list the associations from. Specify \"-\" to list all creatives the current user has access to.",
+ "type": "string",
+ "location": "path"
+ },
+ "pageToken": {
+ "location": "query",
+ "description": "A token identifying a page of results the server should return. Typically, this is the value of ListDealAssociationsResponse.next_page_token returned from the previous call to 'ListDealAssociations' method.",
+ "type": "string"
+ },
+ "query": {
+ "description": "An optional query string to filter deal associations. If no filter is specified, all associations will be returned. Supported queries are: - accountId=*account_id_string* - creativeId=*creative_id_string* - dealsId=*deals_id_string* - dealsStatus:{approved, conditionally_approved, disapproved, not_checked} - openAuctionStatus:{approved, conditionally_approved, disapproved, not_checked} Example: 'dealsId=12345 AND dealsStatus:disapproved'",
+ "type": "string",
+ "location": "query"
+ },
+ "creativeId": {
+ "type": "string",
+ "description": "The creative ID to list the associations from. Specify \"-\" to list all creatives under the above account.",
+ "required": true,
+ "location": "path"
+ }
+ }
+ },
+ "add": {
+ "request": {
+ "$ref": "AddDealAssociationRequest"
+ },
+ "path": "v2beta1/accounts/{accountId}/creatives/{creativeId}/dealAssociations:add",
+ "parameters": {
+ "accountId": {
+ "description": "The account the creative belongs to.",
+ "required": true,
+ "type": "string",
+ "location": "path"
+ },
+ "creativeId": {
+ "description": "The ID of the creative associated with the deal.",
+ "location": "path",
+ "required": true,
+ "type": "string"
+ }
+ },
+ "httpMethod": "POST",
+ "description": "Associate an existing deal with a creative.",
+ "scopes": [
+ "https://www.googleapis.com/auth/adexchange.buyer"
+ ],
+ "id": "adexchangebuyer2.accounts.creatives.dealAssociations.add",
+ "parameterOrder": [
+ "accountId",
+ "creativeId"
+ ],
+ "flatPath": "v2beta1/accounts/{accountId}/creatives/{creativeId}/dealAssociations:add",
+ "response": {
+ "$ref": "Empty"
+ }
+ }
+ }
+ }
+ },
+ "methods": {
+ "stopWatching": {
+ "path": "v2beta1/accounts/{accountId}/creatives/{creativeId}:stopWatching",
+ "response": {
+ "$ref": "Empty"
+ },
+ "scopes": [
+ "https://www.googleapis.com/auth/adexchange.buyer"
+ ],
+ "description": "Stops watching a creative. Will stop push notifications being sent to the topics when the creative changes status.",
+ "request": {
+ "$ref": "StopWatchingCreativeRequest"
+ },
+ "flatPath": "v2beta1/accounts/{accountId}/creatives/{creativeId}:stopWatching",
+ "id": "adexchangebuyer2.accounts.creatives.stopWatching",
+ "parameters": {
+ "creativeId": {
+ "description": "The creative ID of the creative to stop notifications for. Specify \"-\" to specify stopping account level notifications.",
+ "type": "string",
+ "required": true,
+ "location": "path"
+ },
+ "accountId": {
+ "location": "path",
+ "description": "The account of the creative to stop notifications for.",
+ "type": "string",
+ "required": true
+ }
+ },
+ "parameterOrder": [
+ "accountId",
+ "creativeId"
+ ],
+ "httpMethod": "POST"
+ },
+ "watch": {
+ "flatPath": "v2beta1/accounts/{accountId}/creatives/{creativeId}:watch",
+ "scopes": [
+ "https://www.googleapis.com/auth/adexchange.buyer"
+ ],
+ "response": {
+ "$ref": "Empty"
+ },
+ "path": "v2beta1/accounts/{accountId}/creatives/{creativeId}:watch",
+ "parameterOrder": [
+ "accountId",
+ "creativeId"
+ ],
+ "id": "adexchangebuyer2.accounts.creatives.watch",
+ "request": {
+ "$ref": "WatchCreativeRequest"
+ },
+ "httpMethod": "POST",
+ "parameters": {
+ "accountId": {
+ "description": "The account of the creative to watch.",
+ "required": true,
+ "location": "path",
+ "type": "string"
+ },
+ "creativeId": {
+ "location": "path",
+ "description": "The creative ID to watch for status changes. Specify \"-\" to watch all creatives under the above account. If both creative-level and account-level notifications are sent, only a single notification will be sent to the creative-level notification topic.",
+ "type": "string",
+ "required": true
+ }
+ },
+ "description": "Watches a creative. Will result in push notifications being sent to the topic when the creative changes status."
+ },
+ "update": {
+ "description": "Updates a creative.",
+ "scopes": [
+ "https://www.googleapis.com/auth/adexchange.buyer"
+ ],
+ "path": "v2beta1/accounts/{accountId}/creatives/{creativeId}",
+ "parameterOrder": [
+ "accountId",
+ "creativeId"
+ ],
+ "request": {
+ "$ref": "Creative"
+ },
+ "parameters": {
+ "creativeId": {
+ "required": true,
+ "description": "The buyer-defined creative ID of this creative. Can be used to filter the response of the creatives.list method.",
+ "type": "string",
+ "location": "path"
+ },
+ "accountId": {
+ "type": "string",
+ "location": "path",
+ "required": true,
+ "description": "The account that this creative belongs to. Can be used to filter the response of the creatives.list method."
+ }
+ },
+ "httpMethod": "PUT",
+ "id": "adexchangebuyer2.accounts.creatives.update",
+ "flatPath": "v2beta1/accounts/{accountId}/creatives/{creativeId}",
+ "response": {
+ "$ref": "Creative"
+ }
+ },
+ "create": {
+ "path": "v2beta1/accounts/{accountId}/creatives",
+ "description": "Creates a creative.",
+ "httpMethod": "POST",
+ "scopes": [
+ "https://www.googleapis.com/auth/adexchange.buyer"
+ ],
+ "parameterOrder": [
+ "accountId"
+ ],
+ "id": "adexchangebuyer2.accounts.creatives.create",
+ "flatPath": "v2beta1/accounts/{accountId}/creatives",
+ "request": {
+ "$ref": "Creative"
+ },
+ "parameters": {
+ "accountId": {
+ "type": "string",
+ "required": true,
+ "location": "path",
+ "description": "The account that this creative belongs to. Can be used to filter the response of the creatives.list method."
+ },
+ "duplicateIdMode": {
+ "enumDescriptions": [
+ "Recommended. This means that an ID will be unique to a single creative. Multiple creatives will not share an ID.",
+ "Not recommended. Using this option will allow multiple creatives to share the same ID. Get and Update requests will not be possible for any ID that has more than one creative associated. (List will still function.) This is only intended for backwards compatibility in cases where a single ID is already shared by multiple creatives from previous APIs."
+ ],
+ "type": "string",
+ "location": "query",
+ "enum": [
+ "NO_DUPLICATES",
+ "FORCE_ENABLE_DUPLICATE_IDS"
+ ],
+ "description": "Indicates if multiple creatives can share an ID or not. Default is NO_DUPLICATES (one ID per creative)."
+ }
+ },
+ "response": {
+ "$ref": "Creative"
+ }
+ },
+ "list": {
+ "parameterOrder": [
+ "accountId"
+ ],
+ "httpMethod": "GET",
+ "flatPath": "v2beta1/accounts/{accountId}/creatives",
+ "response": {
+ "$ref": "ListCreativesResponse"
+ },
+ "description": "Lists creatives.",
+ "scopes": [
+ "https://www.googleapis.com/auth/adexchange.buyer"
+ ],
+ "parameters": {
+ "query": {
+ "description": "An optional query string to filter creatives. If no filter is specified, all active creatives will be returned. Supported queries are: - accountId=*account_id_string* - creativeId=*creative_id_string* - dealsStatus: {approved, conditionally_approved, disapproved, not_checked} - openAuctionStatus: {approved, conditionally_approved, disapproved, not_checked} - attribute: {a numeric attribute from the list of attributes} - disapprovalReason: {a reason from DisapprovalReason} Example: 'accountId=12345 AND (dealsStatus:disapproved AND disapprovalReason:unacceptable_content) OR attribute:47'",
+ "location": "query",
+ "type": "string"
+ },
+ "accountId": {
+ "location": "path",
+ "description": "The account to list the creatives from. Specify \"-\" to list all creatives the current user has access to.",
+ "type": "string",
+ "required": true
+ },
+ "pageToken": {
+ "type": "string",
+ "location": "query",
+ "description": "A token identifying a page of results the server should return. Typically, this is the value of ListCreativesResponse.next_page_token returned from the previous call to 'ListCreatives' method."
+ },
+ "pageSize": {
+ "description": "Requested page size. The server may return fewer creatives than requested (due to timeout constraint) even if more are available via another call. If unspecified, server will pick an appropriate default. Acceptable values are 1 to 1000, inclusive.",
+ "location": "query",
+ "type": "integer",
+ "format": "int32"
+ }
+ },
+ "path": "v2beta1/accounts/{accountId}/creatives",
+ "id": "adexchangebuyer2.accounts.creatives.list"
+ },
+ "get": {
+ "parameterOrder": [
+ "accountId",
+ "creativeId"
+ ],
+ "httpMethod": "GET",
+ "flatPath": "v2beta1/accounts/{accountId}/creatives/{creativeId}",
+ "description": "Gets a creative.",
+ "scopes": [
+ "https://www.googleapis.com/auth/adexchange.buyer"
+ ],
+ "response": {
+ "$ref": "Creative"
+ },
+ "parameters": {
+ "accountId": {
+ "type": "string",
+ "required": true,
+ "description": "The account the creative belongs to.",
+ "location": "path"
+ },
+ "creativeId": {
+ "required": true,
+ "description": "The ID of the creative to retrieve.",
+ "type": "string",
+ "location": "path"
+ }
+ },
+ "path": "v2beta1/accounts/{accountId}/creatives/{creativeId}",
+ "id": "adexchangebuyer2.accounts.creatives.get"
+ }
+ }
+ },
+ "finalizedProposals": {
+ "methods": {
+ "list": {
+ "id": "adexchangebuyer2.accounts.finalizedProposals.list",
+ "description": "List finalized proposals, regardless if a proposal is being renegotiated. A filter expression (PQL query) may be specified to filter the results. The notes will not be returned.",
+ "response": {
+ "$ref": "ListProposalsResponse"
+ },
+ "scopes": [
+ "https://www.googleapis.com/auth/adexchange.buyer"
+ ],
+ "httpMethod": "GET",
+ "parameters": {
+ "pageToken": {
+ "type": "string",
+ "location": "query",
+ "description": "The page token as returned from ListProposalsResponse."
+ },
+ "filterSyntax": {
+ "enumDescriptions": [
+ "A placeholder for an undefined filter syntax.",
+ "PQL query syntax. Visit https://developers.google.com/ad-manager/api/pqlreference for PQL documentation and examples.",
+ "API list filtering syntax. Read about syntax and usage at https://developers.google.com/authorized-buyers/apis/guides/v2/list-filters."
+ ],
+ "location": "query",
+ "type": "string",
+ "description": "Syntax the filter is written in. Current implementation defaults to PQL but in the future it will be LIST_FILTER.",
+ "enum": [
+ "FILTER_SYNTAX_UNSPECIFIED",
+ "PQL",
+ "LIST_FILTER"
+ ]
+ },
+ "pageSize": {
+ "format": "int32",
+ "description": "Requested page size. The server may return fewer results than requested. If unspecified, the server will pick an appropriate default.",
+ "location": "query",
+ "type": "integer"
+ },
+ "accountId": {
+ "location": "path",
+ "required": true,
+ "type": "string",
+ "description": "Account ID of the buyer."
+ },
+ "filter": {
+ "location": "query",
+ "type": "string",
+ "description": "An optional PQL filter query used to query for proposals. Nested repeated fields, such as proposal.deals.targetingCriterion, cannot be filtered."
+ }
+ },
+ "parameterOrder": [
+ "accountId"
+ ],
+ "path": "v2beta1/accounts/{accountId}/finalizedProposals",
+ "flatPath": "v2beta1/accounts/{accountId}/finalizedProposals"
+ }
+ }
+ },
+ "clients": {
+ "resources": {
+ "users": {
+ "methods": {
+ "update": {
+ "scopes": [
+ "https://www.googleapis.com/auth/adexchange.buyer"
+ ],
+ "httpMethod": "PUT",
+ "parameterOrder": [
+ "accountId",
+ "clientAccountId",
+ "userId"
+ ],
+ "description": "Updates an existing client user. Only the user status can be changed on update.",
+ "id": "adexchangebuyer2.accounts.clients.users.update",
+ "path": "v2beta1/accounts/{accountId}/clients/{clientAccountId}/users/{userId}",
+ "flatPath": "v2beta1/accounts/{accountId}/clients/{clientAccountId}/users/{userId}",
+ "parameters": {
+ "userId": {
+ "required": true,
+ "format": "int64",
+ "location": "path",
+ "description": "Numerical identifier of the user to retrieve. (required)",
+ "type": "string"
+ },
+ "accountId": {
+ "format": "int64",
+ "type": "string",
+ "description": "Numerical account ID of the client's sponsor buyer. (required)",
+ "location": "path",
+ "required": true
+ },
+ "clientAccountId": {
+ "location": "path",
+ "description": "Numerical account ID of the client buyer that the user to be retrieved is associated with. (required)",
+ "required": true,
+ "format": "int64",
+ "type": "string"
+ }
+ },
+ "request": {
+ "$ref": "ClientUser"
+ },
+ "response": {
+ "$ref": "ClientUser"
+ }
+ },
+ "list": {
+ "parameters": {
+ "pageSize": {
+ "format": "int32",
+ "location": "query",
+ "type": "integer",
+ "description": "Requested page size. The server may return fewer clients than requested. If unspecified, the server will pick an appropriate default."
+ },
+ "accountId": {
+ "format": "int64",
+ "required": true,
+ "description": "Numerical account ID of the sponsor buyer of the client to list users for. (required)",
+ "type": "string",
+ "location": "path"
+ },
+ "clientAccountId": {
+ "location": "path",
+ "required": true,
+ "description": "The account ID of the client buyer to list users for. (required) You must specify either a string representation of a numerical account identifier or the `-` character to list all the client users for all the clients of a given sponsor buyer.",
+ "type": "string"
+ },
+ "pageToken": {
+ "description": "A token identifying a page of results the server should return. Typically, this is the value of ListClientUsersResponse.nextPageToken returned from the previous call to the accounts.clients.users.list method.",
+ "location": "query",
+ "type": "string"
+ }
+ },
+ "scopes": [
+ "https://www.googleapis.com/auth/adexchange.buyer"
+ ],
+ "httpMethod": "GET",
+ "response": {
+ "$ref": "ListClientUsersResponse"
+ },
+ "parameterOrder": [
+ "accountId",
+ "clientAccountId"
+ ],
+ "flatPath": "v2beta1/accounts/{accountId}/clients/{clientAccountId}/users",
+ "path": "v2beta1/accounts/{accountId}/clients/{clientAccountId}/users",
+ "description": "Lists all the known client users for a specified sponsor buyer account ID.",
+ "id": "adexchangebuyer2.accounts.clients.users.list"
+ },
+ "get": {
+ "scopes": [
+ "https://www.googleapis.com/auth/adexchange.buyer"
+ ],
+ "parameters": {
+ "accountId": {
+ "description": "Numerical account ID of the client's sponsor buyer. (required)",
+ "type": "string",
+ "required": true,
+ "format": "int64",
+ "location": "path"
+ },
+ "clientAccountId": {
+ "type": "string",
+ "format": "int64",
+ "location": "path",
+ "required": true,
+ "description": "Numerical account ID of the client buyer that the user to be retrieved is associated with. (required)"
+ },
+ "userId": {
+ "description": "Numerical identifier of the user to retrieve. (required)",
+ "required": true,
+ "format": "int64",
+ "location": "path",
+ "type": "string"
+ }
+ },
+ "httpMethod": "GET",
+ "id": "adexchangebuyer2.accounts.clients.users.get",
+ "response": {
+ "$ref": "ClientUser"
+ },
+ "path": "v2beta1/accounts/{accountId}/clients/{clientAccountId}/users/{userId}",
+ "description": "Retrieves an existing client user.",
+ "parameterOrder": [
+ "accountId",
+ "clientAccountId",
+ "userId"
+ ],
+ "flatPath": "v2beta1/accounts/{accountId}/clients/{clientAccountId}/users/{userId}"
+ }
+ }
+ },
+ "invitations": {
+ "methods": {
+ "create": {
+ "request": {
+ "$ref": "ClientUserInvitation"
+ },
+ "parameterOrder": [
+ "accountId",
+ "clientAccountId"
+ ],
+ "parameters": {
+ "accountId": {
+ "type": "string",
+ "format": "int64",
+ "location": "path",
+ "description": "Numerical account ID of the client's sponsor buyer. (required)",
+ "required": true
+ },
+ "clientAccountId": {
+ "format": "int64",
+ "required": true,
+ "description": "Numerical account ID of the client buyer that the user should be associated with. (required)",
+ "type": "string",
+ "location": "path"
+ }
+ },
+ "description": "Creates and sends out an email invitation to access an Ad Exchange client buyer account.",
+ "httpMethod": "POST",
+ "flatPath": "v2beta1/accounts/{accountId}/clients/{clientAccountId}/invitations",
+ "path": "v2beta1/accounts/{accountId}/clients/{clientAccountId}/invitations",
+ "scopes": [
+ "https://www.googleapis.com/auth/adexchange.buyer"
+ ],
+ "response": {
+ "$ref": "ClientUserInvitation"
+ },
+ "id": "adexchangebuyer2.accounts.clients.invitations.create"
+ },
+ "list": {
+ "parameters": {
+ "clientAccountId": {
+ "required": true,
+ "description": "Numerical account ID of the client buyer to list invitations for. (required) You must either specify a string representation of a numerical account identifier or the `-` character to list all the invitations for all the clients of a given sponsor buyer.",
+ "location": "path",
+ "type": "string"
+ },
+ "accountId": {
+ "format": "int64",
+ "description": "Numerical account ID of the client's sponsor buyer. (required)",
+ "location": "path",
+ "type": "string",
+ "required": true
+ },
+ "pageSize": {
+ "type": "integer",
+ "format": "int32",
+ "location": "query",
+ "description": "Requested page size. Server may return fewer clients than requested. If unspecified, server will pick an appropriate default."
+ },
+ "pageToken": {
+ "description": "A token identifying a page of results the server should return. Typically, this is the value of ListClientUserInvitationsResponse.nextPageToken returned from the previous call to the clients.invitations.list method.",
+ "location": "query",
+ "type": "string"
+ }
+ },
+ "httpMethod": "GET",
+ "parameterOrder": [
+ "accountId",
+ "clientAccountId"
+ ],
+ "response": {
+ "$ref": "ListClientUserInvitationsResponse"
+ },
+ "description": "Lists all the client users invitations for a client with a given account ID.",
+ "path": "v2beta1/accounts/{accountId}/clients/{clientAccountId}/invitations",
+ "scopes": [
+ "https://www.googleapis.com/auth/adexchange.buyer"
+ ],
+ "flatPath": "v2beta1/accounts/{accountId}/clients/{clientAccountId}/invitations",
+ "id": "adexchangebuyer2.accounts.clients.invitations.list"
+ },
+ "get": {
+ "httpMethod": "GET",
+ "parameterOrder": [
+ "accountId",
+ "clientAccountId",
+ "invitationId"
+ ],
+ "description": "Retrieves an existing client user invitation.",
+ "scopes": [
+ "https://www.googleapis.com/auth/adexchange.buyer"
+ ],
+ "path": "v2beta1/accounts/{accountId}/clients/{clientAccountId}/invitations/{invitationId}",
+ "response": {
+ "$ref": "ClientUserInvitation"
+ },
+ "flatPath": "v2beta1/accounts/{accountId}/clients/{clientAccountId}/invitations/{invitationId}",
+ "parameters": {
+ "clientAccountId": {
+ "format": "int64",
+ "location": "path",
+ "description": "Numerical account ID of the client buyer that the user invitation to be retrieved is associated with. (required)",
+ "required": true,
+ "type": "string"
+ },
+ "accountId": {
+ "format": "int64",
+ "type": "string",
+ "description": "Numerical account ID of the client's sponsor buyer. (required)",
+ "required": true,
+ "location": "path"
+ },
+ "invitationId": {
+ "type": "string",
+ "required": true,
+ "location": "path",
+ "description": "Numerical identifier of the user invitation to retrieve. (required)",
+ "format": "int64"
+ }
+ },
+ "id": "adexchangebuyer2.accounts.clients.invitations.get"
+ }
+ }
+ }
+ },
+ "methods": {
+ "list": {
+ "flatPath": "v2beta1/accounts/{accountId}/clients",
+ "response": {
+ "$ref": "ListClientsResponse"
+ },
+ "description": "Lists all the clients for the current sponsor buyer.",
+ "path": "v2beta1/accounts/{accountId}/clients",
+ "id": "adexchangebuyer2.accounts.clients.list",
+ "httpMethod": "GET",
+ "parameterOrder": [
+ "accountId"
+ ],
+ "parameters": {
+ "pageToken": {
+ "description": "A token identifying a page of results the server should return. Typically, this is the value of ListClientsResponse.nextPageToken returned from the previous call to the accounts.clients.list method.",
+ "type": "string",
+ "location": "query"
+ },
+ "partnerClientId": {
+ "description": "Optional unique identifier (from the standpoint of an Ad Exchange sponsor buyer partner) of the client to return. If specified, at most one client will be returned in the response.",
+ "type": "string",
+ "location": "query"
+ },
+ "accountId": {
+ "type": "string",
+ "description": "Unique numerical account ID of the sponsor buyer to list the clients for.",
+ "format": "int64",
+ "required": true,
+ "location": "path"
+ },
+ "pageSize": {
+ "type": "integer",
+ "description": "Requested page size. The server may return fewer clients than requested. If unspecified, the server will pick an appropriate default.",
+ "location": "query",
+ "format": "int32"
+ }
+ },
+ "scopes": [
+ "https://www.googleapis.com/auth/adexchange.buyer"
+ ]
+ },
+ "update": {
+ "request": {
+ "$ref": "Client"
+ },
+ "httpMethod": "PUT",
+ "response": {
+ "$ref": "Client"
+ },
+ "parameterOrder": [
+ "accountId",
+ "clientAccountId"
+ ],
+ "description": "Updates an existing client buyer.",
+ "flatPath": "v2beta1/accounts/{accountId}/clients/{clientAccountId}",
+ "id": "adexchangebuyer2.accounts.clients.update",
+ "path": "v2beta1/accounts/{accountId}/clients/{clientAccountId}",
+ "scopes": [
+ "https://www.googleapis.com/auth/adexchange.buyer"
+ ],
+ "parameters": {
+ "accountId": {
+ "required": true,
+ "description": "Unique numerical account ID for the buyer of which the client buyer is a customer; the sponsor buyer to update a client for. (required)",
+ "location": "path",
+ "format": "int64",
+ "type": "string"
+ },
+ "clientAccountId": {
+ "required": true,
+ "description": "Unique numerical account ID of the client to update. (required)",
+ "location": "path",
+ "format": "int64",
+ "type": "string"
+ }
+ }
+ },
+ "create": {
+ "description": "Creates a new client buyer.",
+ "parameterOrder": [
+ "accountId"
+ ],
+ "httpMethod": "POST",
+ "flatPath": "v2beta1/accounts/{accountId}/clients",
+ "path": "v2beta1/accounts/{accountId}/clients",
+ "response": {
+ "$ref": "Client"
+ },
+ "parameters": {
+ "accountId": {
+ "description": "Unique numerical account ID for the buyer of which the client buyer is a customer; the sponsor buyer to create a client for. (required)",
+ "type": "string",
+ "required": true,
+ "location": "path",
+ "format": "int64"
+ }
+ },
+ "id": "adexchangebuyer2.accounts.clients.create",
+ "scopes": [
+ "https://www.googleapis.com/auth/adexchange.buyer"
+ ],
+ "request": {
+ "$ref": "Client"
+ }
+ },
+ "get": {
+ "id": "adexchangebuyer2.accounts.clients.get",
+ "scopes": [
+ "https://www.googleapis.com/auth/adexchange.buyer"
+ ],
+ "flatPath": "v2beta1/accounts/{accountId}/clients/{clientAccountId}",
+ "httpMethod": "GET",
+ "parameterOrder": [
+ "accountId",
+ "clientAccountId"
+ ],
+ "parameters": {
+ "clientAccountId": {
+ "description": "Numerical account ID of the client buyer to retrieve. (required)",
+ "format": "int64",
+ "location": "path",
+ "type": "string",
+ "required": true
+ },
+ "accountId": {
+ "location": "path",
+ "type": "string",
+ "required": true,
+ "format": "int64",
+ "description": "Numerical account ID of the client's sponsor buyer. (required)"
+ }
+ },
+ "response": {
+ "$ref": "Client"
+ },
+ "description": "Gets a client buyer with a given client account ID.",
+ "path": "v2beta1/accounts/{accountId}/clients/{clientAccountId}"
+ }
+ }
+ }
+ }
+ },
+ "bidders": {
+ "resources": {
+ "filterSets": {
+ "methods": {
+ "list": {
+ "path": "v2beta1/{+ownerName}/filterSets",
+ "parameterOrder": [
+ "ownerName"
+ ],
+ "scopes": [
+ "https://www.googleapis.com/auth/adexchange.buyer"
+ ],
+ "response": {
+ "$ref": "ListFilterSetsResponse"
+ },
+ "flatPath": "v2beta1/bidders/{biddersId}/filterSets",
+ "description": "Lists all filter sets for the account with the given account ID.",
+ "id": "adexchangebuyer2.bidders.filterSets.list",
+ "parameters": {
+ "pageSize": {
+ "type": "integer",
+ "format": "int32",
+ "location": "query",
+ "description": "Requested page size. The server may return fewer results than requested. If unspecified, the server will pick an appropriate default."
+ },
+ "pageToken": {
+ "type": "string",
+ "description": "A token identifying a page of results the server should return. Typically, this is the value of ListFilterSetsResponse.nextPageToken returned from the previous call to the accounts.filterSets.list method.",
+ "location": "query"
+ },
+ "ownerName": {
+ "location": "path",
+ "required": true,
+ "pattern": "^bidders/[^/]+$",
+ "type": "string",
+ "description": "Name of the owner (bidder or account) of the filter sets to be listed. For example: - For a bidder-level filter set for bidder 123: `bidders/123` - For an account-level filter set for the buyer account representing bidder 123: `bidders/123/accounts/123` - For an account-level filter set for the child seat buyer account 456 whose bidder is 123: `bidders/123/accounts/456`"
+ }
+ },
+ "httpMethod": "GET"
+ },
+ "get": {
+ "description": "Retrieves the requested filter set for the account with the given account ID.",
+ "id": "adexchangebuyer2.bidders.filterSets.get",
+ "response": {
+ "$ref": "FilterSet"
+ },
+ "parameters": {
+ "name": {
+ "required": true,
+ "pattern": "^bidders/[^/]+/filterSets/[^/]+$",
+ "location": "path",
+ "type": "string",
+ "description": "Full name of the resource being requested. For example: - For a bidder-level filter set for bidder 123: `bidders/123/filterSets/abc` - For an account-level filter set for the buyer account representing bidder 123: `bidders/123/accounts/123/filterSets/abc` - For an account-level filter set for the child seat buyer account 456 whose bidder is 123: `bidders/123/accounts/456/filterSets/abc`"
+ }
+ },
+ "scopes": [
+ "https://www.googleapis.com/auth/adexchange.buyer"
+ ],
+ "parameterOrder": [
+ "name"
+ ],
+ "path": "v2beta1/{+name}",
+ "flatPath": "v2beta1/bidders/{biddersId}/filterSets/{filterSetsId}",
+ "httpMethod": "GET"
+ },
+ "create": {
+ "id": "adexchangebuyer2.bidders.filterSets.create",
+ "httpMethod": "POST",
+ "path": "v2beta1/{+ownerName}/filterSets",
+ "parameters": {
+ "ownerName": {
+ "location": "path",
+ "pattern": "^bidders/[^/]+$",
+ "description": "Name of the owner (bidder or account) of the filter set to be created. For example: - For a bidder-level filter set for bidder 123: `bidders/123` - For an account-level filter set for the buyer account representing bidder 123: `bidders/123/accounts/123` - For an account-level filter set for the child seat buyer account 456 whose bidder is 123: `bidders/123/accounts/456`",
+ "required": true,
+ "type": "string"
+ },
+ "isTransient": {
+ "type": "boolean",
+ "location": "query",
+ "description": "Whether the filter set is transient, or should be persisted indefinitely. By default, filter sets are not transient. If transient, it will be available for at least 1 hour after creation."
+ }
+ },
+ "description": "Creates the specified filter set for the account with the given account ID.",
+ "flatPath": "v2beta1/bidders/{biddersId}/filterSets",
+ "request": {
+ "$ref": "FilterSet"
+ },
+ "parameterOrder": [
+ "ownerName"
+ ],
+ "scopes": [
+ "https://www.googleapis.com/auth/adexchange.buyer"
+ ],
+ "response": {
+ "$ref": "FilterSet"
+ }
+ },
+ "delete": {
+ "response": {
+ "$ref": "Empty"
+ },
+ "scopes": [
+ "https://www.googleapis.com/auth/adexchange.buyer"
+ ],
+ "httpMethod": "DELETE",
+ "parameterOrder": [
+ "name"
+ ],
+ "path": "v2beta1/{+name}",
+ "flatPath": "v2beta1/bidders/{biddersId}/filterSets/{filterSetsId}",
+ "id": "adexchangebuyer2.bidders.filterSets.delete",
+ "parameters": {
+ "name": {
+ "required": true,
+ "pattern": "^bidders/[^/]+/filterSets/[^/]+$",
+ "type": "string",
+ "description": "Full name of the resource to delete. For example: - For a bidder-level filter set for bidder 123: `bidders/123/filterSets/abc` - For an account-level filter set for the buyer account representing bidder 123: `bidders/123/accounts/123/filterSets/abc` - For an account-level filter set for the child seat buyer account 456 whose bidder is 123: `bidders/123/accounts/456/filterSets/abc`",
+ "location": "path"
+ }
+ },
+ "description": "Deletes the requested filter set from the account with the given account ID."
+ }
+ },
+ "resources": {
+ "filteredBidRequests": {
+ "methods": {
+ "list": {
+ "flatPath": "v2beta1/bidders/{biddersId}/filterSets/{filterSetsId}/filteredBidRequests",
+ "id": "adexchangebuyer2.bidders.filterSets.filteredBidRequests.list",
+ "httpMethod": "GET",
+ "scopes": [
+ "https://www.googleapis.com/auth/adexchange.buyer"
+ ],
+ "path": "v2beta1/{+filterSetName}/filteredBidRequests",
+ "description": "List all reasons that caused a bid request not to be sent for an impression, with the number of bid requests not sent for each reason.",
+ "parameterOrder": [
+ "filterSetName"
+ ],
+ "parameters": {
+ "filterSetName": {
+ "pattern": "^bidders/[^/]+/filterSets/[^/]+$",
+ "location": "path",
+ "required": true,
+ "type": "string",
+ "description": "Name of the filter set that should be applied to the requested metrics. For example: - For a bidder-level filter set for bidder 123: `bidders/123/filterSets/abc` - For an account-level filter set for the buyer account representing bidder 123: `bidders/123/accounts/123/filterSets/abc` - For an account-level filter set for the child seat buyer account 456 whose bidder is 123: `bidders/123/accounts/456/filterSets/abc`"
+ },
+ "pageToken": {
+ "description": "A token identifying a page of results the server should return. Typically, this is the value of ListFilteredBidRequestsResponse.nextPageToken returned from the previous call to the filteredBidRequests.list method.",
+ "type": "string",
+ "location": "query"
+ },
+ "pageSize": {
+ "type": "integer",
+ "location": "query",
+ "description": "Requested page size. The server may return fewer results than requested. If unspecified, the server will pick an appropriate default.",
+ "format": "int32"
+ }
+ },
+ "response": {
+ "$ref": "ListFilteredBidRequestsResponse"
+ }
+ }
+ }
+ },
+ "impressionMetrics": {
+ "methods": {
+ "list": {
+ "response": {
+ "$ref": "ListImpressionMetricsResponse"
+ },
+ "description": "Lists all metrics that are measured in terms of number of impressions.",
+ "parameters": {
+ "filterSetName": {
+ "type": "string",
+ "description": "Name of the filter set that should be applied to the requested metrics. For example: - For a bidder-level filter set for bidder 123: `bidders/123/filterSets/abc` - For an account-level filter set for the buyer account representing bidder 123: `bidders/123/accounts/123/filterSets/abc` - For an account-level filter set for the child seat buyer account 456 whose bidder is 123: `bidders/123/accounts/456/filterSets/abc`",
+ "pattern": "^bidders/[^/]+/filterSets/[^/]+$",
+ "location": "path",
+ "required": true
+ },
+ "pageSize": {
+ "location": "query",
+ "type": "integer",
+ "format": "int32",
+ "description": "Requested page size. The server may return fewer results than requested. If unspecified, the server will pick an appropriate default."
+ },
+ "pageToken": {
+ "location": "query",
+ "description": "A token identifying a page of results the server should return. Typically, this is the value of ListImpressionMetricsResponse.nextPageToken returned from the previous call to the impressionMetrics.list method.",
+ "type": "string"
+ }
+ },
+ "path": "v2beta1/{+filterSetName}/impressionMetrics",
+ "id": "adexchangebuyer2.bidders.filterSets.impressionMetrics.list",
+ "flatPath": "v2beta1/bidders/{biddersId}/filterSets/{filterSetsId}/impressionMetrics",
+ "scopes": [
+ "https://www.googleapis.com/auth/adexchange.buyer"
+ ],
+ "parameterOrder": [
+ "filterSetName"
+ ],
+ "httpMethod": "GET"
+ }
+ }
+ },
+ "bidMetrics": {
+ "methods": {
+ "list": {
+ "scopes": [
+ "https://www.googleapis.com/auth/adexchange.buyer"
+ ],
+ "parameterOrder": [
+ "filterSetName"
+ ],
+ "parameters": {
+ "pageSize": {
+ "location": "query",
+ "type": "integer",
+ "description": "Requested page size. The server may return fewer results than requested. If unspecified, the server will pick an appropriate default.",
+ "format": "int32"
+ },
+ "pageToken": {
+ "description": "A token identifying a page of results the server should return. Typically, this is the value of ListBidMetricsResponse.nextPageToken returned from the previous call to the bidMetrics.list method.",
+ "location": "query",
+ "type": "string"
+ },
+ "filterSetName": {
+ "required": true,
+ "description": "Name of the filter set that should be applied to the requested metrics. For example: - For a bidder-level filter set for bidder 123: `bidders/123/filterSets/abc` - For an account-level filter set for the buyer account representing bidder 123: `bidders/123/accounts/123/filterSets/abc` - For an account-level filter set for the child seat buyer account 456 whose bidder is 123: `bidders/123/accounts/456/filterSets/abc`",
+ "pattern": "^bidders/[^/]+/filterSets/[^/]+$",
+ "location": "path",
+ "type": "string"
+ }
+ },
+ "id": "adexchangebuyer2.bidders.filterSets.bidMetrics.list",
+ "response": {
+ "$ref": "ListBidMetricsResponse"
+ },
+ "httpMethod": "GET",
+ "description": "Lists all metrics that are measured in terms of number of bids.",
+ "path": "v2beta1/{+filterSetName}/bidMetrics",
+ "flatPath": "v2beta1/bidders/{biddersId}/filterSets/{filterSetsId}/bidMetrics"
+ }
+ }
+ },
+ "bidResponseErrors": {
+ "methods": {
+ "list": {
+ "parameters": {
+ "pageToken": {
+ "location": "query",
+ "description": "A token identifying a page of results the server should return. Typically, this is the value of ListBidResponseErrorsResponse.nextPageToken returned from the previous call to the bidResponseErrors.list method.",
+ "type": "string"
+ },
+ "pageSize": {
+ "location": "query",
+ "description": "Requested page size. The server may return fewer results than requested. If unspecified, the server will pick an appropriate default.",
+ "type": "integer",
+ "format": "int32"
+ },
+ "filterSetName": {
+ "required": true,
+ "location": "path",
+ "description": "Name of the filter set that should be applied to the requested metrics. For example: - For a bidder-level filter set for bidder 123: `bidders/123/filterSets/abc` - For an account-level filter set for the buyer account representing bidder 123: `bidders/123/accounts/123/filterSets/abc` - For an account-level filter set for the child seat buyer account 456 whose bidder is 123: `bidders/123/accounts/456/filterSets/abc`",
+ "pattern": "^bidders/[^/]+/filterSets/[^/]+$",
+ "type": "string"
+ }
+ },
+ "parameterOrder": [
+ "filterSetName"
+ ],
+ "httpMethod": "GET",
+ "id": "adexchangebuyer2.bidders.filterSets.bidResponseErrors.list",
+ "path": "v2beta1/{+filterSetName}/bidResponseErrors",
+ "flatPath": "v2beta1/bidders/{biddersId}/filterSets/{filterSetsId}/bidResponseErrors",
+ "scopes": [
+ "https://www.googleapis.com/auth/adexchange.buyer"
+ ],
+ "description": "List all errors that occurred in bid responses, with the number of bid responses affected for each reason.",
+ "response": {
+ "$ref": "ListBidResponseErrorsResponse"
+ }
+ }
+ }
+ },
+ "nonBillableWinningBids": {
+ "methods": {
+ "list": {
+ "path": "v2beta1/{+filterSetName}/nonBillableWinningBids",
+ "flatPath": "v2beta1/bidders/{biddersId}/filterSets/{filterSetsId}/nonBillableWinningBids",
+ "id": "adexchangebuyer2.bidders.filterSets.nonBillableWinningBids.list",
+ "httpMethod": "GET",
+ "response": {
+ "$ref": "ListNonBillableWinningBidsResponse"
+ },
+ "scopes": [
+ "https://www.googleapis.com/auth/adexchange.buyer"
+ ],
+ "parameterOrder": [
+ "filterSetName"
+ ],
+ "parameters": {
+ "filterSetName": {
+ "pattern": "^bidders/[^/]+/filterSets/[^/]+$",
+ "required": true,
+ "location": "path",
+ "description": "Name of the filter set that should be applied to the requested metrics. For example: - For a bidder-level filter set for bidder 123: `bidders/123/filterSets/abc` - For an account-level filter set for the buyer account representing bidder 123: `bidders/123/accounts/123/filterSets/abc` - For an account-level filter set for the child seat buyer account 456 whose bidder is 123: `bidders/123/accounts/456/filterSets/abc`",
+ "type": "string"
+ },
+ "pageToken": {
+ "description": "A token identifying a page of results the server should return. Typically, this is the value of ListNonBillableWinningBidsResponse.nextPageToken returned from the previous call to the nonBillableWinningBids.list method.",
+ "type": "string",
+ "location": "query"
+ },
+ "pageSize": {
+ "location": "query",
+ "format": "int32",
+ "type": "integer",
+ "description": "Requested page size. The server may return fewer results than requested. If unspecified, the server will pick an appropriate default."
+ }
+ },
+ "description": "List all reasons for which winning bids were not billable, with the number of bids not billed for each reason."
+ }
+ }
+ },
+ "losingBids": {
+ "methods": {
+ "list": {
+ "parameterOrder": [
+ "filterSetName"
+ ],
+ "scopes": [
+ "https://www.googleapis.com/auth/adexchange.buyer"
+ ],
+ "description": "List all reasons for which bids lost in the auction, with the number of bids that lost for each reason.",
+ "httpMethod": "GET",
+ "response": {
+ "$ref": "ListLosingBidsResponse"
+ },
+ "id": "adexchangebuyer2.bidders.filterSets.losingBids.list",
+ "path": "v2beta1/{+filterSetName}/losingBids",
+ "parameters": {
+ "pageToken": {
+ "type": "string",
+ "description": "A token identifying a page of results the server should return. Typically, this is the value of ListLosingBidsResponse.nextPageToken returned from the previous call to the losingBids.list method.",
+ "location": "query"
+ },
+ "filterSetName": {
+ "location": "path",
+ "description": "Name of the filter set that should be applied to the requested metrics. For example: - For a bidder-level filter set for bidder 123: `bidders/123/filterSets/abc` - For an account-level filter set for the buyer account representing bidder 123: `bidders/123/accounts/123/filterSets/abc` - For an account-level filter set for the child seat buyer account 456 whose bidder is 123: `bidders/123/accounts/456/filterSets/abc`",
+ "type": "string",
+ "required": true,
+ "pattern": "^bidders/[^/]+/filterSets/[^/]+$"
+ },
+ "pageSize": {
+ "format": "int32",
+ "location": "query",
+ "description": "Requested page size. The server may return fewer results than requested. If unspecified, the server will pick an appropriate default.",
+ "type": "integer"
+ }
+ },
+ "flatPath": "v2beta1/bidders/{biddersId}/filterSets/{filterSetsId}/losingBids"
+ }
+ }
+ },
+ "bidResponsesWithoutBids": {
+ "methods": {
+ "list": {
+ "parameters": {
+ "pageToken": {
+ "type": "string",
+ "description": "A token identifying a page of results the server should return. Typically, this is the value of ListBidResponsesWithoutBidsResponse.nextPageToken returned from the previous call to the bidResponsesWithoutBids.list method.",
+ "location": "query"
+ },
+ "pageSize": {
+ "location": "query",
+ "description": "Requested page size. The server may return fewer results than requested. If unspecified, the server will pick an appropriate default.",
+ "format": "int32",
+ "type": "integer"
+ },
+ "filterSetName": {
+ "required": true,
+ "location": "path",
+ "type": "string",
+ "pattern": "^bidders/[^/]+/filterSets/[^/]+$",
+ "description": "Name of the filter set that should be applied to the requested metrics. For example: - For a bidder-level filter set for bidder 123: `bidders/123/filterSets/abc` - For an account-level filter set for the buyer account representing bidder 123: `bidders/123/accounts/123/filterSets/abc` - For an account-level filter set for the child seat buyer account 456 whose bidder is 123: `bidders/123/accounts/456/filterSets/abc`"
+ }
+ },
+ "description": "List all reasons for which bid responses were considered to have no applicable bids, with the number of bid responses affected for each reason.",
+ "scopes": [
+ "https://www.googleapis.com/auth/adexchange.buyer"
+ ],
+ "parameterOrder": [
+ "filterSetName"
+ ],
+ "flatPath": "v2beta1/bidders/{biddersId}/filterSets/{filterSetsId}/bidResponsesWithoutBids",
+ "id": "adexchangebuyer2.bidders.filterSets.bidResponsesWithoutBids.list",
+ "httpMethod": "GET",
+ "path": "v2beta1/{+filterSetName}/bidResponsesWithoutBids",
+ "response": {
+ "$ref": "ListBidResponsesWithoutBidsResponse"
+ }
+ }
+ }
+ },
+ "filteredBids": {
+ "resources": {
+ "creatives": {
+ "methods": {
+ "list": {
+ "parameters": {
+ "filterSetName": {
+ "type": "string",
+ "description": "Name of the filter set that should be applied to the requested metrics. For example: - For a bidder-level filter set for bidder 123: `bidders/123/filterSets/abc` - For an account-level filter set for the buyer account representing bidder 123: `bidders/123/accounts/123/filterSets/abc` - For an account-level filter set for the child seat buyer account 456 whose bidder is 123: `bidders/123/accounts/456/filterSets/abc`",
+ "pattern": "^bidders/[^/]+/filterSets/[^/]+$",
+ "required": true,
+ "location": "path"
+ },
+ "pageToken": {
+ "description": "A token identifying a page of results the server should return. Typically, this is the value of ListCreativeStatusBreakdownByCreativeResponse.nextPageToken returned from the previous call to the filteredBids.creatives.list method.",
+ "type": "string",
+ "location": "query"
+ },
+ "creativeStatusId": {
+ "format": "int32",
+ "required": true,
+ "type": "integer",
+ "description": "The ID of the creative status for which to retrieve a breakdown by creative. See [creative-status-codes](https://developers.google.com/authorized-buyers/rtb/downloads/creative-status-codes).",
+ "location": "path"
+ },
+ "pageSize": {
+ "format": "int32",
+ "description": "Requested page size. The server may return fewer results than requested. If unspecified, the server will pick an appropriate default.",
+ "type": "integer",
+ "location": "query"
+ }
+ },
+ "id": "adexchangebuyer2.bidders.filterSets.filteredBids.creatives.list",
+ "httpMethod": "GET",
+ "scopes": [
+ "https://www.googleapis.com/auth/adexchange.buyer"
+ ],
+ "response": {
+ "$ref": "ListCreativeStatusBreakdownByCreativeResponse"
+ },
+ "parameterOrder": [
+ "filterSetName",
+ "creativeStatusId"
+ ],
+ "path": "v2beta1/{+filterSetName}/filteredBids/{creativeStatusId}/creatives",
+ "flatPath": "v2beta1/bidders/{biddersId}/filterSets/{filterSetsId}/filteredBids/{creativeStatusId}/creatives",
+ "description": "List all creatives associated with a specific reason for which bids were filtered, with the number of bids filtered for each creative."
+ }
+ }
+ },
+ "details": {
+ "methods": {
+ "list": {
+ "response": {
+ "$ref": "ListCreativeStatusBreakdownByDetailResponse"
+ },
+ "id": "adexchangebuyer2.bidders.filterSets.filteredBids.details.list",
+ "path": "v2beta1/{+filterSetName}/filteredBids/{creativeStatusId}/details",
+ "httpMethod": "GET",
+ "description": "List all details associated with a specific reason for which bids were filtered, with the number of bids filtered for each detail.",
+ "flatPath": "v2beta1/bidders/{biddersId}/filterSets/{filterSetsId}/filteredBids/{creativeStatusId}/details",
+ "parameterOrder": [
+ "filterSetName",
+ "creativeStatusId"
+ ],
+ "scopes": [
+ "https://www.googleapis.com/auth/adexchange.buyer"
+ ],
+ "parameters": {
+ "creativeStatusId": {
+ "format": "int32",
+ "description": "The ID of the creative status for which to retrieve a breakdown by detail. See [creative-status-codes](https://developers.google.com/authorized-buyers/rtb/downloads/creative-status-codes). Details are only available for statuses 10, 14, 15, 17, 18, 19, 86, and 87.",
+ "location": "path",
+ "type": "integer",
+ "required": true
+ },
+ "pageToken": {
+ "description": "A token identifying a page of results the server should return. Typically, this is the value of ListCreativeStatusBreakdownByDetailResponse.nextPageToken returned from the previous call to the filteredBids.details.list method.",
+ "type": "string",
+ "location": "query"
+ },
+ "filterSetName": {
+ "location": "path",
+ "description": "Name of the filter set that should be applied to the requested metrics. For example: - For a bidder-level filter set for bidder 123: `bidders/123/filterSets/abc` - For an account-level filter set for the buyer account representing bidder 123: `bidders/123/accounts/123/filterSets/abc` - For an account-level filter set for the child seat buyer account 456 whose bidder is 123: `bidders/123/accounts/456/filterSets/abc`",
+ "pattern": "^bidders/[^/]+/filterSets/[^/]+$",
+ "type": "string",
+ "required": true
+ },
+ "pageSize": {
+ "format": "int32",
+ "type": "integer",
+ "description": "Requested page size. The server may return fewer results than requested. If unspecified, the server will pick an appropriate default.",
+ "location": "query"
+ }
+ }
+ }
+ }
+ }
+ },
+ "methods": {
+ "list": {
+ "flatPath": "v2beta1/bidders/{biddersId}/filterSets/{filterSetsId}/filteredBids",
+ "scopes": [
+ "https://www.googleapis.com/auth/adexchange.buyer"
+ ],
+ "parameters": {
+ "pageToken": {
+ "type": "string",
+ "description": "A token identifying a page of results the server should return. Typically, this is the value of ListFilteredBidsResponse.nextPageToken returned from the previous call to the filteredBids.list method.",
+ "location": "query"
+ },
+ "filterSetName": {
+ "pattern": "^bidders/[^/]+/filterSets/[^/]+$",
+ "type": "string",
+ "description": "Name of the filter set that should be applied to the requested metrics. For example: - For a bidder-level filter set for bidder 123: `bidders/123/filterSets/abc` - For an account-level filter set for the buyer account representing bidder 123: `bidders/123/accounts/123/filterSets/abc` - For an account-level filter set for the child seat buyer account 456 whose bidder is 123: `bidders/123/accounts/456/filterSets/abc`",
+ "location": "path",
+ "required": true
+ },
+ "pageSize": {
+ "format": "int32",
+ "type": "integer",
+ "description": "Requested page size. The server may return fewer results than requested. If unspecified, the server will pick an appropriate default.",
+ "location": "query"
+ }
+ },
+ "id": "adexchangebuyer2.bidders.filterSets.filteredBids.list",
+ "httpMethod": "GET",
+ "parameterOrder": [
+ "filterSetName"
+ ],
+ "path": "v2beta1/{+filterSetName}/filteredBids",
+ "description": "List all reasons for which bids were filtered, with the number of bids filtered for each reason.",
+ "response": {
+ "$ref": "ListFilteredBidsResponse"
+ }
+ }
+ }
+ }
+ }
+ },
+ "accounts": {
+ "resources": {
+ "filterSets": {
+ "methods": {
+ "list": {
+ "response": {
+ "$ref": "ListFilterSetsResponse"
+ },
+ "httpMethod": "GET",
+ "path": "v2beta1/{+ownerName}/filterSets",
+ "description": "Lists all filter sets for the account with the given account ID.",
+ "id": "adexchangebuyer2.bidders.accounts.filterSets.list",
+ "scopes": [
+ "https://www.googleapis.com/auth/adexchange.buyer"
+ ],
+ "flatPath": "v2beta1/bidders/{biddersId}/accounts/{accountsId}/filterSets",
+ "parameters": {
+ "pageSize": {
+ "location": "query",
+ "format": "int32",
+ "description": "Requested page size. The server may return fewer results than requested. If unspecified, the server will pick an appropriate default.",
+ "type": "integer"
+ },
+ "ownerName": {
+ "description": "Name of the owner (bidder or account) of the filter sets to be listed. For example: - For a bidder-level filter set for bidder 123: `bidders/123` - For an account-level filter set for the buyer account representing bidder 123: `bidders/123/accounts/123` - For an account-level filter set for the child seat buyer account 456 whose bidder is 123: `bidders/123/accounts/456`",
+ "required": true,
+ "location": "path",
+ "pattern": "^bidders/[^/]+/accounts/[^/]+$",
+ "type": "string"
+ },
+ "pageToken": {
+ "type": "string",
+ "location": "query",
+ "description": "A token identifying a page of results the server should return. Typically, this is the value of ListFilterSetsResponse.nextPageToken returned from the previous call to the accounts.filterSets.list method."
+ }
+ },
+ "parameterOrder": [
+ "ownerName"
+ ]
+ },
+ "get": {
+ "httpMethod": "GET",
+ "scopes": [
+ "https://www.googleapis.com/auth/adexchange.buyer"
+ ],
+ "response": {
+ "$ref": "FilterSet"
+ },
+ "path": "v2beta1/{+name}",
+ "flatPath": "v2beta1/bidders/{biddersId}/accounts/{accountsId}/filterSets/{filterSetsId}",
+ "parameterOrder": [
+ "name"
+ ],
+ "parameters": {
+ "name": {
+ "location": "path",
+ "type": "string",
+ "required": true,
+ "description": "Full name of the resource being requested. For example: - For a bidder-level filter set for bidder 123: `bidders/123/filterSets/abc` - For an account-level filter set for the buyer account representing bidder 123: `bidders/123/accounts/123/filterSets/abc` - For an account-level filter set for the child seat buyer account 456 whose bidder is 123: `bidders/123/accounts/456/filterSets/abc`",
+ "pattern": "^bidders/[^/]+/accounts/[^/]+/filterSets/[^/]+$"
+ }
+ },
+ "description": "Retrieves the requested filter set for the account with the given account ID.",
+ "id": "adexchangebuyer2.bidders.accounts.filterSets.get"
+ },
+ "create": {
+ "parameters": {
+ "isTransient": {
+ "description": "Whether the filter set is transient, or should be persisted indefinitely. By default, filter sets are not transient. If transient, it will be available for at least 1 hour after creation.",
+ "type": "boolean",
+ "location": "query"
+ },
+ "ownerName": {
+ "pattern": "^bidders/[^/]+/accounts/[^/]+$",
+ "type": "string",
+ "location": "path",
+ "required": true,
+ "description": "Name of the owner (bidder or account) of the filter set to be created. For example: - For a bidder-level filter set for bidder 123: `bidders/123` - For an account-level filter set for the buyer account representing bidder 123: `bidders/123/accounts/123` - For an account-level filter set for the child seat buyer account 456 whose bidder is 123: `bidders/123/accounts/456`"
+ }
+ },
+ "flatPath": "v2beta1/bidders/{biddersId}/accounts/{accountsId}/filterSets",
+ "response": {
+ "$ref": "FilterSet"
+ },
+ "path": "v2beta1/{+ownerName}/filterSets",
+ "request": {
+ "$ref": "FilterSet"
+ },
+ "scopes": [
+ "https://www.googleapis.com/auth/adexchange.buyer"
+ ],
+ "httpMethod": "POST",
+ "description": "Creates the specified filter set for the account with the given account ID.",
+ "id": "adexchangebuyer2.bidders.accounts.filterSets.create",
+ "parameterOrder": [
+ "ownerName"
+ ]
+ },
+ "delete": {
+ "id": "adexchangebuyer2.bidders.accounts.filterSets.delete",
+ "description": "Deletes the requested filter set from the account with the given account ID.",
+ "parameters": {
+ "name": {
+ "type": "string",
+ "required": true,
+ "location": "path",
+ "pattern": "^bidders/[^/]+/accounts/[^/]+/filterSets/[^/]+$",
+ "description": "Full name of the resource to delete. For example: - For a bidder-level filter set for bidder 123: `bidders/123/filterSets/abc` - For an account-level filter set for the buyer account representing bidder 123: `bidders/123/accounts/123/filterSets/abc` - For an account-level filter set for the child seat buyer account 456 whose bidder is 123: `bidders/123/accounts/456/filterSets/abc`"
+ }
+ },
+ "parameterOrder": [
+ "name"
+ ],
+ "httpMethod": "DELETE",
+ "scopes": [
+ "https://www.googleapis.com/auth/adexchange.buyer"
+ ],
+ "flatPath": "v2beta1/bidders/{biddersId}/accounts/{accountsId}/filterSets/{filterSetsId}",
+ "path": "v2beta1/{+name}",
+ "response": {
+ "$ref": "Empty"
+ }
+ }
+ },
+ "resources": {
+ "nonBillableWinningBids": {
+ "methods": {
+ "list": {
+ "scopes": [
+ "https://www.googleapis.com/auth/adexchange.buyer"
+ ],
+ "description": "List all reasons for which winning bids were not billable, with the number of bids not billed for each reason.",
+ "flatPath": "v2beta1/bidders/{biddersId}/accounts/{accountsId}/filterSets/{filterSetsId}/nonBillableWinningBids",
+ "id": "adexchangebuyer2.bidders.accounts.filterSets.nonBillableWinningBids.list",
+ "parameters": {
+ "filterSetName": {
+ "pattern": "^bidders/[^/]+/accounts/[^/]+/filterSets/[^/]+$",
+ "type": "string",
+ "description": "Name of the filter set that should be applied to the requested metrics. For example: - For a bidder-level filter set for bidder 123: `bidders/123/filterSets/abc` - For an account-level filter set for the buyer account representing bidder 123: `bidders/123/accounts/123/filterSets/abc` - For an account-level filter set for the child seat buyer account 456 whose bidder is 123: `bidders/123/accounts/456/filterSets/abc`",
+ "location": "path",
+ "required": true
+ },
+ "pageToken": {
+ "type": "string",
+ "description": "A token identifying a page of results the server should return. Typically, this is the value of ListNonBillableWinningBidsResponse.nextPageToken returned from the previous call to the nonBillableWinningBids.list method.",
+ "location": "query"
+ },
+ "pageSize": {
+ "format": "int32",
+ "description": "Requested page size. The server may return fewer results than requested. If unspecified, the server will pick an appropriate default.",
+ "type": "integer",
+ "location": "query"
+ }
+ },
+ "path": "v2beta1/{+filterSetName}/nonBillableWinningBids",
+ "response": {
+ "$ref": "ListNonBillableWinningBidsResponse"
+ },
+ "httpMethod": "GET",
+ "parameterOrder": [
+ "filterSetName"
+ ]
+ }
+ }
+ },
+ "bidResponsesWithoutBids": {
+ "methods": {
+ "list": {
+ "flatPath": "v2beta1/bidders/{biddersId}/accounts/{accountsId}/filterSets/{filterSetsId}/bidResponsesWithoutBids",
+ "path": "v2beta1/{+filterSetName}/bidResponsesWithoutBids",
+ "httpMethod": "GET",
+ "scopes": [
+ "https://www.googleapis.com/auth/adexchange.buyer"
+ ],
+ "description": "List all reasons for which bid responses were considered to have no applicable bids, with the number of bid responses affected for each reason.",
+ "response": {
+ "$ref": "ListBidResponsesWithoutBidsResponse"
+ },
+ "id": "adexchangebuyer2.bidders.accounts.filterSets.bidResponsesWithoutBids.list",
+ "parameters": {
+ "pageSize": {
+ "type": "integer",
+ "location": "query",
+ "format": "int32",
+ "description": "Requested page size. The server may return fewer results than requested. If unspecified, the server will pick an appropriate default."
+ },
+ "pageToken": {
+ "type": "string",
+ "location": "query",
+ "description": "A token identifying a page of results the server should return. Typically, this is the value of ListBidResponsesWithoutBidsResponse.nextPageToken returned from the previous call to the bidResponsesWithoutBids.list method."
+ },
+ "filterSetName": {
+ "type": "string",
+ "location": "path",
+ "pattern": "^bidders/[^/]+/accounts/[^/]+/filterSets/[^/]+$",
+ "description": "Name of the filter set that should be applied to the requested metrics. For example: - For a bidder-level filter set for bidder 123: `bidders/123/filterSets/abc` - For an account-level filter set for the buyer account representing bidder 123: `bidders/123/accounts/123/filterSets/abc` - For an account-level filter set for the child seat buyer account 456 whose bidder is 123: `bidders/123/accounts/456/filterSets/abc`",
+ "required": true
+ }
+ },
+ "parameterOrder": [
+ "filterSetName"
+ ]
+ }
+ }
+ },
+ "filteredBidRequests": {
+ "methods": {
+ "list": {
+ "response": {
+ "$ref": "ListFilteredBidRequestsResponse"
+ },
+ "description": "List all reasons that caused a bid request not to be sent for an impression, with the number of bid requests not sent for each reason.",
+ "path": "v2beta1/{+filterSetName}/filteredBidRequests",
+ "parameters": {
+ "pageSize": {
+ "location": "query",
+ "description": "Requested page size. The server may return fewer results than requested. If unspecified, the server will pick an appropriate default.",
+ "format": "int32",
+ "type": "integer"
+ },
+ "pageToken": {
+ "location": "query",
+ "description": "A token identifying a page of results the server should return. Typically, this is the value of ListFilteredBidRequestsResponse.nextPageToken returned from the previous call to the filteredBidRequests.list method.",
+ "type": "string"
+ },
+ "filterSetName": {
+ "pattern": "^bidders/[^/]+/accounts/[^/]+/filterSets/[^/]+$",
+ "required": true,
+ "location": "path",
+ "type": "string",
+ "description": "Name of the filter set that should be applied to the requested metrics. For example: - For a bidder-level filter set for bidder 123: `bidders/123/filterSets/abc` - For an account-level filter set for the buyer account representing bidder 123: `bidders/123/accounts/123/filterSets/abc` - For an account-level filter set for the child seat buyer account 456 whose bidder is 123: `bidders/123/accounts/456/filterSets/abc`"
+ }
+ },
+ "id": "adexchangebuyer2.bidders.accounts.filterSets.filteredBidRequests.list",
+ "parameterOrder": [
+ "filterSetName"
+ ],
+ "scopes": [
+ "https://www.googleapis.com/auth/adexchange.buyer"
+ ],
+ "flatPath": "v2beta1/bidders/{biddersId}/accounts/{accountsId}/filterSets/{filterSetsId}/filteredBidRequests",
+ "httpMethod": "GET"
+ }
+ }
+ },
+ "bidResponseErrors": {
+ "methods": {
+ "list": {
+ "id": "adexchangebuyer2.bidders.accounts.filterSets.bidResponseErrors.list",
+ "httpMethod": "GET",
+ "path": "v2beta1/{+filterSetName}/bidResponseErrors",
+ "parameterOrder": [
+ "filterSetName"
+ ],
+ "scopes": [
+ "https://www.googleapis.com/auth/adexchange.buyer"
+ ],
+ "parameters": {
+ "pageSize": {
+ "format": "int32",
+ "description": "Requested page size. The server may return fewer results than requested. If unspecified, the server will pick an appropriate default.",
+ "type": "integer",
+ "location": "query"
+ },
+ "filterSetName": {
+ "description": "Name of the filter set that should be applied to the requested metrics. For example: - For a bidder-level filter set for bidder 123: `bidders/123/filterSets/abc` - For an account-level filter set for the buyer account representing bidder 123: `bidders/123/accounts/123/filterSets/abc` - For an account-level filter set for the child seat buyer account 456 whose bidder is 123: `bidders/123/accounts/456/filterSets/abc`",
+ "type": "string",
+ "location": "path",
+ "pattern": "^bidders/[^/]+/accounts/[^/]+/filterSets/[^/]+$",
+ "required": true
+ },
+ "pageToken": {
+ "type": "string",
+ "description": "A token identifying a page of results the server should return. Typically, this is the value of ListBidResponseErrorsResponse.nextPageToken returned from the previous call to the bidResponseErrors.list method.",
+ "location": "query"
+ }
+ },
+ "description": "List all errors that occurred in bid responses, with the number of bid responses affected for each reason.",
+ "flatPath": "v2beta1/bidders/{biddersId}/accounts/{accountsId}/filterSets/{filterSetsId}/bidResponseErrors",
+ "response": {
+ "$ref": "ListBidResponseErrorsResponse"
+ }
+ }
+ }
+ },
+ "bidMetrics": {
+ "methods": {
+ "list": {
+ "httpMethod": "GET",
+ "id": "adexchangebuyer2.bidders.accounts.filterSets.bidMetrics.list",
+ "description": "Lists all metrics that are measured in terms of number of bids.",
+ "flatPath": "v2beta1/bidders/{biddersId}/accounts/{accountsId}/filterSets/{filterSetsId}/bidMetrics",
+ "path": "v2beta1/{+filterSetName}/bidMetrics",
+ "response": {
+ "$ref": "ListBidMetricsResponse"
+ },
+ "parameterOrder": [
+ "filterSetName"
+ ],
+ "parameters": {
+ "filterSetName": {
+ "type": "string",
+ "location": "path",
+ "pattern": "^bidders/[^/]+/accounts/[^/]+/filterSets/[^/]+$",
+ "required": true,
+ "description": "Name of the filter set that should be applied to the requested metrics. For example: - For a bidder-level filter set for bidder 123: `bidders/123/filterSets/abc` - For an account-level filter set for the buyer account representing bidder 123: `bidders/123/accounts/123/filterSets/abc` - For an account-level filter set for the child seat buyer account 456 whose bidder is 123: `bidders/123/accounts/456/filterSets/abc`"
+ },
+ "pageSize": {
+ "type": "integer",
+ "location": "query",
+ "description": "Requested page size. The server may return fewer results than requested. If unspecified, the server will pick an appropriate default.",
+ "format": "int32"
+ },
+ "pageToken": {
+ "type": "string",
+ "location": "query",
+ "description": "A token identifying a page of results the server should return. Typically, this is the value of ListBidMetricsResponse.nextPageToken returned from the previous call to the bidMetrics.list method."
+ }
+ },
+ "scopes": [
+ "https://www.googleapis.com/auth/adexchange.buyer"
+ ]
+ }
+ }
+ },
+ "impressionMetrics": {
+ "methods": {
+ "list": {
+ "path": "v2beta1/{+filterSetName}/impressionMetrics",
+ "httpMethod": "GET",
+ "flatPath": "v2beta1/bidders/{biddersId}/accounts/{accountsId}/filterSets/{filterSetsId}/impressionMetrics",
+ "id": "adexchangebuyer2.bidders.accounts.filterSets.impressionMetrics.list",
+ "response": {
+ "$ref": "ListImpressionMetricsResponse"
+ },
+ "parameters": {
+ "pageSize": {
+ "description": "Requested page size. The server may return fewer results than requested. If unspecified, the server will pick an appropriate default.",
+ "format": "int32",
+ "type": "integer",
+ "location": "query"
+ },
+ "pageToken": {
+ "type": "string",
+ "description": "A token identifying a page of results the server should return. Typically, this is the value of ListImpressionMetricsResponse.nextPageToken returned from the previous call to the impressionMetrics.list method.",
+ "location": "query"
+ },
+ "filterSetName": {
+ "location": "path",
+ "description": "Name of the filter set that should be applied to the requested metrics. For example: - For a bidder-level filter set for bidder 123: `bidders/123/filterSets/abc` - For an account-level filter set for the buyer account representing bidder 123: `bidders/123/accounts/123/filterSets/abc` - For an account-level filter set for the child seat buyer account 456 whose bidder is 123: `bidders/123/accounts/456/filterSets/abc`",
+ "type": "string",
+ "pattern": "^bidders/[^/]+/accounts/[^/]+/filterSets/[^/]+$",
+ "required": true
+ }
+ },
+ "description": "Lists all metrics that are measured in terms of number of impressions.",
+ "scopes": [
+ "https://www.googleapis.com/auth/adexchange.buyer"
+ ],
+ "parameterOrder": [
+ "filterSetName"
+ ]
+ }
+ }
+ },
+ "losingBids": {
+ "methods": {
+ "list": {
+ "id": "adexchangebuyer2.bidders.accounts.filterSets.losingBids.list",
+ "description": "List all reasons for which bids lost in the auction, with the number of bids that lost for each reason.",
+ "flatPath": "v2beta1/bidders/{biddersId}/accounts/{accountsId}/filterSets/{filterSetsId}/losingBids",
+ "response": {
+ "$ref": "ListLosingBidsResponse"
+ },
+ "parameterOrder": [
+ "filterSetName"
+ ],
+ "parameters": {
+ "filterSetName": {
+ "type": "string",
+ "location": "path",
+ "pattern": "^bidders/[^/]+/accounts/[^/]+/filterSets/[^/]+$",
+ "required": true,
+ "description": "Name of the filter set that should be applied to the requested metrics. For example: - For a bidder-level filter set for bidder 123: `bidders/123/filterSets/abc` - For an account-level filter set for the buyer account representing bidder 123: `bidders/123/accounts/123/filterSets/abc` - For an account-level filter set for the child seat buyer account 456 whose bidder is 123: `bidders/123/accounts/456/filterSets/abc`"
+ },
+ "pageSize": {
+ "format": "int32",
+ "type": "integer",
+ "location": "query",
+ "description": "Requested page size. The server may return fewer results than requested. If unspecified, the server will pick an appropriate default."
+ },
+ "pageToken": {
+ "type": "string",
+ "location": "query",
+ "description": "A token identifying a page of results the server should return. Typically, this is the value of ListLosingBidsResponse.nextPageToken returned from the previous call to the losingBids.list method."
+ }
+ },
+ "scopes": [
+ "https://www.googleapis.com/auth/adexchange.buyer"
+ ],
+ "path": "v2beta1/{+filterSetName}/losingBids",
+ "httpMethod": "GET"
+ }
+ }
+ },
+ "filteredBids": {
+ "methods": {
+ "list": {
+ "parameters": {
+ "pageSize": {
+ "description": "Requested page size. The server may return fewer results than requested. If unspecified, the server will pick an appropriate default.",
+ "type": "integer",
+ "location": "query",
+ "format": "int32"
+ },
+ "filterSetName": {
+ "location": "path",
+ "description": "Name of the filter set that should be applied to the requested metrics. For example: - For a bidder-level filter set for bidder 123: `bidders/123/filterSets/abc` - For an account-level filter set for the buyer account representing bidder 123: `bidders/123/accounts/123/filterSets/abc` - For an account-level filter set for the child seat buyer account 456 whose bidder is 123: `bidders/123/accounts/456/filterSets/abc`",
+ "pattern": "^bidders/[^/]+/accounts/[^/]+/filterSets/[^/]+$",
+ "type": "string",
+ "required": true
+ },
+ "pageToken": {
+ "description": "A token identifying a page of results the server should return. Typically, this is the value of ListFilteredBidsResponse.nextPageToken returned from the previous call to the filteredBids.list method.",
+ "type": "string",
+ "location": "query"
+ }
+ },
+ "flatPath": "v2beta1/bidders/{biddersId}/accounts/{accountsId}/filterSets/{filterSetsId}/filteredBids",
+ "parameterOrder": [
+ "filterSetName"
+ ],
+ "path": "v2beta1/{+filterSetName}/filteredBids",
+ "httpMethod": "GET",
+ "id": "adexchangebuyer2.bidders.accounts.filterSets.filteredBids.list",
+ "response": {
+ "$ref": "ListFilteredBidsResponse"
+ },
+ "scopes": [
+ "https://www.googleapis.com/auth/adexchange.buyer"
+ ],
+ "description": "List all reasons for which bids were filtered, with the number of bids filtered for each reason."
+ }
+ },
+ "resources": {
+ "creatives": {
+ "methods": {
+ "list": {
+ "description": "List all creatives associated with a specific reason for which bids were filtered, with the number of bids filtered for each creative.",
+ "httpMethod": "GET",
+ "parameterOrder": [
+ "filterSetName",
+ "creativeStatusId"
+ ],
+ "flatPath": "v2beta1/bidders/{biddersId}/accounts/{accountsId}/filterSets/{filterSetsId}/filteredBids/{creativeStatusId}/creatives",
+ "response": {
+ "$ref": "ListCreativeStatusBreakdownByCreativeResponse"
+ },
+ "parameters": {
+ "filterSetName": {
+ "required": true,
+ "type": "string",
+ "pattern": "^bidders/[^/]+/accounts/[^/]+/filterSets/[^/]+$",
+ "description": "Name of the filter set that should be applied to the requested metrics. For example: - For a bidder-level filter set for bidder 123: `bidders/123/filterSets/abc` - For an account-level filter set for the buyer account representing bidder 123: `bidders/123/accounts/123/filterSets/abc` - For an account-level filter set for the child seat buyer account 456 whose bidder is 123: `bidders/123/accounts/456/filterSets/abc`",
+ "location": "path"
+ },
+ "pageSize": {
+ "description": "Requested page size. The server may return fewer results than requested. If unspecified, the server will pick an appropriate default.",
+ "type": "integer",
+ "location": "query",
+ "format": "int32"
+ },
+ "pageToken": {
+ "type": "string",
+ "description": "A token identifying a page of results the server should return. Typically, this is the value of ListCreativeStatusBreakdownByCreativeResponse.nextPageToken returned from the previous call to the filteredBids.creatives.list method.",
+ "location": "query"
+ },
+ "creativeStatusId": {
+ "required": true,
+ "description": "The ID of the creative status for which to retrieve a breakdown by creative. See [creative-status-codes](https://developers.google.com/authorized-buyers/rtb/downloads/creative-status-codes).",
+ "location": "path",
+ "format": "int32",
+ "type": "integer"
+ }
+ },
+ "id": "adexchangebuyer2.bidders.accounts.filterSets.filteredBids.creatives.list",
+ "path": "v2beta1/{+filterSetName}/filteredBids/{creativeStatusId}/creatives",
+ "scopes": [
+ "https://www.googleapis.com/auth/adexchange.buyer"
+ ]
+ }
+ }
+ },
+ "details": {
+ "methods": {
+ "list": {
+ "scopes": [
+ "https://www.googleapis.com/auth/adexchange.buyer"
+ ],
+ "flatPath": "v2beta1/bidders/{biddersId}/accounts/{accountsId}/filterSets/{filterSetsId}/filteredBids/{creativeStatusId}/details",
+ "response": {
+ "$ref": "ListCreativeStatusBreakdownByDetailResponse"
+ },
+ "path": "v2beta1/{+filterSetName}/filteredBids/{creativeStatusId}/details",
+ "description": "List all details associated with a specific reason for which bids were filtered, with the number of bids filtered for each detail.",
+ "parameters": {
+ "pageToken": {
+ "type": "string",
+ "description": "A token identifying a page of results the server should return. Typically, this is the value of ListCreativeStatusBreakdownByDetailResponse.nextPageToken returned from the previous call to the filteredBids.details.list method.",
+ "location": "query"
+ },
+ "pageSize": {
+ "type": "integer",
+ "location": "query",
+ "format": "int32",
+ "description": "Requested page size. The server may return fewer results than requested. If unspecified, the server will pick an appropriate default."
+ },
+ "filterSetName": {
+ "location": "path",
+ "pattern": "^bidders/[^/]+/accounts/[^/]+/filterSets/[^/]+$",
+ "type": "string",
+ "description": "Name of the filter set that should be applied to the requested metrics. For example: - For a bidder-level filter set for bidder 123: `bidders/123/filterSets/abc` - For an account-level filter set for the buyer account representing bidder 123: `bidders/123/accounts/123/filterSets/abc` - For an account-level filter set for the child seat buyer account 456 whose bidder is 123: `bidders/123/accounts/456/filterSets/abc`",
+ "required": true
+ },
+ "creativeStatusId": {
+ "location": "path",
+ "required": true,
+ "description": "The ID of the creative status for which to retrieve a breakdown by detail. See [creative-status-codes](https://developers.google.com/authorized-buyers/rtb/downloads/creative-status-codes). Details are only available for statuses 10, 14, 15, 17, 18, 19, 86, and 87.",
+ "type": "integer",
+ "format": "int32"
+ }
+ },
+ "httpMethod": "GET",
+ "id": "adexchangebuyer2.bidders.accounts.filterSets.filteredBids.details.list",
+ "parameterOrder": [
+ "filterSetName",
+ "creativeStatusId"
+ ]
+ }
+ }
+ }
+ }
+ }
+ }
+ }
+ }
+ }
+ }
+ }
+ },
+ "parameters": {
+ "callback": {
+ "description": "JSONP",
+ "type": "string",
+ "location": "query"
+ },
+ "quotaUser": {
+ "type": "string",
+ "description": "Available to use for quota purposes for server-side applications. Can be any arbitrary string assigned to a user, but should not exceed 40 characters.",
+ "location": "query"
+ },
+ "fields": {
+ "description": "Selector specifying which fields to include in a partial response.",
+ "location": "query",
+ "type": "string"
+ },
+ "prettyPrint": {
+ "location": "query",
+ "default": "true",
+ "type": "boolean",
+ "description": "Returns response with indentations and line breaks."
+ },
+ "alt": {
+ "type": "string",
+ "description": "Data format for response.",
+ "enumDescriptions": [
+ "Responses with Content-Type of application/json",
+ "Media download with context-dependent Content-Type",
+ "Responses with Content-Type of application/x-protobuf"
+ ],
+ "enum": [
+ "json",
+ "media",
+ "proto"
+ ],
+ "location": "query",
+ "default": "json"
+ },
+ "key": {
+ "location": "query",
+ "description": "API key. Your API key identifies your project and provides you with API access, quota, and reports. Required unless you provide an OAuth 2.0 token.",
+ "type": "string"
+ },
+ "$.xgafv": {
+ "type": "string",
+ "location": "query",
+ "description": "V1 error format.",
+ "enum": [
+ "1",
+ "2"
+ ],
+ "enumDescriptions": [
+ "v1 error format",
+ "v2 error format"
+ ]
+ },
+ "upload_protocol": {
+ "location": "query",
+ "description": "Upload protocol for media (e.g. \"raw\", \"multipart\").",
+ "type": "string"
+ },
+ "oauth_token": {
+ "description": "OAuth 2.0 token for the current user.",
+ "location": "query",
+ "type": "string"
+ },
+ "access_token": {
+ "location": "query",
+ "type": "string",
+ "description": "OAuth access token."
+ },
+ "uploadType": {
+ "type": "string",
+ "description": "Legacy upload protocol for media (e.g. \"media\", \"multipart\").",
+ "location": "query"
+ }
+ },
+ "protocol": "rest",
+ "basePath": "",
+ "auth": {
+ "oauth2": {
+ "scopes": {
+ "https://www.googleapis.com/auth/adexchange.buyer": {
+ "description": "Manage your Ad Exchange buyer account configuration"
+ }
+ }
+ }
+ },
+ "ownerDomain": "google.com",
+ "baseUrl": "https://adexchangebuyer.googleapis.com/",
+ "version_module": true,
+ "batchPath": "batch",
+ "name": "adexchangebuyer2",
+ "revision": "20201118",
+ "servicePath": "",
+ "version": "v2beta1",
+ "documentationLink": "https://developers.google.com/authorized-buyers/apis/reference/rest/",
+ "ownerName": "Google",
+ "id": "adexchangebuyer2:v2beta1",
+ "rootUrl": "https://adexchangebuyer.googleapis.com/",
+ "discoveryVersion": "v1",
+ "description": "Accesses the latest features for managing Authorized Buyers accounts, Real-Time Bidding configurations and auction metrics, and Marketplace programmatic deals.",
+ "canonicalName": "AdExchangeBuyerII",
+ "kind": "discovery#restDescription",
+ "schemas": {
+ "PauseProposalRequest": {
+ "description": "Request message to pause serving for an already-finalized proposal.",
+ "id": "PauseProposalRequest",
+ "type": "object",
+ "properties": {
+ "reason": {
+ "type": "string",
+ "description": "The reason why the proposal is being paused. This human readable message will be displayed in the seller's UI. (Max length: 1000 unicode code units.)"
+ }
+ }
+ },
+ "FilteredBidDetailRow": {
+ "properties": {
+ "rowDimensions": {
+ "$ref": "RowDimensions",
+ "description": "The values of all dimensions associated with metric values in this row."
+ },
+ "detail": {
+ "description": "The ID of the detail, can be numeric or text. The associated value can be looked up in the dictionary file corresponding to the DetailType in the response message.",
+ "type": "string"
+ },
+ "detailId": {
+ "format": "int32",
+ "type": "integer",
+ "description": "Note: this field will be deprecated, use \"detail\" field instead. When \"detail\" field represents an integer value, this field is populated as the same integer value \"detail\" field represents, otherwise this field will be 0. The ID of the detail. The associated value can be looked up in the dictionary file corresponding to the DetailType in the response message."
+ },
+ "bidCount": {
+ "description": "The number of bids with the specified detail.",
+ "$ref": "MetricValue"
+ }
+ },
+ "type": "object",
+ "id": "FilteredBidDetailRow",
+ "description": "The number of filtered bids with the specified dimension values, among those filtered due to the requested filtering reason (i.e. creative status), that have the specified detail."
+ },
+ "Empty": {
+ "id": "Empty",
+ "type": "object",
+ "description": "A generic empty message that you can re-use to avoid defining duplicated empty messages in your APIs. A typical example is to use it as the request or the response type of an API method. For instance: service Foo { rpc Bar(google.protobuf.Empty) returns (google.protobuf.Empty); } The JSON representation for `Empty` is empty JSON object `{}`.",
+ "properties": {}
+ },
+ "ListProductsResponse": {
+ "type": "object",
+ "id": "ListProductsResponse",
+ "description": "Response message for listing products visible to the buyer.",
+ "properties": {
+ "products": {
+ "type": "array",
+ "items": {
+ "$ref": "Product"
+ },
+ "description": "The list of matching products at their head revision number."
+ },
+ "nextPageToken": {
+ "type": "string",
+ "description": "List pagination support."
+ }
+ }
+ },
+ "CreativeRestrictions": {
+ "type": "object",
+ "id": "CreativeRestrictions",
+ "description": "Represents creative restrictions associated to Programmatic Guaranteed/ Preferred Deal in Ad Manager. This doesn't apply to Private Auction and AdX Preferred Deals.",
+ "properties": {
+ "skippableAdType": {
+ "enum": [
+ "SKIPPABLE_AD_TYPE_UNSPECIFIED",
+ "SKIPPABLE",
+ "INSTREAM_SELECT",
+ "NOT_SKIPPABLE"
+ ],
+ "description": "Skippable video ads allow viewers to skip ads after 5 seconds.",
+ "type": "string",
+ "enumDescriptions": [
+ "A placeholder for an undefined skippable ad type.",
+ "This video ad can be skipped after 5 seconds.",
+ "This video ad can be skipped after 5 seconds, and is counted as engaged view after 30 seconds. The creative is hosted on YouTube only, and viewcount of the YouTube video increments after the engaged view.",
+ "This video ad is not skippable."
+ ]
+ },
+ "creativeSpecifications": {
+ "type": "array",
+ "items": {
+ "$ref": "CreativeSpecification"
+ }
+ },
+ "creativeFormat": {
+ "enumDescriptions": [
+ "A placeholder for an undefined creative format.",
+ "A creative that will be displayed in environments such as a browser.",
+ "A video creative that will be displayed in environments such as a video player."
+ ],
+ "enum": [
+ "CREATIVE_FORMAT_UNSPECIFIED",
+ "DISPLAY",
+ "VIDEO"
+ ],
+ "type": "string",
+ "description": "The format of the environment that the creatives will be displayed in."
+ }
+ }
+ },
+ "ListBidResponsesWithoutBidsResponse": {
+ "id": "ListBidResponsesWithoutBidsResponse",
+ "properties": {
+ "nextPageToken": {
+ "type": "string",
+ "description": "A token to retrieve the next page of results. Pass this value in the ListBidResponsesWithoutBidsRequest.pageToken field in the subsequent call to the bidResponsesWithoutBids.list method to retrieve the next page of results."
+ },
+ "bidResponseWithoutBidsStatusRows": {
+ "description": "List of rows, with counts of bid responses without bids aggregated by status.",
+ "type": "array",
+ "items": {
+ "$ref": "BidResponseWithoutBidsStatusRow"
+ }
+ }
+ },
+ "type": "object",
+ "description": "Response message for listing all reasons that bid responses were considered to have no applicable bids."
+ },
+ "PrivateData": {
+ "id": "PrivateData",
+ "description": "Buyers are allowed to store certain types of private data in a proposal/deal.",
+ "type": "object",
+ "properties": {
+ "referenceId": {
+ "type": "string",
+ "description": "A buyer or seller specified reference ID. This can be queried in the list operations (max-length: 1024 unicode code units)."
+ }
+ }
+ },
+ "RealtimeTimeRange": {
+ "id": "RealtimeTimeRange",
+ "type": "object",
+ "properties": {
+ "startTimestamp": {
+ "type": "string",
+ "format": "google-datetime",
+ "description": "The start timestamp of the real-time RTB metrics aggregation."
+ }
+ },
+ "description": "An open-ended realtime time range specified by the start timestamp. For filter sets that specify a realtime time range RTB metrics continue to be aggregated throughout the lifetime of the filter set."
+ },
+ "StopWatchingCreativeRequest": {
+ "id": "StopWatchingCreativeRequest",
+ "properties": {},
+ "type": "object",
+ "description": "A request for stopping notifications for changes to creative Status."
+ },
+ "RowDimensions": {
+ "type": "object",
+ "id": "RowDimensions",
+ "properties": {
+ "publisherIdentifier": {
+ "type": "string",
+ "description": "The publisher identifier for this row, if a breakdown by [BreakdownDimension.PUBLISHER_IDENTIFIER](https://developers.google.com/authorized-buyers/apis/reference/rest/v2beta1/bidders.accounts.filterSets#FilterSet.BreakdownDimension) was requested."
+ },
+ "timeInterval": {
+ "$ref": "TimeInterval",
+ "description": "The time interval that this row represents."
+ }
+ },
+ "description": "A response may include multiple rows, breaking down along various dimensions. Encapsulates the values of all dimensions for a given row."
+ },
+ "ListCreativeStatusBreakdownByCreativeResponse": {
+ "type": "object",
+ "id": "ListCreativeStatusBreakdownByCreativeResponse",
+ "properties": {
+ "nextPageToken": {
+ "description": "A token to retrieve the next page of results. Pass this value in the ListCreativeStatusBreakdownByCreativeRequest.pageToken field in the subsequent call to the filteredBids.creatives.list method to retrieve the next page of results.",
+ "type": "string"
+ },
+ "filteredBidCreativeRows": {
+ "description": "List of rows, with counts of bids with a given creative status aggregated by creative.",
+ "items": {
+ "$ref": "FilteredBidCreativeRow"
+ },
+ "type": "array"
+ }
+ },
+ "description": "Response message for listing all creatives associated with a given filtered bid reason."
+ },
+ "ListPublisherProfilesResponse": {
+ "description": "Response message for profiles visible to the buyer.",
+ "id": "ListPublisherProfilesResponse",
+ "type": "object",
+ "properties": {
+ "publisherProfiles": {
+ "items": {
+ "$ref": "PublisherProfile"
+ },
+ "type": "array",
+ "description": "The list of matching publisher profiles."
+ },
+ "nextPageToken": {
+ "type": "string",
+ "description": "List pagination support"
+ }
+ }
+ },
+ "FilteredBidCreativeRow": {
+ "id": "FilteredBidCreativeRow",
+ "type": "object",
+ "description": "The number of filtered bids with the specified dimension values that have the specified creative.",
+ "properties": {
+ "creativeId": {
+ "description": "The ID of the creative.",
+ "type": "string"
+ },
+ "bidCount": {
+ "description": "The number of bids with the specified creative.",
+ "$ref": "MetricValue"
+ },
+ "rowDimensions": {
+ "description": "The values of all dimensions associated with metric values in this row.",
+ "$ref": "RowDimensions"
+ }
+ }
+ },
+ "PublisherProfileMobileApplication": {
+ "properties": {
+ "externalAppId": {
+ "description": "The external ID for the app from its app store.",
+ "type": "string"
+ },
+ "appStore": {
+ "enumDescriptions": [
+ "A placeholder for an unknown app store.",
+ "Apple iTunes",
+ "Google Play",
+ "Roku",
+ "Amazon Fire TV",
+ "Playstation",
+ "Xbox",
+ "Samsung TV",
+ "Amazon Appstore",
+ "OPPO App Market",
+ "Samsung Galaxy Store",
+ "VIVO App Store",
+ "Xiaomi GetApps"
+ ],
+ "description": "The app store the app belongs to.",
+ "type": "string",
+ "enum": [
+ "APP_STORE_TYPE_UNSPECIFIED",
+ "APPLE_ITUNES",
+ "GOOGLE_PLAY",
+ "ROKU",
+ "AMAZON_FIRETV",
+ "PLAYSTATION",
+ "XBOX",
+ "SAMSUNG_TV",
+ "AMAZON",
+ "OPPO",
+ "SAMSUNG",
+ "VIVO",
+ "XIAOMI"
+ ]
+ },
+ "name": {
+ "type": "string",
+ "description": "The name of the app."
+ }
+ },
+ "type": "object",
+ "description": "A mobile application that contains a external app ID, name, and app store.",
+ "id": "PublisherProfileMobileApplication"
+ },
+ "FirstPartyMobileApplicationTargeting": {
+ "description": "Represents a list of targeted and excluded mobile application IDs that publishers own. Mobile application IDs are from App Store and Google Play Store. Android App ID, for example, com.google.android.apps.maps, can be found in Google Play Store URL. iOS App ID (which is a number) can be found at the end of iTunes store URL. First party mobile applications is either included or excluded.",
+ "type": "object",
+ "properties": {
+ "targetedAppIds": {
+ "type": "array",
+ "items": {
+ "type": "string"
+ },
+ "description": "A list of application IDs to be included."
+ },
+ "excludedAppIds": {
+ "items": {
+ "type": "string"
+ },
+ "description": "A list of application IDs to be excluded.",
+ "type": "array"
+ }
+ },
+ "id": "FirstPartyMobileApplicationTargeting"
+ },
+ "NonGuaranteedAuctionTerms": {
+ "id": "NonGuaranteedAuctionTerms",
+ "properties": {
+ "reservePricesPerBuyer": {
+ "description": "Reserve price for the specified buyer.",
+ "items": {
+ "$ref": "PricePerBuyer"
+ },
+ "type": "array"
+ },
+ "autoOptimizePrivateAuction": {
+ "description": "True if open auction buyers are allowed to compete with invited buyers in this private auction.",
+ "type": "boolean"
+ }
+ },
+ "type": "object",
+ "description": "Terms for Private Auctions. Note that Private Auctions can be created only by the seller, but they can be returned in a get or list request."
+ },
+ "Image": {
+ "properties": {
+ "width": {
+ "type": "integer",
+ "format": "int32",
+ "description": "Image width in pixels."
+ },
+ "height": {
+ "type": "integer",
+ "format": "int32",
+ "description": "Image height in pixels."
+ },
+ "url": {
+ "description": "The URL of the image.",
+ "type": "string"
+ }
+ },
+ "type": "object",
+ "id": "Image",
+ "description": "An image resource. You may provide a larger image than was requested, so long as the aspect ratio is preserved."
+ },
+ "AdSize": {
+ "id": "AdSize",
+ "properties": {
+ "sizeType": {
+ "type": "string",
+ "enumDescriptions": [
+ "A placeholder for an undefined size type.",
+ "Ad slot with size specified by height and width in pixels.",
+ "Special size to describe an interstitial ad slot.",
+ "Native (mobile) ads rendered by the publisher.",
+ "Fluid size (i.e., responsive size) can be resized automatically with the change of outside environment."
+ ],
+ "description": "The size type of the ad slot.",
+ "enum": [
+ "SIZE_TYPE_UNSPECIFIED",
+ "PIXEL",
+ "INTERSTITIAL",
+ "NATIVE",
+ "FLUID"
+ ]
+ },
+ "width": {
+ "description": "The width of the ad slot in pixels. This field will be present only when size type is `PIXEL`.",
+ "format": "int64",
+ "type": "string"
+ },
+ "height": {
+ "format": "int64",
+ "description": "The height of the ad slot in pixels. This field will be present only when size type is `PIXEL`.",
+ "type": "string"
+ }
+ },
+ "type": "object",
+ "description": "Represents size of a single ad slot, or a creative."
+ },
+ "ServingRestriction": {
+ "properties": {
+ "status": {
+ "enumDescriptions": [
+ "The status is not known.",
+ "The ad was disapproved in this context.",
+ "The ad is pending review in this context."
+ ],
+ "enum": [
+ "STATUS_UNSPECIFIED",
+ "DISAPPROVAL",
+ "PENDING_REVIEW"
+ ],
+ "type": "string",
+ "description": "The status of the creative in this context (for example, it has been explicitly disapproved or is pending review)."
+ },
+ "disapproval": {
+ "$ref": "Disapproval",
+ "description": "Disapproval bound to this restriction. Only present if status=DISAPPROVED. Can be used to filter the response of the creatives.list method."
+ },
+ "contexts": {
+ "items": {
+ "$ref": "ServingContext"
+ },
+ "type": "array",
+ "description": "The contexts for the restriction."
+ },
+ "disapprovalReasons": {
+ "type": "array",
+ "description": "Any disapprovals bound to this restriction. Only present if status=DISAPPROVED. Can be used to filter the response of the creatives.list method. Deprecated; please use disapproval field instead.",
+ "items": {
+ "$ref": "Disapproval"
+ }
+ }
+ },
+ "id": "ServingRestriction",
+ "type": "object",
+ "description": "Output only. A representation of the status of an ad in a specific context. A context here relates to where something ultimately serves (for example, a user or publisher geo, a platform, an HTTPS vs HTTP request, or the type of auction)."
+ },
+ "DayPart": {
+ "properties": {
+ "endTime": {
+ "description": "The ending time of the day for the ad to show (minute level granularity). The end time is exclusive. This field is not available for filtering in PQL queries.",
+ "$ref": "TimeOfDay"
+ },
+ "startTime": {
+ "description": "The starting time of day for the ad to show (minute level granularity). The start time is inclusive. This field is not available for filtering in PQL queries.",
+ "$ref": "TimeOfDay"
+ },
+ "dayOfWeek": {
+ "enumDescriptions": [
+ "A placeholder for when the day of the week is not specified.",
+ "Monday",
+ "Tuesday",
+ "Wednesday",
+ "Thursday",
+ "Friday",
+ "Saturday",
+ "Sunday"
+ ],
+ "type": "string",
+ "enum": [
+ "DAY_OF_WEEK_UNSPECIFIED",
+ "MONDAY",
+ "TUESDAY",
+ "WEDNESDAY",
+ "THURSDAY",
+ "FRIDAY",
+ "SATURDAY",
+ "SUNDAY"
+ ],
+ "description": "The day of the week to target. If unspecified, applicable to all days."
+ }
+ },
+ "description": "Daypart targeting message that specifies if the ad can be shown only during certain parts of a day/week.",
+ "type": "object",
+ "id": "DayPart"
+ },
+ "ClientUserInvitation": {
+ "properties": {
+ "clientAccountId": {
+ "format": "int64",
+ "description": "Numerical account ID of the client buyer that the invited user is associated with. The value of this field is ignored in create operations.",
+ "type": "string"
+ },
+ "invitationId": {
+ "format": "int64",
+ "description": "The unique numerical ID of the invitation that is sent to the user. The value of this field is ignored in create operations.",
+ "type": "string"
+ },
+ "email": {
+ "description": "The email address to which the invitation is sent. Email addresses should be unique among all client users under each sponsor buyer.",
+ "type": "string"
+ }
+ },
+ "id": "ClientUserInvitation",
+ "description": "An invitation for a new client user to get access to the Authorized Buyers UI. All fields are required unless otherwise specified.",
+ "type": "object"
+ },
+ "Disapproval": {
+ "description": "Output only. The reason and details for a disapproval.",
+ "type": "object",
+ "properties": {
+ "reason": {
+ "enumDescriptions": [
+ "The length of the image animation is longer than allowed.",
+ "The click through URL doesn't work properly.",
+ "Something is wrong with the creative itself.",
+ "The ad makes a fourth party call to an unapproved vendor.",
+ "The ad targets consumers using remarketing lists and/or collects data for subsequent use in retargeting, but does not correctly declare that use.",
+ "Clicking on the ad leads to an error page.",
+ "The ad size when rendered does not match the declaration.",
+ "Ads with a white background require a border, which was missing.",
+ "The creative attempts to set cookies from a fourth party that is not certified.",
+ "The creative sets an LSO object.",
+ "The ad serves a blank.",
+ "The ad uses rotation, but not all destination URLs were declared.",
+ "There is a problem with the way the click macro is used.",
+ "The ad technology declaration is not accurate.",
+ "The actual destination URL does not match the declared destination URL.",
+ "The declared expanding direction does not match the actual direction.",
+ "The ad does not expand in a supported direction.",
+ "The ad uses an expandable vendor that is not supported.",
+ "There was an issue with the expandable ad.",
+ "The ad uses a video vendor that is not supported.",
+ "The length of the video ad is not supported.",
+ "The format of the video ad is not supported.",
+ "There was an issue with the video ad.",
+ "The landing page does not conform to Ad Exchange policy.",
+ "The ad or the landing page may contain malware.",
+ "The ad contains adult images or video content.",
+ "The ad contains text that is unclear or inaccurate.",
+ "The ad promotes counterfeit designer goods.",
+ "The ad causes a popup window to appear.",
+ "The creative does not follow policies set for the RTB protocol.",
+ "The ad contains a URL that uses a numeric IP address for the domain.",
+ "The ad or landing page contains unacceptable content because it initiated a software or executable download.",
+ "The ad set an unauthorized cookie on a Google domain.",
+ "Flash content found when no flash was declared.",
+ "SSL support declared but not working correctly.",
+ "Rich Media - Direct Download in Ad (ex. PDF download).",
+ "Maximum download size exceeded.",
+ "Bad Destination URL: Site Not Crawlable.",
+ "Bad URL: Legal disapproval.",
+ "Pharmaceuticals, Gambling, Alcohol not allowed and at least one was detected.",
+ "Dynamic DNS at Destination URL.",
+ "Poor Image / Video Quality.",
+ "For example, Image Trick to Click.",
+ "Incorrect Image Layout.",
+ "Irrelevant Image / Video.",
+ "Broken back button.",
+ "Misleading/Inaccurate claims in ads.",
+ "Restricted Products.",
+ "Unacceptable content. For example, malware.",
+ "The ad automatically redirects to the destination site without a click, or reports a click when none were made.",
+ "The ad uses URL protocols that do not exist or are not allowed on AdX.",
+ "Restricted content (for example, alcohol) was found in the ad but not declared.",
+ "Violation of the remarketing list policy.",
+ "The destination site's robot.txt file prevents it from being crawled.",
+ "Click to download must link to an app.",
+ "A review extension must be an accurate review.",
+ "Sexually explicit content.",
+ "The ad tries to gain an unfair traffic advantage.",
+ "The ad tries to circumvent Google's advertising systems.",
+ "The ad promotes dangerous knives.",
+ "The ad promotes explosives.",
+ "The ad promotes guns & parts.",
+ "The ad promotes recreational drugs/services & related equipment.",
+ "The ad promotes tobacco products/services & related equipment.",
+ "The ad promotes weapons.",
+ "The ad is unclear or irrelevant to the destination site.",
+ "The ad does not meet professional standards.",
+ "The promotion is unnecessarily difficult to navigate.",
+ "Violation of Google's policy for interest-based ads.",
+ "Misuse of personal information.",
+ "Omission of relevant information.",
+ "Unavailable promotions.",
+ "Misleading or unrealistic promotions.",
+ "Offensive or inappropriate content.",
+ "Capitalizing on sensitive events.",
+ "Shocking content.",
+ "Products & Services that enable dishonest behavior.",
+ "The ad does not meet technical requirements.",
+ "Restricted political content.",
+ "Unsupported content.",
+ "Invalid bidding method.",
+ "Video length exceeds limits.",
+ "Unacceptable content: Japanese healthcare.",
+ "Online pharmacy ID required.",
+ "Unacceptable content: Abortion.",
+ "Unacceptable content: Birth control.",
+ "Restricted in China.",
+ "Unacceptable content: Korean healthcare.",
+ "Non-family safe or adult content.",
+ "Clinical trial recruitment.",
+ "Maximum number of HTTP calls exceeded.",
+ "Maximum number of cookies exceeded.",
+ "Financial service ad does not adhere to specifications.",
+ "Flash content was found in an unsupported context.",
+ "Misuse by an Open Measurement SDK script.",
+ "Use of an Open Measurement SDK vendor not on approved whitelist.",
+ "Unacceptable landing page.",
+ "Unsupported language.",
+ "Non-SSL compliant.",
+ "Temporary pausing of creative.",
+ "Promotes services related to bail bonds.",
+ "Promotes speculative and/or experimental medical treatments."
+ ],
+ "description": "The categorized reason for disapproval.",
+ "type": "string",
+ "enum": [
+ "LENGTH_OF_IMAGE_ANIMATION",
+ "BROKEN_URL",
+ "MEDIA_NOT_FUNCTIONAL",
+ "INVALID_FOURTH_PARTY_CALL",
+ "INCORRECT_REMARKETING_DECLARATION",
+ "LANDING_PAGE_ERROR",
+ "AD_SIZE_DOES_NOT_MATCH_AD_SLOT",
+ "NO_BORDER",
+ "FOURTH_PARTY_BROWSER_COOKIES",
+ "LSO_OBJECTS",
+ "BLANK_CREATIVE",
+ "DESTINATION_URLS_UNDECLARED",
+ "PROBLEM_WITH_CLICK_MACRO",
+ "INCORRECT_AD_TECHNOLOGY_DECLARATION",
+ "INCORRECT_DESTINATION_URL_DECLARATION",
+ "EXPANDABLE_INCORRECT_DIRECTION",
+ "EXPANDABLE_DIRECTION_NOT_SUPPORTED",
+ "EXPANDABLE_INVALID_VENDOR",
+ "EXPANDABLE_FUNCTIONALITY",
+ "VIDEO_INVALID_VENDOR",
+ "VIDEO_UNSUPPORTED_LENGTH",
+ "VIDEO_UNSUPPORTED_FORMAT",
+ "VIDEO_FUNCTIONALITY",
+ "LANDING_PAGE_DISABLED",
+ "MALWARE_SUSPECTED",
+ "ADULT_IMAGE_OR_VIDEO",
+ "INACCURATE_AD_TEXT",
+ "COUNTERFEIT_DESIGNER_GOODS",
+ "POP_UP",
+ "INVALID_RTB_PROTOCOL_USAGE",
+ "RAW_IP_ADDRESS_IN_SNIPPET",
+ "UNACCEPTABLE_CONTENT_SOFTWARE",
+ "UNAUTHORIZED_COOKIE_ON_GOOGLE_DOMAIN",
+ "UNDECLARED_FLASH_OBJECTS",
+ "INVALID_SSL_DECLARATION",
+ "DIRECT_DOWNLOAD_IN_AD",
+ "MAXIMUM_DOWNLOAD_SIZE_EXCEEDED",
+ "DESTINATION_URL_SITE_NOT_CRAWLABLE",
+ "BAD_URL_LEGAL_DISAPPROVAL",
+ "PHARMA_GAMBLING_ALCOHOL_NOT_ALLOWED",
+ "DYNAMIC_DNS_AT_DESTINATION_URL",
+ "POOR_IMAGE_OR_VIDEO_QUALITY",
+ "UNACCEPTABLE_IMAGE_CONTENT",
+ "INCORRECT_IMAGE_LAYOUT",
+ "IRRELEVANT_IMAGE_OR_VIDEO",
+ "DESTINATION_SITE_DOES_NOT_ALLOW_GOING_BACK",
+ "MISLEADING_CLAIMS_IN_AD",
+ "RESTRICTED_PRODUCTS",
+ "UNACCEPTABLE_CONTENT",
+ "AUTOMATED_AD_CLICKING",
+ "INVALID_URL_PROTOCOL",
+ "UNDECLARED_RESTRICTED_CONTENT",
+ "INVALID_REMARKETING_LIST_USAGE",
+ "DESTINATION_SITE_NOT_CRAWLABLE_ROBOTS_TXT",
+ "CLICK_TO_DOWNLOAD_NOT_AN_APP",
+ "INACCURATE_REVIEW_EXTENSION",
+ "SEXUALLY_EXPLICIT_CONTENT",
+ "GAINING_AN_UNFAIR_ADVANTAGE",
+ "GAMING_THE_GOOGLE_NETWORK",
+ "DANGEROUS_PRODUCTS_KNIVES",
+ "DANGEROUS_PRODUCTS_EXPLOSIVES",
+ "DANGEROUS_PRODUCTS_GUNS",
+ "DANGEROUS_PRODUCTS_DRUGS",
+ "DANGEROUS_PRODUCTS_TOBACCO",
+ "DANGEROUS_PRODUCTS_WEAPONS",
+ "UNCLEAR_OR_IRRELEVANT_AD",
+ "PROFESSIONAL_STANDARDS",
+ "DYSFUNCTIONAL_PROMOTION",
+ "INVALID_INTEREST_BASED_AD",
+ "MISUSE_OF_PERSONAL_INFORMATION",
+ "OMISSION_OF_RELEVANT_INFORMATION",
+ "UNAVAILABLE_PROMOTIONS",
+ "MISLEADING_PROMOTIONS",
+ "INAPPROPRIATE_CONTENT",
+ "SENSITIVE_EVENTS",
+ "SHOCKING_CONTENT",
+ "ENABLING_DISHONEST_BEHAVIOR",
+ "TECHNICAL_REQUIREMENTS",
+ "RESTRICTED_POLITICAL_CONTENT",
+ "UNSUPPORTED_CONTENT",
+ "INVALID_BIDDING_METHOD",
+ "VIDEO_TOO_LONG",
+ "VIOLATES_JAPANESE_PHARMACY_LAW",
+ "UNACCREDITED_PET_PHARMACY",
+ "ABORTION",
+ "CONTRACEPTIVES",
+ "NEED_CERTIFICATES_TO_ADVERTISE_IN_CHINA",
+ "KCDSP_REGISTRATION",
+ "NOT_FAMILY_SAFE",
+ "CLINICAL_TRIAL_RECRUITMENT",
+ "MAXIMUM_NUMBER_OF_HTTP_CALLS_EXCEEDED",
+ "MAXIMUM_NUMBER_OF_COOKIES_EXCEEDED",
+ "PERSONAL_LOANS",
+ "UNSUPPORTED_FLASH_CONTENT",
+ "MISUSE_BY_OMID_SCRIPT",
+ "NON_WHITELISTED_OMID_VENDOR",
+ "DESTINATION_EXPERIENCE",
+ "UNSUPPORTED_LANGUAGE",
+ "NON_SSL_COMPLIANT",
+ "TEMPORARY_PAUSE",
+ "BAIL_BONDS",
+ "EXPERIMENTAL_MEDICAL_TREATMENT"
+ ]
+ },
+ "details": {
+ "items": {
+ "type": "string"
+ },
+ "type": "array",
+ "description": "Additional details about the reason for disapproval."
+ }
+ },
+ "id": "Disapproval"
+ },
+ "Money": {
+ "properties": {
+ "units": {
+ "type": "string",
+ "format": "int64",
+ "description": "The whole units of the amount. For example if `currencyCode` is `\"USD\"`, then 1 unit is one US dollar."
+ },
+ "currencyCode": {
+ "type": "string",
+ "description": "The three-letter currency code defined in ISO 4217."
+ },
+ "nanos": {
+ "format": "int32",
+ "description": "Number of nano (10^-9) units of the amount. The value must be between -999,999,999 and +999,999,999 inclusive. If `units` is positive, `nanos` must be positive or zero. If `units` is zero, `nanos` can be positive, zero, or negative. If `units` is negative, `nanos` must be negative or zero. For example $-1.75 is represented as `units`=-1 and `nanos`=-750,000,000.",
+ "type": "integer"
+ }
+ },
+ "id": "Money",
+ "type": "object",
+ "description": "Represents an amount of money with its currency type."
+ },
+ "PricePerBuyer": {
+ "properties": {
+ "advertiserIds": {
+ "items": {
+ "type": "string"
+ },
+ "type": "array",
+ "description": "The list of advertisers for this price when associated with this buyer. If empty, all advertisers with this buyer pay this price."
+ },
+ "price": {
+ "$ref": "Price",
+ "description": "The specified price."
+ },
+ "buyer": {
+ "$ref": "Buyer",
+ "description": "The buyer who will pay this price. If unset, all buyers can pay this price (if the advertisers match, and there's no more specific rule matching the buyer)."
+ }
+ },
+ "description": "Used to specify pricing rules for buyers/advertisers. Each PricePerBuyer in a product can become 0 or 1 deals. To check if there is a PricePerBuyer for a particular buyer or buyer/advertiser pair, we look for the most specific matching rule - we first look for a rule matching the buyer and advertiser, next a rule with the buyer but an empty advertiser list, and otherwise look for a matching rule where no buyer is set.",
+ "id": "PricePerBuyer",
+ "type": "object"
+ },
+ "Deal": {
+ "type": "object",
+ "description": "A deal represents a segment of inventory for displaying ads on. A proposal can contain multiple deals. A deal contains the terms and targeting information that is used for serving.",
+ "id": "Deal",
+ "properties": {
+ "dealId": {
+ "type": "string",
+ "description": "Output only. A unique deal ID for the deal (server-assigned)."
+ },
+ "proposalId": {
+ "type": "string",
+ "description": "Output only. ID of the proposal that this deal is part of."
+ },
+ "createTime": {
+ "format": "google-datetime",
+ "description": "Output only. The time of the deal creation.",
+ "type": "string"
+ },
+ "sellerContacts": {
+ "type": "array",
+ "description": "Output only. Seller contact information for the deal.",
+ "items": {
+ "$ref": "ContactInformation"
+ }
+ },
+ "availableStartTime": {
+ "format": "google-datetime",
+ "description": "Optional proposed flight start time of the deal. This will generally be stored in the granularity of one second since deal serving starts at seconds boundary. Any time specified with more granularity (e.g., in milliseconds) will be truncated towards the start of time in seconds.",
+ "type": "string"
+ },
+ "dealTerms": {
+ "description": "The negotiable terms of the deal.",
+ "$ref": "DealTerms"
+ },
+ "createProductId": {
+ "type": "string",
+ "description": "The product ID from which this deal was created. Note: This field may be set only when creating the resource. Modifying this field while updating the resource will result in an error."
+ },
+ "creativePreApprovalPolicy": {
+ "type": "string",
+ "description": "Output only. Specifies the creative pre-approval policy.",
+ "enumDescriptions": [
+ "A placeholder for an undefined creative pre-approval policy.",
+ "The seller needs to approve each creative before it can serve.",
+ "The seller does not need to approve each creative before it can serve."
+ ],
+ "enum": [
+ "CREATIVE_PRE_APPROVAL_POLICY_UNSPECIFIED",
+ "SELLER_PRE_APPROVAL_REQUIRED",
+ "SELLER_PRE_APPROVAL_NOT_REQUIRED"
+ ]
+ },
+ "creativeSafeFrameCompatibility": {
+ "description": "Output only. Specifies whether the creative is safeFrame compatible.",
+ "type": "string",
+ "enumDescriptions": [
+ "A placeholder for an undefined creative safe-frame compatibility.",
+ "The creatives need to be compatible with the safe frame option.",
+ "The creatives can be incompatible with the safe frame option."
+ ],
+ "enum": [
+ "CREATIVE_SAFE_FRAME_COMPATIBILITY_UNSPECIFIED",
+ "COMPATIBLE",
+ "INCOMPATIBLE"
+ ]
+ },
+ "availableEndTime": {
+ "type": "string",
+ "description": "Proposed flight end time of the deal. This will generally be stored in a granularity of a second. A value is not required for Private Auction deals or Preferred Deals.",
+ "format": "google-datetime"
+ },
+ "buyerPrivateData": {
+ "description": "Buyer private data (hidden from seller).",
+ "$ref": "PrivateData"
+ },
+ "displayName": {
+ "description": "The name of the deal.",
+ "type": "string"
+ },
+ "targeting": {
+ "description": "Output only. Specifies the subset of inventory targeted by the deal.",
+ "$ref": "MarketplaceTargeting"
+ },
+ "externalDealId": {
+ "description": "Output only. The external deal ID assigned to this deal once the deal is finalized. This is the deal ID that shows up in serving/reporting etc.",
+ "type": "string"
+ },
+ "syndicationProduct": {
+ "enumDescriptions": [
+ "A placeholder for an undefined syndication product.",
+ "This typically represents a web page.",
+ "This represents a mobile property.",
+ "This represents video ad formats.",
+ "This represents ads shown within games."
+ ],
+ "enum": [
+ "SYNDICATION_PRODUCT_UNSPECIFIED",
+ "CONTENT",
+ "MOBILE",
+ "VIDEO",
+ "GAMES"
+ ],
+ "description": "The syndication product associated with the deal. Note: This field may be set only when creating the resource. Modifying this field while updating the resource will result in an error.",
+ "type": "string"
+ },
+ "deliveryControl": {
+ "description": "The set of fields around delivery control that are interesting for a buyer to see but are non-negotiable. These are set by the publisher.",
+ "$ref": "DeliveryControl"
+ },
+ "dealServingMetadata": {
+ "$ref": "DealServingMetadata",
+ "description": "Output only. Metadata about the serving status of this deal."
+ },
+ "description": {
+ "type": "string",
+ "description": "Description for the deal terms."
+ },
+ "createProductRevision": {
+ "format": "int64",
+ "type": "string",
+ "description": "Optional revision number of the product that the deal was created from. If present on create, and the server `product_revision` has advanced sinced the passed-in `create_product_revision`, an `ABORTED` error will be returned. Note: This field may be set only when creating the resource. Modifying this field while updating the resource will result in an error."
+ },
+ "webPropertyCode": {
+ "type": "string",
+ "description": "The web property code for the seller copied over from the product."
+ },
+ "updateTime": {
+ "format": "google-datetime",
+ "description": "Output only. The time when the deal was last updated.",
+ "type": "string"
+ },
+ "isSetupComplete": {
+ "description": "Output only. True, if the buyside inventory setup is complete for this deal.",
+ "type": "boolean"
+ },
+ "creativeRestrictions": {
+ "description": "Output only. Restricitions about the creatives associated with the deal (i.e., size) This is available for Programmatic Guaranteed/Preferred Deals in Ad Manager.",
+ "$ref": "CreativeRestrictions"
+ },
+ "programmaticCreativeSource": {
+ "description": "Output only. Specifies the creative source for programmatic deals. PUBLISHER means creative is provided by seller and ADVERTISER means creative is provided by buyer.",
+ "enum": [
+ "PROGRAMMATIC_CREATIVE_SOURCE_UNSPECIFIED",
+ "ADVERTISER",
+ "PUBLISHER"
+ ],
+ "enumDescriptions": [
+ "A placeholder for an undefined programmatic creative source.",
+ "The advertiser provides the creatives.",
+ "The publisher provides the creatives to be served."
+ ],
+ "type": "string"
+ },
+ "targetingCriterion": {
+ "items": {
+ "$ref": "TargetingCriteria"
+ },
+ "type": "array",
+ "description": "The shared targeting visible to buyers and sellers. Each shared targeting entity is AND'd together."
+ }
+ }
+ },
+ "Note": {
+ "description": "A proposal may be associated to several notes.",
+ "properties": {
+ "note": {
+ "type": "string",
+ "description": "The actual note to attach. (max-length: 1024 unicode code units) Note: This field may be set only when creating the resource. Modifying this field while updating the resource will result in an error."
+ },
+ "proposalRevision": {
+ "format": "int64",
+ "type": "string",
+ "description": "Output only. The revision number of the proposal when the note is created."
+ },
+ "noteId": {
+ "description": "Output only. The unique ID for the note.",
+ "type": "string"
+ },
+ "creatorRole": {
+ "type": "string",
+ "enum": [
+ "BUYER_SELLER_ROLE_UNSPECIFIED",
+ "BUYER",
+ "SELLER"
+ ],
+ "enumDescriptions": [
+ "A placeholder for an undefined buyer/seller role.",
+ "Specifies the role as buyer.",
+ "Specifies the role as seller."
+ ],
+ "description": "Output only. The role of the person (buyer/seller) creating the note."
+ },
+ "createTime": {
+ "format": "google-datetime",
+ "description": "Output only. The timestamp for when this note was created.",
+ "type": "string"
+ }
+ },
+ "id": "Note",
+ "type": "object"
+ },
+ "ListClientUsersResponse": {
+ "type": "object",
+ "id": "ListClientUsersResponse",
+ "properties": {
+ "nextPageToken": {
+ "description": "A token to retrieve the next page of results. Pass this value in the ListClientUsersRequest.pageToken field in the subsequent call to the clients.invitations.list method to retrieve the next page of results.",
+ "type": "string"
+ },
+ "users": {
+ "items": {
+ "$ref": "ClientUser"
+ },
+ "description": "The returned list of client users.",
+ "type": "array"
+ }
+ }
+ },
+ "NativeContent": {
+ "id": "NativeContent",
+ "description": "Native content for a creative.",
+ "type": "object",
+ "properties": {
+ "priceDisplayText": {
+ "type": "string",
+ "description": "The price of the promoted app including currency info."
+ },
+ "image": {
+ "$ref": "Image",
+ "description": "A large image."
+ },
+ "clickLinkUrl": {
+ "description": "The URL that the browser/SDK will load when the user clicks the ad.",
+ "type": "string"
+ },
+ "storeUrl": {
+ "description": "The URL to the app store to purchase/download the promoted app.",
+ "type": "string"
+ },
+ "videoUrl": {
+ "type": "string",
+ "description": "The URL to fetch a native video ad."
+ },
+ "clickTrackingUrl": {
+ "description": "The URL to use for click tracking.",
+ "type": "string"
+ },
+ "advertiserName": {
+ "type": "string",
+ "description": "The name of the advertiser or sponsor, to be displayed in the ad creative."
+ },
+ "logo": {
+ "description": "A smaller image, for the advertiser's logo.",
+ "$ref": "Image"
+ },
+ "body": {
+ "description": "A long description of the ad.",
+ "type": "string"
+ },
+ "callToAction": {
+ "type": "string",
+ "description": "A label for the button that the user is supposed to click."
+ },
+ "appIcon": {
+ "$ref": "Image",
+ "description": "The app icon, for app download ads."
+ },
+ "starRating": {
+ "type": "number",
+ "format": "double",
+ "description": "The app rating in the app store. Must be in the range [0-5]."
+ },
+ "headline": {
+ "description": "A short title for the ad.",
+ "type": "string"
+ }
+ }
+ },
+ "DealPauseStatus": {
+ "properties": {
+ "hasBuyerPaused": {
+ "description": "True, if the buyer has paused the deal unilaterally.",
+ "type": "boolean"
+ },
+ "firstPausedBy": {
+ "description": "The role of the person who first paused this deal.",
+ "type": "string",
+ "enum": [
+ "BUYER_SELLER_ROLE_UNSPECIFIED",
+ "BUYER",
+ "SELLER"
+ ],
+ "enumDescriptions": [
+ "A placeholder for an undefined buyer/seller role.",
+ "Specifies the role as buyer.",
+ "Specifies the role as seller."
+ ]
+ },
+ "buyerPauseReason": {
+ "description": "The buyer's reason for pausing, if the buyer paused the deal.",
+ "type": "string"
+ },
+ "hasSellerPaused": {
+ "type": "boolean",
+ "description": "True, if the seller has paused the deal unilaterally."
+ },
+ "sellerPauseReason": {
+ "description": "The seller's reason for pausing, if the seller paused the deal.",
+ "type": "string"
+ }
+ },
+ "id": "DealPauseStatus",
+ "type": "object",
+ "description": "Tracks which parties (if any) have paused a deal. The deal is considered paused if either hasBuyerPaused or hasSellPaused is true."
+ },
+ "CriteriaTargeting": {
+ "id": "CriteriaTargeting",
+ "type": "object",
+ "properties": {
+ "targetedCriteriaIds": {
+ "type": "array",
+ "description": "A list of numeric IDs to be included.",
+ "items": {
+ "format": "int64",
+ "type": "string"
+ }
+ },
+ "excludedCriteriaIds": {
+ "items": {
+ "format": "int64",
+ "type": "string"
+ },
+ "description": "A list of numeric IDs to be excluded.",
+ "type": "array"
+ }
+ },
+ "description": "Generic targeting used for targeting dimensions that contains a list of included and excluded numeric IDs."
+ },
+ "Date": {
+ "type": "object",
+ "properties": {
+ "year": {
+ "description": "Year of the date. Must be from 1 to 9999, or 0 to specify a date without a year.",
+ "type": "integer",
+ "format": "int32"
+ },
+ "day": {
+ "type": "integer",
+ "description": "Day of a month. Must be from 1 to 31 and valid for the year and month, or 0 to specify a year by itself or a year and month where the day isn't significant.",
+ "format": "int32"
+ },
+ "month": {
+ "type": "integer",
+ "format": "int32",
+ "description": "Month of a year. Must be from 1 to 12, or 0 to specify a year without a month and day."
+ }
+ },
+ "id": "Date",
+ "description": "Represents a whole or partial calendar date, such as a birthday. The time of day and time zone are either specified elsewhere or are insignificant. The date is relative to the Gregorian Calendar. This can represent one of the following: * A full date, with non-zero year, month, and day values * A month and day value, with a zero year, such as an anniversary * A year on its own, with zero month and day values * A year and month value, with a zero day, such as a credit card expiration date Related types are google.type.TimeOfDay and `google.protobuf.Timestamp`."
+ },
+ "FilterSet": {
+ "type": "object",
+ "id": "FilterSet",
+ "description": "A set of filters that is applied to a request for data. Within a filter set, an AND operation is performed across the filters represented by each field. An OR operation is performed across the filters represented by the multiple values of a repeated field, e.g., \"format=VIDEO AND deal_id=12 AND (seller_network_id=34 OR seller_network_id=56)\".",
+ "properties": {
+ "relativeDateRange": {
+ "$ref": "RelativeDateRange",
+ "description": "A relative date range, defined by an offset from today and a duration. Interpreted relative to Pacific time zone."
+ },
+ "format": {
+ "description": "Creative format bidded on or allowed to bid on, can be empty.",
+ "enumDescriptions": [
+ "A placeholder for an undefined format; indicates that no format filter will be applied.",
+ "The ad impression is a native ad, and display (i.e., image) format.",
+ "The ad impression is a native ad, and video format.",
+ "The ad impression is not a native ad, and display (i.e., image) format.",
+ "The ad impression is not a native ad, and video format."
+ ],
+ "enum": [
+ "FORMAT_UNSPECIFIED",
+ "NATIVE_DISPLAY",
+ "NATIVE_VIDEO",
+ "NON_NATIVE_DISPLAY",
+ "NON_NATIVE_VIDEO"
+ ],
+ "type": "string"
+ },
+ "breakdownDimensions": {
+ "description": "The set of dimensions along which to break down the response; may be empty. If multiple dimensions are requested, the breakdown is along the Cartesian product of the requested dimensions.",
+ "type": "array",
+ "items": {
+ "enumDescriptions": [
+ "A placeholder for an unspecified dimension; should not be used.",
+ "The response should be broken down by publisher identifier. This option is available only for Open Bidding buyers."
+ ],
+ "enum": [
+ "BREAKDOWN_DIMENSION_UNSPECIFIED",
+ "PUBLISHER_IDENTIFIER"
+ ],
+ "type": "string"
+ }
+ },
+ "name": {
+ "type": "string",
+ "description": "A user-defined name of the filter set. Filter set names must be unique globally and match one of the patterns: - `bidders/*/filterSets/*` (for accessing bidder-level troubleshooting data) - `bidders/*/accounts/*/filterSets/*` (for accessing account-level troubleshooting data) This field is required in create operations."
+ },
+ "absoluteDateRange": {
+ "$ref": "AbsoluteDateRange",
+ "description": "An absolute date range, defined by a start date and an end date. Interpreted relative to Pacific time zone."
+ },
+ "timeSeriesGranularity": {
+ "enum": [
+ "TIME_SERIES_GRANULARITY_UNSPECIFIED",
+ "HOURLY",
+ "DAILY"
+ ],
+ "type": "string",
+ "description": "The granularity of time intervals if a time series breakdown is desired; optional.",
+ "enumDescriptions": [
+ "A placeholder for an unspecified interval; no time series is applied. All rows in response will contain data for the entire requested time range.",
+ "Indicates that data will be broken down by the hour.",
+ "Indicates that data will be broken down by the day."
+ ]
+ },
+ "dealId": {
+ "description": "The ID of the deal on which to filter; optional. This field may be set only for a filter set that accesses account-level troubleshooting data, i.e., one whose name matches the `bidders/*/accounts/*/filterSets/*` pattern.",
+ "type": "string",
+ "format": "int64"
+ },
+ "realtimeTimeRange": {
+ "$ref": "RealtimeTimeRange",
+ "description": "An open-ended realtime time range, defined by the aggregation start timestamp."
+ },
+ "platforms": {
+ "items": {
+ "type": "string",
+ "enum": [
+ "PLATFORM_UNSPECIFIED",
+ "DESKTOP",
+ "TABLET",
+ "MOBILE"
+ ],
+ "enumDescriptions": [
+ "A placeholder for an undefined platform; indicates that no platform filter will be applied.",
+ "The ad impression appears on a desktop.",
+ "The ad impression appears on a tablet.",
+ "The ad impression appears on a mobile device."
+ ]
+ },
+ "description": "The list of platforms on which to filter; may be empty. The filters represented by multiple platforms are ORed together (i.e., if non-empty, results must match any one of the platforms).",
+ "type": "array"
+ },
+ "sellerNetworkIds": {
+ "items": {
+ "type": "integer",
+ "format": "int32"
+ },
+ "type": "array",
+ "description": "For Authorized Buyers only. The list of IDs of the seller (publisher) networks on which to filter; may be empty. The filters represented by multiple seller network IDs are ORed together (i.e., if non-empty, results must match any one of the publisher networks). See [seller-network-ids](https://developers.google.com/authorized-buyers/rtb/downloads/seller-network-ids) file for the set of existing seller network IDs."
+ },
+ "creativeId": {
+ "description": "The ID of the creative on which to filter; optional. This field may be set only for a filter set that accesses account-level troubleshooting data, i.e., one whose name matches the `bidders/*/accounts/*/filterSets/*` pattern.",
+ "type": "string"
+ },
+ "formats": {
+ "description": "Creative formats bidded on or allowed to bid on, can be empty. Although this field is a list, it can only be populated with a single item. A HTTP 400 bad request error will be returned in the response if you specify multiple items.",
+ "type": "array",
+ "items": {
+ "enumDescriptions": [
+ "A placeholder for an undefined format; indicates that no format filter will be applied.",
+ "The ad impression is a native ad, and display (i.e., image) format.",
+ "The ad impression is a native ad, and video format.",
+ "The ad impression is not a native ad, and display (i.e., image) format.",
+ "The ad impression is not a native ad, and video format."
+ ],
+ "type": "string",
+ "enum": [
+ "FORMAT_UNSPECIFIED",
+ "NATIVE_DISPLAY",
+ "NATIVE_VIDEO",
+ "NON_NATIVE_DISPLAY",
+ "NON_NATIVE_VIDEO"
+ ]
+ }
+ },
+ "environment": {
+ "enumDescriptions": [
+ "A placeholder for an undefined environment; indicates that no environment filter will be applied.",
+ "The ad impression appears on the web.",
+ "The ad impression appears in an app."
+ ],
+ "type": "string",
+ "enum": [
+ "ENVIRONMENT_UNSPECIFIED",
+ "WEB",
+ "APP"
+ ],
+ "description": "The environment on which to filter; optional."
+ },
+ "publisherIdentifiers": {
+ "description": "For Open Bidding partners only. The list of publisher identifiers on which to filter; may be empty. The filters represented by multiple publisher identifiers are ORed together.",
+ "type": "array",
+ "items": {
+ "type": "string"
+ }
+ }
+ }
+ },
+ "PlatformContext": {
+ "id": "PlatformContext",
+ "description": "Output only. The type of platform the restriction applies to.",
+ "type": "object",
+ "properties": {
+ "platforms": {
+ "type": "array",
+ "items": {
+ "type": "string",
+ "enum": [
+ "DESKTOP",
+ "ANDROID",
+ "IOS"
+ ],
+ "enumDescriptions": [
+ "Desktop platform.",
+ "Android platform.",
+ "iOS platform."
+ ]
+ },
+ "description": "The platforms this restriction applies to."
+ }
+ }
+ },
+ "DealTerms": {
+ "description": "The deal terms specify the details of a Product/deal. They specify things like price per buyer, the type of pricing model (e.g., fixed price, auction) and expected impressions from the publisher.",
+ "properties": {
+ "nonGuaranteedAuctionTerms": {
+ "$ref": "NonGuaranteedAuctionTerms",
+ "description": "The terms for non-guaranteed auction deals."
+ },
+ "sellerTimeZone": {
+ "type": "string",
+ "description": "The time zone name. For deals with Cost Per Day billing, defines the time zone used to mark the boundaries of a day. It should be an IANA TZ name, such as \"America/Los_Angeles\". For more information, see https://en.wikipedia.org/wiki/List_of_tz_database_time_zones."
+ },
+ "estimatedImpressionsPerDay": {
+ "description": "Non-binding estimate of the impressions served per day. Can be set by buyer or seller.",
+ "type": "string",
+ "format": "int64"
+ },
+ "nonGuaranteedFixedPriceTerms": {
+ "description": "The terms for non-guaranteed fixed price deals.",
+ "$ref": "NonGuaranteedFixedPriceTerms"
+ },
+ "guaranteedFixedPriceTerms": {
+ "description": "The terms for guaranteed fixed price deals.",
+ "$ref": "GuaranteedFixedPriceTerms"
+ },
+ "description": {
+ "type": "string",
+ "description": "Publisher provided description for the terms."
+ },
+ "estimatedGrossSpend": {
+ "description": "Non-binding estimate of the estimated gross spend for this deal. Can be set by buyer or seller.",
+ "$ref": "Price"
+ },
+ "brandingType": {
+ "type": "string",
+ "enum": [
+ "BRANDING_TYPE_UNSPECIFIED",
+ "BRANDED",
+ "SEMI_TRANSPARENT"
+ ],
+ "enumDescriptions": [
+ "A placeholder for an undefined branding type.",
+ "Full URL is included in bid requests.",
+ "A TopLevelDomain or masked URL is sent in bid requests rather than the full one."
+ ],
+ "description": "Visibility of the URL in bid requests. (default: BRANDED)"
+ }
+ },
+ "id": "DealTerms",
+ "type": "object"
+ },
+ "CreativeSize": {
+ "description": "Specifies the size of the creative.",
+ "type": "object",
+ "properties": {
+ "creativeSizeType": {
+ "enumDescriptions": [
+ "A placeholder for an undefined creative size type.",
+ "The creative is a regular desktop creative.",
+ "The creative is an interstitial creative.",
+ "The creative is a video creative.",
+ "The creative is a native (mobile) creative."
+ ],
+ "enum": [
+ "CREATIVE_SIZE_TYPE_UNSPECIFIED",
+ "REGULAR",
+ "INTERSTITIAL",
+ "VIDEO",
+ "NATIVE"
+ ],
+ "description": "The creative size type.",
+ "type": "string"
+ },
+ "companionSizes": {
+ "description": "For video creatives specifies the sizes of companion ads (if present). Companion sizes may be filled in only when creative_size_type = VIDEO",
+ "items": {
+ "$ref": "Size"
+ },
+ "type": "array"
+ },
+ "size": {
+ "description": "For regular or video creative size type, specifies the size of the creative",
+ "$ref": "Size"
+ },
+ "allowedFormats": {
+ "type": "array",
+ "description": "What formats are allowed by the publisher. If this repeated field is empty then all formats are allowed. For example, if this field contains AllowedFormatType.AUDIO then the publisher only allows an audio ad (without any video).",
+ "items": {
+ "type": "string",
+ "enum": [
+ "UNKNOWN",
+ "AUDIO"
+ ],
+ "enumDescriptions": [
+ "A placeholder for an undefined allowed format.",
+ "An audio-only ad (without any video)."
+ ]
+ }
+ },
+ "nativeTemplate": {
+ "type": "string",
+ "description": "Output only. The native template for this creative. It will have a value only if creative_size_type = CreativeSizeType.NATIVE.",
+ "enum": [
+ "UNKNOWN_NATIVE_TEMPLATE",
+ "NATIVE_CONTENT_AD",
+ "NATIVE_APP_INSTALL_AD",
+ "NATIVE_VIDEO_CONTENT_AD",
+ "NATIVE_VIDEO_APP_INSTALL_AD"
+ ],
+ "enumDescriptions": [
+ "A placeholder for an undefined native template.",
+ "The creative is linked to native content ad.",
+ "The creative is linked to native app install ad.",
+ "The creative is linked to native video content ad.",
+ "The creative is linked to native video app install ad."
+ ]
+ },
+ "skippableAdType": {
+ "enum": [
+ "SKIPPABLE_AD_TYPE_UNSPECIFIED",
+ "GENERIC",
+ "INSTREAM_SELECT",
+ "NOT_SKIPPABLE"
+ ],
+ "description": "The type of skippable ad for this creative. It will have a value only if creative_size_type = CreativeSizeType.VIDEO.",
+ "type": "string",
+ "enumDescriptions": [
+ "A placeholder for an undefined skippable ad type.",
+ "This video ad can be skipped after 5 seconds.",
+ "This video ad can be skipped after 5 seconds, and count as engaged view after 30 seconds. The creative is hosted on YouTube only, and viewcount of the YouTube video increments after the engaged view.",
+ "This video ad is not skippable."
+ ]
+ }
+ },
+ "id": "CreativeSize"
+ },
+ "TimeInterval": {
+ "id": "TimeInterval",
+ "type": "object",
+ "description": "An interval of time, with an absolute start and end.",
+ "properties": {
+ "endTime": {
+ "format": "google-datetime",
+ "description": "The timestamp marking the end of the range (exclusive) for which data is included.",
+ "type": "string"
+ },
+ "startTime": {
+ "type": "string",
+ "format": "google-datetime",
+ "description": "The timestamp marking the start of the range (inclusive) for which data is included."
+ }
+ }
+ },
+ "NonBillableWinningBidStatusRow": {
+ "properties": {
+ "rowDimensions": {
+ "description": "The values of all dimensions associated with metric values in this row.",
+ "$ref": "RowDimensions"
+ },
+ "bidCount": {
+ "description": "The number of bids with the specified status.",
+ "$ref": "MetricValue"
+ },
+ "status": {
+ "enum": [
+ "STATUS_UNSPECIFIED",
+ "AD_NOT_RENDERED",
+ "INVALID_IMPRESSION",
+ "FATAL_VAST_ERROR",
+ "LOST_IN_MEDIATION"
+ ],
+ "description": "The status specifying why the winning bids were not billed.",
+ "enumDescriptions": [
+ "A placeholder for an undefined status. This value will never be returned in responses.",
+ "The buyer was not billed because the ad was not rendered by the publisher.",
+ "The buyer was not billed because the impression won by the bid was determined to be invalid.",
+ "A video impression was served but a fatal error was reported from the client during playback.",
+ "The buyer was not billed because the ad was outplaced in the mediation waterfall."
+ ],
+ "type": "string"
+ }
+ },
+ "description": "The number of winning bids with the specified dimension values for which the buyer was not billed, as described by the specified status.",
+ "id": "NonBillableWinningBidStatusRow",
+ "type": "object"
+ },
+ "AddNoteRequest": {
+ "properties": {
+ "note": {
+ "description": "Details of the note to add.",
+ "$ref": "Note"
+ }
+ },
+ "description": "Request message for adding a note to a given proposal.",
+ "id": "AddNoteRequest",
+ "type": "object"
+ },
+ "BidMetricsRow": {
+ "description": "The set of metrics that are measured in numbers of bids, representing how many bids with the specified dimension values were considered eligible at each stage of the bidding funnel;",
+ "properties": {
+ "measurableImpressions": {
+ "$ref": "MetricValue",
+ "description": "The number of bids for which the corresponding impression was measurable for viewability (as defined by Active View)."
+ },
+ "bidsInAuction": {
+ "$ref": "MetricValue",
+ "description": "The number of bids that were permitted to compete in the auction."
+ },
+ "billedImpressions": {
+ "description": "The number of bids for which the buyer was billed.",
+ "$ref": "MetricValue"
+ },
+ "bids": {
+ "$ref": "MetricValue",
+ "description": "The number of bids that Ad Exchange received from the buyer."
+ },
+ "rowDimensions": {
+ "$ref": "RowDimensions",
+ "description": "The values of all dimensions associated with metric values in this row."
+ },
+ "viewableImpressions": {
+ "description": "The number of bids for which the corresponding impression was viewable (as defined by Active View).",
+ "$ref": "MetricValue"
+ },
+ "impressionsWon": {
+ "description": "The number of bids that won the auction.",
+ "$ref": "MetricValue"
+ },
+ "reachedQueries": {
+ "$ref": "MetricValue",
+ "description": "The number of bids that won the auction and also won the mediation waterfall (if any)."
+ }
+ },
+ "type": "object",
+ "id": "BidMetricsRow"
+ },
+ "ContactInformation": {
+ "properties": {
+ "name": {
+ "description": "The name of the contact.",
+ "type": "string"
+ },
+ "email": {
+ "description": "Email address for the contact.",
+ "type": "string"
+ }
+ },
+ "id": "ContactInformation",
+ "description": "Contains information on how a buyer or seller can be reached.",
+ "type": "object"
+ },
+ "MobileApplicationTargeting": {
+ "id": "MobileApplicationTargeting",
+ "properties": {
+ "firstPartyTargeting": {
+ "description": "Publisher owned apps to be targeted or excluded by the publisher to display the ads in.",
+ "$ref": "FirstPartyMobileApplicationTargeting"
+ }
+ },
+ "description": "Mobile application targeting settings.",
+ "type": "object"
+ },
+ "DayPartTargeting": {
+ "type": "object",
+ "properties": {
+ "dayParts": {
+ "type": "array",
+ "description": "A list of day part targeting criterion.",
+ "items": {
+ "$ref": "DayPart"
+ }
+ },
+ "timeZoneType": {
+ "description": "The timezone to use for interpreting the day part targeting.",
+ "enum": [
+ "TIME_ZONE_SOURCE_UNSPECIFIED",
+ "PUBLISHER",
+ "USER"
+ ],
+ "type": "string",
+ "enumDescriptions": [
+ "A placeholder for an undefined time zone source.",
+ "Use publisher's time zone setting.",
+ "Use the user's time zone setting."
+ ]
+ }
+ },
+ "id": "DayPartTargeting",
+ "description": "Specifies the day part targeting criteria."
+ },
+ "ClientUser": {
+ "type": "object",
+ "description": "A client user is created under a client buyer and has restricted access to the Marketplace and certain other sections of the Authorized Buyers UI based on the role granted to the associated client buyer. The only way a new client user can be created is via accepting an email invitation (see the accounts.clients.invitations.create method). All fields are required unless otherwise specified.",
+ "properties": {
+ "userId": {
+ "format": "int64",
+ "type": "string",
+ "description": "The unique numerical ID of the client user that has accepted an invitation. The value of this field is ignored in an update operation."
+ },
+ "email": {
+ "description": "User's email address. The value of this field is ignored in an update operation.",
+ "type": "string"
+ },
+ "status": {
+ "type": "string",
+ "enum": [
+ "USER_STATUS_UNSPECIFIED",
+ "PENDING",
+ "ACTIVE",
+ "DISABLED"
+ ],
+ "enumDescriptions": [
+ "A placeholder for an undefined user status.",
+ "A user who was already created but hasn't accepted the invitation yet.",
+ "A user that is currently active.",
+ "A user that is currently disabled."
+ ],
+ "description": "The status of the client user."
+ },
+ "clientAccountId": {
+ "format": "int64",
+ "description": "Numerical account ID of the client buyer with which the user is associated; the buyer must be a client of the current sponsor buyer. The value of this field is ignored in an update operation.",
+ "type": "string"
+ }
+ },
+ "id": "ClientUser"
+ },
+ "ListCreativesResponse": {
+ "id": "ListCreativesResponse",
+ "properties": {
+ "nextPageToken": {
+ "type": "string",
+ "description": "A token to retrieve the next page of results. Pass this value in the ListCreativesRequest.page_token field in the subsequent call to `ListCreatives` method to retrieve the next page of results."
+ },
+ "creatives": {
+ "items": {
+ "$ref": "Creative"
+ },
+ "description": "The list of creatives.",
+ "type": "array"
+ }
+ },
+ "description": "A response for listing creatives.",
+ "type": "object"
+ },
+ "CreativeSpecification": {
+ "id": "CreativeSpecification",
+ "properties": {
+ "creativeCompanionSizes": {
+ "description": "Companion sizes may be filled in only when this is a video creative.",
+ "items": {
+ "$ref": "AdSize"
+ },
+ "type": "array"
+ },
+ "creativeSize": {
+ "$ref": "AdSize",
+ "description": "The size of the creative."
+ }
+ },
+ "description": "Represents information for a creative that is associated with a Programmatic Guaranteed/Preferred Deal in Ad Manager.",
+ "type": "object"
+ },
+ "Price": {
+ "properties": {
+ "amount": {
+ "$ref": "Money",
+ "description": "The actual price with currency specified."
+ },
+ "pricingType": {
+ "description": "The pricing type for the deal/product. (default: CPM)",
+ "enumDescriptions": [
+ "A placeholder for an undefined pricing type. If the pricing type is unpsecified, `COST_PER_MILLE` will be used instead.",
+ "Cost per thousand impressions.",
+ "Cost per day"
+ ],
+ "type": "string",
+ "enum": [
+ "PRICING_TYPE_UNSPECIFIED",
+ "COST_PER_MILLE",
+ "COST_PER_DAY"
+ ]
+ }
+ },
+ "type": "object",
+ "description": "Represents a price and a pricing type for a product / deal.",
+ "id": "Price"
+ },
+ "InventorySizeTargeting": {
+ "properties": {
+ "targetedInventorySizes": {
+ "items": {
+ "$ref": "AdSize"
+ },
+ "description": "A list of inventory sizes to be included.",
+ "type": "array"
+ },
+ "excludedInventorySizes": {
+ "type": "array",
+ "description": "A list of inventory sizes to be excluded.",
+ "items": {
+ "$ref": "AdSize"
+ }
+ }
+ },
+ "id": "InventorySizeTargeting",
+ "type": "object",
+ "description": "Represents the size of an ad unit that can be targeted on an ad request. It only applies to Private Auction, AdX Preferred Deals and Auction Packages. This targeting does not apply to Programmatic Guaranteed and Preferred Deals in Ad Manager."
+ },
+ "Client": {
+ "description": "A client resource represents a client buyer—an agency, a brand, or an advertiser customer of the sponsor buyer. Users associated with the client buyer have restricted access to the Marketplace and certain other sections of the Authorized Buyers UI based on the role granted to the client buyer. All fields are required unless otherwise specified.",
+ "id": "Client",
+ "properties": {
+ "clientName": {
+ "description": "Name used to represent this client to publishers. You may have multiple clients that map to the same entity, but for each client the combination of `clientName` and entity must be unique. You can specify this field as empty.",
+ "type": "string"
+ },
+ "entityName": {
+ "type": "string",
+ "description": "The name of the entity. This field is automatically fetched based on the type and ID. The value of this field is ignored in create and update operations."
+ },
+ "partnerClientId": {
+ "type": "string",
+ "description": "Optional arbitrary unique identifier of this client buyer from the standpoint of its Ad Exchange sponsor buyer. This field can be used to associate a client buyer with the identifier in the namespace of its sponsor buyer, lookup client buyers by that identifier and verify whether an Ad Exchange counterpart of a given client buyer already exists. If present, must be unique among all the client buyers for its Ad Exchange sponsor buyer."
+ },
+ "entityId": {
+ "type": "string",
+ "format": "int64",
+ "description": "Numerical identifier of the client entity. The entity can be an advertiser, a brand, or an agency. This identifier is unique among all the entities with the same type. The value of this field is ignored if the entity type is not provided. A list of all known advertisers with their identifiers is available in the [advertisers.txt](https://storage.googleapis.com/adx-rtb-dictionaries/advertisers.txt) file. A list of all known brands with their identifiers is available in the [brands.txt](https://storage.googleapis.com/adx-rtb-dictionaries/brands.txt) file. A list of all known agencies with their identifiers is available in the [agencies.txt](https://storage.googleapis.com/adx-rtb-dictionaries/agencies.txt) file."
+ },
+ "status": {
+ "type": "string",
+ "enum": [
+ "CLIENT_STATUS_UNSPECIFIED",
+ "DISABLED",
+ "ACTIVE"
+ ],
+ "enumDescriptions": [
+ "A placeholder for an undefined client status.",
+ "A client that is currently disabled.",
+ "A client that is currently active."
+ ],
+ "description": "The status of the client buyer."
+ },
+ "role": {
+ "type": "string",
+ "enum": [
+ "CLIENT_ROLE_UNSPECIFIED",
+ "CLIENT_DEAL_VIEWER",
+ "CLIENT_DEAL_NEGOTIATOR",
+ "CLIENT_DEAL_APPROVER"
+ ],
+ "enumDescriptions": [
+ "A placeholder for an undefined client role.",
+ "Users associated with this client can see publisher deal offers in the Marketplace. They can neither negotiate proposals nor approve deals. If this client is visible to publishers, they can send deal proposals to this client.",
+ "Users associated with this client can respond to deal proposals sent to them by publishers. They can also initiate deal proposals of their own.",
+ "Users associated with this client can approve eligible deals on your behalf. Some deals may still explicitly require publisher finalization. If this role is not selected, the sponsor buyer will need to manually approve each of their deals."
+ ],
+ "description": "The role which is assigned to the client buyer. Each role implies a set of permissions granted to the client. Must be one of `CLIENT_DEAL_VIEWER`, `CLIENT_DEAL_NEGOTIATOR` or `CLIENT_DEAL_APPROVER`."
+ },
+ "visibleToSeller": {
+ "type": "boolean",
+ "description": "Whether the client buyer will be visible to sellers."
+ },
+ "entityType": {
+ "enum": [
+ "ENTITY_TYPE_UNSPECIFIED",
+ "ADVERTISER",
+ "BRAND",
+ "AGENCY",
+ "ENTITY_TYPE_UNCLASSIFIED"
+ ],
+ "description": "An optional field for specifying the type of the client entity: `ADVERTISER`, `BRAND`, or `AGENCY`.",
+ "enumDescriptions": [
+ "A placeholder for an undefined client entity type. Should not be used.",
+ "An advertiser.",
+ "A brand.",
+ "An advertising agency.",
+ "An explicit value for a client that was not yet classified as any particular entity."
+ ],
+ "type": "string"
+ },
+ "clientAccountId": {
+ "format": "int64",
+ "type": "string",
+ "description": "The globally-unique numerical ID of the client. The value of this field is ignored in create and update operations."
+ }
+ },
+ "type": "object"
+ },
+ "VideoContent": {
+ "description": "Video content for a creative.",
+ "id": "VideoContent",
+ "properties": {
+ "videoUrl": {
+ "description": "The URL to fetch a video ad.",
+ "type": "string"
+ },
+ "videoVastXml": {
+ "type": "string",
+ "description": "The contents of a VAST document for a video ad. This document should conform to the VAST 2.0 or 3.0 standard."
+ }
+ },
+ "type": "object"
+ },
+ "ImpressionMetricsRow": {
+ "id": "ImpressionMetricsRow",
+ "type": "object",
+ "description": "The set of metrics that are measured in numbers of impressions, representing how many impressions with the specified dimension values were considered eligible at each stage of the bidding funnel.",
+ "properties": {
+ "bidRequests": {
+ "$ref": "MetricValue",
+ "description": "The number of impressions for which Ad Exchange sent the buyer a bid request."
+ },
+ "inventoryMatches": {
+ "description": "The number of impressions that match the buyer's inventory pretargeting.",
+ "$ref": "MetricValue"
+ },
+ "rowDimensions": {
+ "$ref": "RowDimensions",
+ "description": "The values of all dimensions associated with metric values in this row."
+ },
+ "successfulResponses": {
+ "description": "The number of impressions for which the buyer successfully sent a response to Ad Exchange.",
+ "$ref": "MetricValue"
+ },
+ "responsesWithBids": {
+ "description": "The number of impressions for which Ad Exchange received a response from the buyer that contained at least one applicable bid.",
+ "$ref": "MetricValue"
+ },
+ "availableImpressions": {
+ "$ref": "MetricValue",
+ "description": "The number of impressions available to the buyer on Ad Exchange. In some cases this value may be unavailable."
+ }
+ }
+ },
+ "ListFilteredBidsResponse": {
+ "description": "Response message for listing all reasons that bids were filtered from the auction.",
+ "id": "ListFilteredBidsResponse",
+ "type": "object",
+ "properties": {
+ "nextPageToken": {
+ "type": "string",
+ "description": "A token to retrieve the next page of results. Pass this value in the ListFilteredBidsRequest.pageToken field in the subsequent call to the filteredBids.list method to retrieve the next page of results."
+ },
+ "creativeStatusRows": {
+ "description": "List of rows, with counts of filtered bids aggregated by filtering reason (i.e. creative status).",
+ "items": {
+ "$ref": "CreativeStatusRow"
+ },
+ "type": "array"
+ }
+ }
+ },
+ "NonGuaranteedFixedPriceTerms": {
+ "id": "NonGuaranteedFixedPriceTerms",
+ "description": "Terms for Preferred Deals. Note that Preferred Deals cannot be created via the API at this time, but can be returned in a get or list request.",
+ "properties": {
+ "fixedPrices": {
+ "items": {
+ "$ref": "PricePerBuyer"
+ },
+ "type": "array",
+ "description": "Fixed price for the specified buyer."
+ }
+ },
+ "type": "object"
+ },
+ "BidResponseWithoutBidsStatusRow": {
+ "description": "The number of impressions with the specified dimension values that were considered to have no applicable bids, as described by the specified status.",
+ "id": "BidResponseWithoutBidsStatusRow",
+ "properties": {
+ "rowDimensions": {
+ "description": "The values of all dimensions associated with metric values in this row.",
+ "$ref": "RowDimensions"
+ },
+ "impressionCount": {
+ "$ref": "MetricValue",
+ "description": "The number of impressions for which there was a bid response with the specified status."
+ },
+ "status": {
+ "type": "string",
+ "description": "The status specifying why the bid responses were considered to have no applicable bids.",
+ "enumDescriptions": [
+ "A placeholder for an undefined status. This value will never be returned in responses.",
+ "The response had no bids.",
+ "The response had no bids for the specified account, though it may have included bids on behalf of other accounts. Applies if: 1. Request is on behalf of a bidder and an account filter is present. 2. Request is on behalf of a child seat.",
+ "The response had no bids for the specified deal, though it may have included bids on other deals on behalf of the account to which the deal belongs. If request is on behalf of a bidder and an account filter is not present, this also includes responses that have bids on behalf of accounts other than the account to which the deal belongs."
+ ],
+ "enum": [
+ "STATUS_UNSPECIFIED",
+ "RESPONSES_WITHOUT_BIDS",
+ "RESPONSES_WITHOUT_BIDS_FOR_ACCOUNT",
+ "RESPONSES_WITHOUT_BIDS_FOR_DEAL"
+ ]
+ }
+ },
+ "type": "object"
+ },
+ "ServingContext": {
+ "id": "ServingContext",
+ "type": "object",
+ "description": "The serving context for this restriction.",
+ "properties": {
+ "auctionType": {
+ "description": "Matches impressions for a particular auction type.",
+ "$ref": "AuctionContext"
+ },
+ "securityType": {
+ "description": "Matches impressions for a particular security type.",
+ "$ref": "SecurityContext"
+ },
+ "location": {
+ "description": "Matches impressions coming from users *or* publishers in a specific location.",
+ "$ref": "LocationContext"
+ },
+ "appType": {
+ "$ref": "AppContext",
+ "description": "Matches impressions for a particular app type."
+ },
+ "all": {
+ "description": "Matches all contexts.",
+ "type": "string",
+ "enumDescriptions": [
+ "A simple context."
+ ],
+ "enum": [
+ "SIMPLE_CONTEXT"
+ ]
+ },
+ "platform": {
+ "description": "Matches impressions coming from a particular platform.",
+ "$ref": "PlatformContext"
+ }
+ }
+ },
+ "ListBidResponseErrorsResponse": {
+ "id": "ListBidResponseErrorsResponse",
+ "type": "object",
+ "properties": {
+ "nextPageToken": {
+ "type": "string",
+ "description": "A token to retrieve the next page of results. Pass this value in the ListBidResponseErrorsRequest.pageToken field in the subsequent call to the bidResponseErrors.list method to retrieve the next page of results."
+ },
+ "calloutStatusRows": {
+ "type": "array",
+ "items": {
+ "$ref": "CalloutStatusRow"
+ },
+ "description": "List of rows, with counts of bid responses aggregated by callout status."
+ }
+ },
+ "description": "Response message for listing all reasons that bid responses resulted in an error."
+ },
+ "TimeOfDay": {
+ "description": "Represents a time of day. The date and time zone are either not significant or are specified elsewhere. An API may choose to allow leap seconds. Related types are google.type.Date and `google.protobuf.Timestamp`.",
+ "id": "TimeOfDay",
+ "properties": {
+ "nanos": {
+ "format": "int32",
+ "description": "Fractions of seconds in nanoseconds. Must be from 0 to 999,999,999.",
+ "type": "integer"
+ },
+ "minutes": {
+ "format": "int32",
+ "type": "integer",
+ "description": "Minutes of hour of day. Must be from 0 to 59."
+ },
+ "hours": {
+ "format": "int32",
+ "description": "Hours of day in 24 hour format. Should be from 0 to 23. An API may choose to allow the value \"24:00:00\" for scenarios like business closing time.",
+ "type": "integer"
+ },
+ "seconds": {
+ "description": "Seconds of minutes of the time. Must normally be from 0 to 59. An API may allow the value 60 if it allows leap-seconds.",
+ "format": "int32",
+ "type": "integer"
+ }
+ },
+ "type": "object"
+ },
+ "ListProposalsResponse": {
+ "id": "ListProposalsResponse",
+ "properties": {
+ "nextPageToken": {
+ "type": "string",
+ "description": "Continuation token for fetching the next page of results."
+ },
+ "proposals": {
+ "type": "array",
+ "description": "The list of proposals.",
+ "items": {
+ "$ref": "Proposal"
+ }
+ }
+ },
+ "description": "Response message for listing proposals.",
+ "type": "object"
+ },
+ "RemoveDealAssociationRequest": {
+ "id": "RemoveDealAssociationRequest",
+ "description": "A request for removing the association between a deal and a creative.",
+ "properties": {
+ "association": {
+ "$ref": "CreativeDealAssociation",
+ "description": "The association between a creative and a deal that should be removed."
+ }
+ },
+ "type": "object"
+ },
+ "ListNonBillableWinningBidsResponse": {
+ "description": "Response message for listing all reasons for which a buyer was not billed for a winning bid.",
+ "properties": {
+ "nonBillableWinningBidStatusRows": {
+ "type": "array",
+ "description": "List of rows, with counts of bids not billed aggregated by reason.",
+ "items": {
+ "$ref": "NonBillableWinningBidStatusRow"
+ }
+ },
+ "nextPageToken": {
+ "description": "A token to retrieve the next page of results. Pass this value in the ListNonBillableWinningBidsRequest.pageToken field in the subsequent call to the nonBillableWinningBids.list method to retrieve the next page of results.",
+ "type": "string"
+ }
+ },
+ "id": "ListNonBillableWinningBidsResponse",
+ "type": "object"
+ },
+ "Creative": {
+ "type": "object",
+ "properties": {
+ "openAuctionStatus": {
+ "enum": [
+ "STATUS_UNSPECIFIED",
+ "NOT_CHECKED",
+ "CONDITIONALLY_APPROVED",
+ "APPROVED",
+ "DISAPPROVED",
+ "PENDING_REVIEW",
+ "STATUS_TYPE_UNSPECIFIED"
+ ],
+ "enumDescriptions": [
+ "The status is unknown.",
+ "The creative has not been checked.",
+ "The creative has been conditionally approved. See serving_restrictions for details.",
+ "The creative has been approved.",
+ "The creative has been disapproved.",
+ "Placeholder for transition to v1beta1. Currently not used.",
+ "Placeholder for transition to v1beta1. Currently not used."
+ ],
+ "description": "Output only. The top-level open auction status of this creative. If disapproved, an entry for 'auctionType = OPEN_AUCTION' (or 'ALL') in serving_restrictions will also exist. Note that this may be nuanced with other contextual restrictions, in which case, it may be preferable to read from serving_restrictions directly. Can be used to filter the response of the creatives.list method.",
+ "type": "string"
+ },
+ "detectedProductCategories": {
+ "description": "Output only. Detected product categories, if any. See the ad-product-categories.txt file in the technical documentation for a list of IDs.",
+ "items": {
+ "format": "int32",
+ "type": "integer"
+ },
+ "type": "array"
+ },
+ "corrections": {
+ "description": "Output only. Shows any corrections that were applied to this creative.",
+ "items": {
+ "$ref": "Correction"
+ },
+ "type": "array"
+ },
+ "servingRestrictions": {
+ "items": {
+ "$ref": "ServingRestriction"
+ },
+ "description": "Output only. The granular status of this ad in specific contexts. A context here relates to where something ultimately serves (for example, a physical location, a platform, an HTTPS vs HTTP request, or the type of auction).",
+ "type": "array"
+ },
+ "dealsStatus": {
+ "enumDescriptions": [
+ "The status is unknown.",
+ "The creative has not been checked.",
+ "The creative has been conditionally approved. See serving_restrictions for details.",
+ "The creative has been approved.",
+ "The creative has been disapproved.",
+ "Placeholder for transition to v1beta1. Currently not used.",
+ "Placeholder for transition to v1beta1. Currently not used."
+ ],
+ "enum": [
+ "STATUS_UNSPECIFIED",
+ "NOT_CHECKED",
+ "CONDITIONALLY_APPROVED",
+ "APPROVED",
+ "DISAPPROVED",
+ "PENDING_REVIEW",
+ "STATUS_TYPE_UNSPECIFIED"
+ ],
+ "description": "Output only. The top-level deals status of this creative. If disapproved, an entry for 'auctionType=DIRECT_DEALS' (or 'ALL') in serving_restrictions will also exist. Note that this may be nuanced with other contextual restrictions, in which case, it may be preferable to read from serving_restrictions directly. Can be used to filter the response of the creatives.list method.",
+ "type": "string"
+ },
+ "detectedDomains": {
+ "description": "Output only. The detected domains for this creative.",
+ "type": "array",
+ "items": {
+ "type": "string"
+ }
+ },
+ "apiUpdateTime": {
+ "description": "Output only. The last update timestamp of the creative via API.",
+ "format": "google-datetime",
+ "type": "string"
+ },
+ "video": {
+ "$ref": "VideoContent",
+ "description": "A video creative."
+ },
+ "creativeId": {
+ "type": "string",
+ "description": "The buyer-defined creative ID of this creative. Can be used to filter the response of the creatives.list method."
+ },
+ "advertiserName": {
+ "type": "string",
+ "description": "The name of the company being advertised in the creative."
+ },
+ "native": {
+ "description": "A native creative.",
+ "$ref": "NativeContent"
+ },
+ "restrictedCategories": {
+ "description": "All restricted categories for the ads that may be shown from this creative.",
+ "items": {
+ "enum": [
+ "NO_RESTRICTED_CATEGORIES",
+ "ALCOHOL"
+ ],
+ "enumDescriptions": [
+ "The ad has no restricted categories",
+ "The alcohol restricted category."
+ ],
+ "type": "string"
+ },
+ "type": "array"
+ },
+ "detectedAdvertiserIds": {
+ "description": "Output only. Detected advertiser IDs, if any.",
+ "type": "array",
+ "items": {
+ "type": "string",
+ "format": "int64"
+ }
+ },
+ "attributes": {
+ "items": {
+ "enum": [
+ "ATTRIBUTE_UNSPECIFIED",
+ "IMAGE_RICH_MEDIA",
+ "ADOBE_FLASH_FLV",
+ "IS_TAGGED",
+ "IS_COOKIE_TARGETED",
+ "IS_USER_INTEREST_TARGETED",
+ "EXPANDING_DIRECTION_NONE",
+ "EXPANDING_DIRECTION_UP",
+ "EXPANDING_DIRECTION_DOWN",
+ "EXPANDING_DIRECTION_LEFT",
+ "EXPANDING_DIRECTION_RIGHT",
+ "EXPANDING_DIRECTION_UP_LEFT",
+ "EXPANDING_DIRECTION_UP_RIGHT",
+ "EXPANDING_DIRECTION_DOWN_LEFT",
+ "EXPANDING_DIRECTION_DOWN_RIGHT",
+ "CREATIVE_TYPE_HTML",
+ "CREATIVE_TYPE_VAST_VIDEO",
+ "EXPANDING_DIRECTION_UP_OR_DOWN",
+ "EXPANDING_DIRECTION_LEFT_OR_RIGHT",
+ "EXPANDING_DIRECTION_ANY_DIAGONAL",
+ "EXPANDING_ACTION_ROLLOVER_TO_EXPAND",
+ "INSTREAM_VAST_VIDEO_TYPE_VPAID_FLASH",
+ "RICH_MEDIA_CAPABILITY_TYPE_MRAID",
+ "RICH_MEDIA_CAPABILITY_TYPE_FLASH",
+ "RICH_MEDIA_CAPABILITY_TYPE_HTML5",
+ "SKIPPABLE_INSTREAM_VIDEO",
+ "RICH_MEDIA_CAPABILITY_TYPE_SSL",
+ "RICH_MEDIA_CAPABILITY_TYPE_NON_SSL",
+ "RICH_MEDIA_CAPABILITY_TYPE_INTERSTITIAL",
+ "NON_SKIPPABLE_INSTREAM_VIDEO",
+ "NATIVE_ELIGIBILITY_ELIGIBLE",
+ "NON_VPAID",
+ "NATIVE_ELIGIBILITY_NOT_ELIGIBLE",
+ "ANY_INTERSTITIAL",
+ "NON_INTERSTITIAL",
+ "IN_BANNER_VIDEO",
+ "RENDERING_SIZELESS_ADX",
+ "OMSDK_1_0"
+ ],
+ "enumDescriptions": [
+ "Do not use. This is a placeholder value only.",
+ "The creative is of type image/rich media. For pretargeting.",
+ "The creative is of video type Adobe Flash FLV. For pretargeting.",
+ "The creative is tagged.",
+ "The creative is cookie targeted.",
+ "The creative is user interest targeted.",
+ "The creative does not expand.",
+ "The creative expands up.",
+ "The creative expands down.",
+ "The creative expands left.",
+ "The creative expands right.",
+ "The creative expands up and left.",
+ "The creative expands up and right.",
+ "The creative expands down and left.",
+ "The creative expands down and right.",
+ "The creative type is HTML.",
+ "The creative type is VAST video.",
+ "The creative expands up or down.",
+ "The creative expands left or right.",
+ "The creative expands on any diagonal.",
+ "The creative expands when rolled over.",
+ "The instream vast video type is vpaid flash.",
+ "The creative is MRAID.",
+ "The creative is Flash.",
+ "The creative is HTML5.",
+ "The creative has an instream VAST video type of skippable instream video. For pretargeting.",
+ "The creative is SSL.",
+ "The creative is non-SSL.",
+ "The creative is an interstitial.",
+ "The creative has an instream VAST video type of non-skippable instream video. For pretargeting.",
+ "The creative is eligible for native.",
+ "The creative has an instream VAST video type of non-VPAID. For pretargeting.",
+ "The creative is not eligible for native.",
+ "The creative has an interstitial size of any interstitial. For pretargeting.",
+ "The creative has an interstitial size of non interstitial. For pretargeting.",
+ "The video type is in-banner video.",
+ "The creative can dynamically resize to fill a variety of slot sizes.",
+ "The open measurement SDK is supported."
+ ],
+ "type": "string"
+ },
+ "description": "All attributes for the ads that may be shown from this creative. Can be used to filter the response of the creatives.list method.",
+ "type": "array"
+ },
+ "version": {
+ "type": "integer",
+ "format": "int32",
+ "description": "Output only. The version of this creative."
+ },
+ "vendorIds": {
+ "type": "array",
+ "items": {
+ "format": "int32",
+ "type": "integer"
+ },
+ "description": "All vendor IDs for the ads that may be shown from this creative. See https://storage.googleapis.com/adx-rtb-dictionaries/vendors.txt for possible values."
+ },
+ "agencyId": {
+ "format": "int64",
+ "type": "string",
+ "description": "The agency ID for this creative."
+ },
+ "detectedSensitiveCategories": {
+ "type": "array",
+ "description": "Output only. Detected sensitive categories, if any. See the ad-sensitive-categories.txt file in the technical documentation for a list of IDs. You should use these IDs along with the excluded-sensitive-category field in the bid request to filter your bids.",
+ "items": {
+ "type": "integer",
+ "format": "int32"
+ }
+ },
+ "impressionTrackingUrls": {
+ "items": {
+ "type": "string"
+ },
+ "description": "The set of URLs to be called to record an impression.",
+ "type": "array"
+ },
+ "adTechnologyProviders": {
+ "description": "Output only. The detected ad technology providers.",
+ "$ref": "AdTechnologyProviders"
+ },
+ "adChoicesDestinationUrl": {
+ "description": "The link to AdChoices destination page.",
+ "type": "string"
+ },
+ "detectedLanguages": {
+ "type": "array",
+ "description": "Output only. The detected languages for this creative. The order is arbitrary. The codes are 2 or 5 characters and are documented at https://developers.google.com/adwords/api/docs/appendix/languagecodes.",
+ "items": {
+ "type": "string"
+ }
+ },
+ "clickThroughUrls": {
+ "type": "array",
+ "items": {
+ "type": "string"
+ },
+ "description": "The set of destination URLs for the creative."
+ },
+ "accountId": {
+ "type": "string",
+ "description": "The account that this creative belongs to. Can be used to filter the response of the creatives.list method."
+ },
+ "declaredClickThroughUrls": {
+ "items": {
+ "type": "string"
+ },
+ "description": "The set of declared destination URLs for the creative.",
+ "type": "array"
+ },
+ "html": {
+ "description": "An HTML creative.",
+ "$ref": "HtmlContent"
+ }
+ },
+ "description": "A creative and its classification data.",
+ "id": "Creative"
+ },
+ "MetricValue": {
+ "type": "object",
+ "properties": {
+ "value": {
+ "format": "int64",
+ "description": "The expected value of the metric.",
+ "type": "string"
+ },
+ "variance": {
+ "format": "int64",
+ "type": "string",
+ "description": "The variance (i.e. square of the standard deviation) of the metric value. If value is exact, variance is 0. Can be used to calculate margin of error as a percentage of value, using the following formula, where Z is the standard constant that depends on the desired size of the confidence interval (e.g. for 90% confidence interval, use Z = 1.645): marginOfError = 100 * Z * sqrt(variance) / value"
+ }
+ },
+ "id": "MetricValue",
+ "description": "A metric value, with an expected value and a variance; represents a count that may be either exact or estimated (i.e. when sampled)."
+ },
+ "PlacementTargeting": {
+ "id": "PlacementTargeting",
+ "type": "object",
+ "properties": {
+ "urlTargeting": {
+ "description": "URLs to be included/excluded.",
+ "$ref": "UrlTargeting"
+ },
+ "mobileApplicationTargeting": {
+ "description": "Mobile application targeting information in a deal. This doesn't apply to Auction Packages.",
+ "$ref": "MobileApplicationTargeting"
+ }
+ },
+ "description": "Represents targeting about where the ads can appear, e.g., certain sites or mobile applications. Different placement targeting types will be logically OR'ed."
+ },
+ "CompleteSetupRequest": {
+ "properties": {},
+ "id": "CompleteSetupRequest",
+ "type": "object",
+ "description": "Request message for indicating that the proposal's setup step is complete."
+ },
+ "AdTechnologyProviders": {
+ "type": "object",
+ "description": "Detected ad technology provider information.",
+ "properties": {
+ "detectedProviderIds": {
+ "description": "The detected ad technology provider IDs for this creative. See https://storage.googleapis.com/adx-rtb-dictionaries/providers.csv for mapping of provider ID to provided name, a privacy policy URL, and a list of domains which can be attributed to the provider. If the creative contains provider IDs that are outside of those listed in the `BidRequest.adslot.consented_providers_settings.consented_providers` field on the (Google bid protocol)[https://developers.google.com/authorized-buyers/rtb/downloads/realtime-bidding-proto] and the `BidRequest.user.ext.consented_providers_settings.consented_providers` field on the (OpenRTB protocol)[https://developers.google.com/authorized-buyers/rtb/downloads/openrtb-adx-proto], and a bid is submitted with that creative for an impression that will serve to an EEA user, the bid will be filtered before the auction.",
+ "type": "array",
+ "items": {
+ "format": "int64",
+ "type": "string"
+ }
+ },
+ "hasUnidentifiedProvider": {
+ "description": "Whether the creative contains an unidentified ad technology provider. If true for a given creative, any bid submitted with that creative for an impression that will serve to an EEA user will be filtered before the auction.",
+ "type": "boolean"
+ }
+ },
+ "id": "AdTechnologyProviders"
+ },
+ "Seller": {
+ "type": "object",
+ "description": "Represents a seller of inventory. Each seller is identified by a unique Ad Manager account ID.",
+ "id": "Seller",
+ "properties": {
+ "subAccountId": {
+ "type": "string",
+ "description": "Optional sub-account ID for the seller."
+ },
+ "accountId": {
+ "type": "string",
+ "description": "The unique ID for the seller. The seller fills in this field. The seller account ID is then available to buyer in the product."
+ }
+ }
+ },
+ "CreativeDealAssociation": {
+ "properties": {
+ "dealsId": {
+ "type": "string",
+ "description": "The externalDealId for the deal associated with the creative."
+ },
+ "creativeId": {
+ "description": "The ID of the creative associated with the deal.",
+ "type": "string"
+ },
+ "accountId": {
+ "type": "string",
+ "description": "The account the creative belongs to."
+ }
+ },
+ "description": "The association between a creative and a deal.",
+ "id": "CreativeDealAssociation",
+ "type": "object"
+ },
+ "PublisherProfile": {
+ "description": "Note: this resource requires whitelisting for access. Please contact your account manager for access to Marketplace resources. Represents a publisher profile (https://support.google.com/admanager/answer/6035806) in Marketplace. All fields are read only. All string fields are free-form text entered by the publisher unless noted otherwise.",
+ "id": "PublisherProfile",
+ "properties": {
+ "topHeadlines": {
+ "description": "Up to three key metrics and rankings. Max 100 characters each. For example \"#1 Mobile News Site for 20 Straight Months\".",
+ "type": "array",
+ "items": {
+ "type": "string"
+ }
+ },
+ "samplePageUrl": {
+ "type": "string",
+ "description": "URL to a sample content page."
+ },
+ "isParent": {
+ "type": "boolean",
+ "description": "Indicates if this profile is the parent profile of the seller. A parent profile represents all the inventory from the seller, as opposed to child profile that is created to brand a portion of inventory. One seller should have only one parent publisher profile, and can have multiple child profiles. Publisher profiles for the same seller will have same value of field google.ads.adexchange.buyer.v2beta1.PublisherProfile.seller. See https://support.google.com/admanager/answer/6035806 for details."
+ },
+ "mediaKitUrl": {
+ "description": "URL to additional marketing and sales materials.",
+ "type": "string"
+ },
+ "overview": {
+ "type": "string",
+ "description": "Overview of the publisher."
+ },
+ "domains": {
+ "description": "The list of domains represented in this publisher profile. Empty if this is a parent profile. These are top private domains, meaning that these will not contain a string like \"photos.google.co.uk/123\", but will instead contain \"google.co.uk\".",
+ "type": "array",
+ "items": {
+ "type": "string"
+ }
+ },
+ "publisherProfileId": {
+ "type": "string",
+ "description": "Unique ID for publisher profile."
+ },
+ "googlePlusUrl": {
+ "description": "URL to publisher's Google+ page.",
+ "type": "string"
+ },
+ "logoUrl": {
+ "description": "A Google public URL to the logo for this publisher profile. The logo is stored as a PNG, JPG, or GIF image.",
+ "type": "string"
+ },
+ "programmaticDealsContact": {
+ "type": "string",
+ "description": "Contact information for programmatic deals. This is free text entered by the publisher and may include information like names, phone numbers and email addresses."
+ },
+ "buyerPitchStatement": {
+ "type": "string",
+ "description": "Statement explaining what's unique about publisher's business, and why buyers should partner with the publisher."
+ },
+ "audienceDescription": {
+ "description": "Description on the publisher's audience.",
+ "type": "string"
+ },
+ "mobileApps": {
+ "items": {
+ "$ref": "PublisherProfileMobileApplication"
+ },
+ "type": "array",
+ "description": "The list of apps represented in this publisher profile. Empty if this is a parent profile."
+ },
+ "displayName": {
+ "type": "string",
+ "description": "Name of the publisher profile."
+ },
+ "rateCardInfoUrl": {
+ "description": "URL to a publisher rate card.",
+ "type": "string"
+ },
+ "directDealsContact": {
+ "description": "Contact information for direct reservation deals. This is free text entered by the publisher and may include information like names, phone numbers and email addresses.",
+ "type": "string"
+ },
+ "seller": {
+ "description": "Seller of the publisher profile.",
+ "$ref": "Seller"
+ }
+ },
+ "type": "object"
+ },
+ "TargetingValue": {
+ "properties": {
+ "creativeSizeValue": {
+ "$ref": "CreativeSize",
+ "description": "The creative size value to include/exclude. Filled in when key = GOOG_CREATIVE_SIZE"
+ },
+ "longValue": {
+ "description": "The long value to include/exclude.",
+ "format": "int64",
+ "type": "string"
+ },
+ "stringValue": {
+ "type": "string",
+ "description": "The string value to include/exclude."
+ },
+ "dayPartTargetingValue": {
+ "$ref": "DayPartTargeting",
+ "description": "The daypart targeting to include / exclude. Filled in when the key is GOOG_DAYPART_TARGETING. The definition of this targeting is derived from the structure used by Ad Manager."
+ }
+ },
+ "id": "TargetingValue",
+ "description": "A polymorphic targeting value used as part of Shared Targeting.",
+ "type": "object"
+ },
+ "DeliveryControl": {
+ "id": "DeliveryControl",
+ "type": "object",
+ "properties": {
+ "creativeBlockingLevel": {
+ "description": "Output only. Specified the creative blocking levels to be applied.",
+ "enum": [
+ "CREATIVE_BLOCKING_LEVEL_UNSPECIFIED",
+ "PUBLISHER_BLOCKING_RULES",
+ "ADX_POLICY_BLOCKING_ONLY"
+ ],
+ "enumDescriptions": [
+ "A placeholder for an undefined creative blocking level.",
+ "Publisher blocking rules will be applied.",
+ "The Ad Exchange policy blocking rules will be applied."
+ ],
+ "type": "string"
+ },
+ "frequencyCaps": {
+ "description": "Output only. Specifies any frequency caps.",
+ "items": {
+ "$ref": "FrequencyCap"
+ },
+ "type": "array"
+ },
+ "deliveryRateType": {
+ "type": "string",
+ "enumDescriptions": [
+ "A placeholder for an undefined delivery rate type.",
+ "Impressions are served uniformly over the life of the deal.",
+ "Impressions are served front-loaded.",
+ "Impressions are served as fast as possible."
+ ],
+ "description": "Output only. Specifies how the impression delivery will be paced.",
+ "enum": [
+ "DELIVERY_RATE_TYPE_UNSPECIFIED",
+ "EVENLY",
+ "FRONT_LOADED",
+ "AS_FAST_AS_POSSIBLE"
+ ]
+ }
+ },
+ "description": "Message contains details about how the deals will be paced."
+ },
+ "ResumeProposalRequest": {
+ "properties": {},
+ "id": "ResumeProposalRequest",
+ "description": "Request message to resume (unpause) serving for an already-finalized proposal.",
+ "type": "object"
+ },
+ "Proposal": {
+ "type": "object",
+ "id": "Proposal",
+ "properties": {
+ "proposalState": {
+ "enumDescriptions": [
+ "A placeholder for an undefined proposal state.",
+ "The proposal is under negotiation or renegotiation.",
+ "The proposal has been accepted by the buyer.",
+ "The proposal has been accepted by the seller.",
+ "The negotiations on the proposal were canceled and the proposal was never finalized.",
+ "The proposal is finalized. During renegotiation, the proposal may not be in this state."
+ ],
+ "enum": [
+ "PROPOSAL_STATE_UNSPECIFIED",
+ "PROPOSED",
+ "BUYER_ACCEPTED",
+ "SELLER_ACCEPTED",
+ "CANCELED",
+ "FINALIZED"
+ ],
+ "type": "string",
+ "description": "Output only. The current state of the proposal."
+ },
+ "deals": {
+ "type": "array",
+ "description": "The deals associated with this proposal. For Private Auction proposals (whose deals have NonGuaranteedAuctionTerms), there will only be one deal.",
+ "items": {
+ "$ref": "Deal"
+ }
+ },
+ "isRenegotiating": {
+ "type": "boolean",
+ "description": "Output only. True if the proposal is being renegotiated."
+ },
+ "isSetupComplete": {
+ "description": "Output only. True, if the buyside inventory setup is complete for this proposal.",
+ "type": "boolean"
+ },
+ "seller": {
+ "$ref": "Seller",
+ "description": "Reference to the seller on the proposal. Note: This field may be set only when creating the resource. Modifying this field while updating the resource will result in an error."
+ },
+ "proposalRevision": {
+ "type": "string",
+ "format": "int64",
+ "description": "Output only. The revision number for the proposal. Each update to the proposal or the deal causes the proposal revision number to auto-increment. The buyer keeps track of the last revision number they know of and pass it in when making an update. If the head revision number on the server has since incremented, then an ABORTED error is returned during the update operation to let the buyer know that a subsequent update was made."
+ },
+ "sellerContacts": {
+ "items": {
+ "$ref": "ContactInformation"
+ },
+ "type": "array",
+ "description": "Output only. Contact information for the seller."
+ },
+ "billedBuyer": {
+ "description": "Output only. Reference to the buyer that will get billed for this proposal.",
+ "$ref": "Buyer"
+ },
+ "buyerPrivateData": {
+ "$ref": "PrivateData",
+ "description": "Private data for buyer. (hidden from seller)."
+ },
+ "buyerContacts": {
+ "type": "array",
+ "items": {
+ "$ref": "ContactInformation"
+ },
+ "description": "Contact information for the buyer."
+ },
+ "updateTime": {
+ "type": "string",
+ "description": "Output only. The time when the proposal was last revised.",
+ "format": "google-datetime"
+ },
+ "notes": {
+ "description": "Output only. The notes associated with this proposal.",
+ "type": "array",
+ "items": {
+ "$ref": "Note"
+ }
+ },
+ "privateAuctionId": {
+ "type": "string",
+ "description": "Output only. Private auction ID if this proposal is a private auction proposal."
+ },
+ "lastUpdaterOrCommentorRole": {
+ "enum": [
+ "BUYER_SELLER_ROLE_UNSPECIFIED",
+ "BUYER",
+ "SELLER"
+ ],
+ "description": "Output only. The role of the last user that either updated the proposal or left a comment.",
+ "type": "string",
+ "enumDescriptions": [
+ "A placeholder for an undefined buyer/seller role.",
+ "Specifies the role as buyer.",
+ "Specifies the role as seller."
+ ]
+ },
+ "originatorRole": {
+ "description": "Output only. Indicates whether the buyer/seller created the proposal.",
+ "type": "string",
+ "enumDescriptions": [
+ "A placeholder for an undefined buyer/seller role.",
+ "Specifies the role as buyer.",
+ "Specifies the role as seller."
+ ],
+ "enum": [
+ "BUYER_SELLER_ROLE_UNSPECIFIED",
+ "BUYER",
+ "SELLER"
+ ]
+ },
+ "buyer": {
+ "$ref": "Buyer",
+ "description": "Reference to the buyer on the proposal. Note: This field may be set only when creating the resource. Modifying this field while updating the resource will result in an error."
+ },
+ "proposalId": {
+ "type": "string",
+ "description": "Output only. The unique ID of the proposal."
+ },
+ "displayName": {
+ "description": "The name for the proposal.",
+ "type": "string"
+ }
+ },
+ "description": "Note: this resource requires whitelisting for access. Please contact your account manager for access to Marketplace resources. Represents a proposal in the Marketplace. A proposal is the unit of negotiation between a seller and a buyer and contains deals which are served. Note: you can not update, create, or otherwise modify Private Auction or Preferred Deals deals through the API. Fields are updatable unless noted otherwise."
+ },
+ "CreativeStatusRow": {
+ "id": "CreativeStatusRow",
+ "type": "object",
+ "description": "The number of bids with the specified dimension values that did not win the auction (either were filtered pre-auction or lost the auction), as described by the specified creative status.",
+ "properties": {
+ "creativeStatusId": {
+ "type": "integer",
+ "description": "The ID of the creative status. See [creative-status-codes](https://developers.google.com/authorized-buyers/rtb/downloads/creative-status-codes).",
+ "format": "int32"
+ },
+ "rowDimensions": {
+ "$ref": "RowDimensions",
+ "description": "The values of all dimensions associated with metric values in this row."
+ },
+ "bidCount": {
+ "$ref": "MetricValue",
+ "description": "The number of bids with the specified status."
+ }
+ }
+ },
+ "ListLosingBidsResponse": {
+ "description": "Response message for listing all reasons that bids lost in the auction.",
+ "id": "ListLosingBidsResponse",
+ "type": "object",
+ "properties": {
+ "nextPageToken": {
+ "description": "A token to retrieve the next page of results. Pass this value in the ListLosingBidsRequest.pageToken field in the subsequent call to the losingBids.list method to retrieve the next page of results.",
+ "type": "string"
+ },
+ "creativeStatusRows": {
+ "items": {
+ "$ref": "CreativeStatusRow"
+ },
+ "type": "array",
+ "description": "List of rows, with counts of losing bids aggregated by loss reason (i.e. creative status)."
+ }
+ }
+ },
+ "ListClientsResponse": {
+ "type": "object",
+ "id": "ListClientsResponse",
+ "properties": {
+ "nextPageToken": {
+ "type": "string",
+ "description": "A token to retrieve the next page of results. Pass this value in the ListClientsRequest.pageToken field in the subsequent call to the accounts.clients.list method to retrieve the next page of results."
+ },
+ "clients": {
+ "items": {
+ "$ref": "Client"
+ },
+ "description": "The returned list of clients.",
+ "type": "array"
+ }
+ }
+ },
+ "ListClientUserInvitationsResponse": {
+ "type": "object",
+ "properties": {
+ "nextPageToken": {
+ "description": "A token to retrieve the next page of results. Pass this value in the ListClientUserInvitationsRequest.pageToken field in the subsequent call to the clients.invitations.list method to retrieve the next page of results.",
+ "type": "string"
+ },
+ "invitations": {
+ "items": {
+ "$ref": "ClientUserInvitation"
+ },
+ "description": "The returned list of client users.",
+ "type": "array"
+ }
+ },
+ "id": "ListClientUserInvitationsResponse"
+ },
+ "TechnologyTargeting": {
+ "properties": {
+ "deviceCapabilityTargeting": {
+ "$ref": "CriteriaTargeting",
+ "description": "IDs of device capabilities to be included/excluded."
+ },
+ "deviceCategoryTargeting": {
+ "$ref": "CriteriaTargeting",
+ "description": "IDs of device categories to be included/excluded."
+ },
+ "operatingSystemTargeting": {
+ "description": "Operating system related targeting information.",
+ "$ref": "OperatingSystemTargeting"
+ }
+ },
+ "id": "TechnologyTargeting",
+ "type": "object",
+ "description": "Represents targeting about various types of technology."
+ },
+ "LocationContext": {
+ "id": "LocationContext",
+ "properties": {
+ "geoCriteriaIds": {
+ "items": {
+ "format": "int32",
+ "type": "integer"
+ },
+ "type": "array",
+ "description": "IDs representing the geo location for this context. Please refer to the [geo-table.csv](https://storage.googleapis.com/adx-rtb-dictionaries/geo-table.csv) file for different geo criteria IDs."
+ }
+ },
+ "type": "object",
+ "description": "Output only. The Geo criteria the restriction applies to."
+ },
+ "AppContext": {
+ "id": "AppContext",
+ "properties": {
+ "appTypes": {
+ "items": {
+ "enumDescriptions": [
+ "Native app context.",
+ "Mobile web app context."
+ ],
+ "enum": [
+ "NATIVE",
+ "WEB"
+ ],
+ "type": "string"
+ },
+ "type": "array",
+ "description": "The app types this restriction applies to."
+ }
+ },
+ "description": "Output only. The app type the restriction applies to for mobile device.",
+ "type": "object"
+ },
+ "GuaranteedFixedPriceTerms": {
+ "properties": {
+ "minimumDailyLooks": {
+ "type": "string",
+ "format": "int64",
+ "description": "Daily minimum looks for CPD deal types."
+ },
+ "guaranteedLooks": {
+ "description": "Count of guaranteed looks. Required for deal, optional for product.",
+ "type": "string",
+ "format": "int64"
+ },
+ "guaranteedImpressions": {
+ "description": "Guaranteed impressions as a percentage. This is the percentage of guaranteed looks that the buyer is guaranteeing to buy.",
+ "format": "int64",
+ "type": "string"
+ },
+ "fixedPrices": {
+ "description": "Fixed price for the specified buyer.",
+ "type": "array",
+ "items": {
+ "$ref": "PricePerBuyer"
+ }
+ }
+ },
+ "id": "GuaranteedFixedPriceTerms",
+ "type": "object",
+ "description": "Terms for Programmatic Guaranteed Deals."
+ },
+ "DealServingMetadata": {
+ "id": "DealServingMetadata",
+ "type": "object",
+ "description": "Message captures metadata about the serving status of a deal.",
+ "properties": {
+ "dealPauseStatus": {
+ "description": "Output only. Tracks which parties (if any) have paused a deal.",
+ "$ref": "DealPauseStatus"
+ }
+ }
+ },
+ "FrequencyCap": {
+ "type": "object",
+ "description": "Frequency cap.",
+ "id": "FrequencyCap",
+ "properties": {
+ "numTimeUnits": {
+ "format": "int32",
+ "description": "The amount of time, in the units specified by time_unit_type. Defines the amount of time over which impressions per user are counted and capped.",
+ "type": "integer"
+ },
+ "maxImpressions": {
+ "format": "int32",
+ "description": "The maximum number of impressions that can be served to a user within the specified time period.",
+ "type": "integer"
+ },
+ "timeUnitType": {
+ "enum": [
+ "TIME_UNIT_TYPE_UNSPECIFIED",
+ "MINUTE",
+ "HOUR",
+ "DAY",
+ "WEEK",
+ "MONTH",
+ "LIFETIME"
+ ],
+ "description": "The time unit. Along with num_time_units defines the amount of time over which impressions per user are counted and capped.",
+ "enumDescriptions": [
+ "A placeholder for an undefined time unit type. This just indicates the variable with this value hasn't been initialized.",
+ "Minute",
+ "Hour",
+ "Day",
+ "Week",
+ "Month",
+ "Lifetime"
+ ],
+ "type": "string"
+ }
+ }
+ },
+ "ListFilteredBidRequestsResponse": {
+ "properties": {
+ "nextPageToken": {
+ "description": "A token to retrieve the next page of results. Pass this value in the ListFilteredBidRequestsRequest.pageToken field in the subsequent call to the filteredBidRequests.list method to retrieve the next page of results.",
+ "type": "string"
+ },
+ "calloutStatusRows": {
+ "items": {
+ "$ref": "CalloutStatusRow"
+ },
+ "type": "array",
+ "description": "List of rows, with counts of filtered bid requests aggregated by callout status."
+ }
+ },
+ "type": "object",
+ "id": "ListFilteredBidRequestsResponse",
+ "description": "Response message for listing all reasons that bid requests were filtered and not sent to the buyer."
+ },
+ "ListDealAssociationsResponse": {
+ "id": "ListDealAssociationsResponse",
+ "description": "A response for listing creative and deal associations",
+ "type": "object",
+ "properties": {
+ "nextPageToken": {
+ "type": "string",
+ "description": "A token to retrieve the next page of results. Pass this value in the ListDealAssociationsRequest.page_token field in the subsequent call to 'ListDealAssociation' method to retrieve the next page of results."
+ },
+ "associations": {
+ "items": {
+ "$ref": "CreativeDealAssociation"
+ },
+ "description": "The list of associations.",
+ "type": "array"
+ }
+ }
+ },
+ "RelativeDateRange": {
+ "description": "A relative date range, specified by an offset and a duration. The supported range of dates begins 30 days before today and ends today, i.e., the limits for these values are: offset_days \u003e= 0 duration_days \u003e= 1 offset_days + duration_days \u003c= 30",
+ "type": "object",
+ "id": "RelativeDateRange",
+ "properties": {
+ "offsetDays": {
+ "description": "The end date of the filter set, specified as the number of days before today, e.g., for a range where the last date is today: 0.",
+ "type": "integer",
+ "format": "int32"
+ },
+ "durationDays": {
+ "description": "The number of days in the requested date range, e.g., for a range spanning today: 1. For a range spanning the last 7 days: 7.",
+ "format": "int32",
+ "type": "integer"
+ }
+ }
+ },
+ "Product": {
+ "id": "Product",
+ "description": "Note: this resource requires whitelisting for access. Please contact your account manager for access to Marketplace resources. A product is a segment of inventory that a seller wishes to sell. It is associated with certain terms and targeting information which helps the buyer know more about the inventory.",
+ "type": "object",
+ "properties": {
+ "targetingCriterion": {
+ "items": {
+ "$ref": "TargetingCriteria"
+ },
+ "type": "array",
+ "description": "Targeting that is shared between the buyer and the seller. Each targeting criterion has a specified key and for each key there is a list of inclusion value or exclusion values."
+ },
+ "creatorContacts": {
+ "description": "Optional contact information for the creator of this product.",
+ "items": {
+ "$ref": "ContactInformation"
+ },
+ "type": "array"
+ },
+ "productRevision": {
+ "format": "int64",
+ "description": "The revision number of the product (auto-assigned by Marketplace).",
+ "type": "string"
+ },
+ "productId": {
+ "type": "string",
+ "description": "The unique ID for the product."
+ },
+ "syndicationProduct": {
+ "description": "The syndication product associated with the deal.",
+ "enumDescriptions": [
+ "A placeholder for an undefined syndication product.",
+ "This typically represents a web page.",
+ "This represents a mobile property.",
+ "This represents video ad formats.",
+ "This represents ads shown within games."
+ ],
+ "enum": [
+ "SYNDICATION_PRODUCT_UNSPECIFIED",
+ "CONTENT",
+ "MOBILE",
+ "VIDEO",
+ "GAMES"
+ ],
+ "type": "string"
+ },
+ "updateTime": {
+ "format": "google-datetime",
+ "description": "Time of last update.",
+ "type": "string"
+ },
+ "availableEndTime": {
+ "type": "string",
+ "description": "The proposed end time for the deal. The field will be truncated to the order of seconds during serving.",
+ "format": "google-datetime"
+ },
+ "seller": {
+ "description": "Information about the seller that created this product.",
+ "$ref": "Seller"
+ },
+ "createTime": {
+ "description": "Creation time.",
+ "format": "google-datetime",
+ "type": "string"
+ },
+ "terms": {
+ "$ref": "DealTerms",
+ "description": "The negotiable terms of the deal."
+ },
+ "webPropertyCode": {
+ "type": "string",
+ "description": "The web-property code for the seller. This needs to be copied as is when adding a new deal to a proposal."
+ },
+ "publisherProfileId": {
+ "type": "string",
+ "description": "An ID which can be used by the Publisher Profile API to get more information about the seller that created this product."
+ },
+ "displayName": {
+ "description": "The display name for this product as set by the seller.",
+ "type": "string"
+ },
+ "availableStartTime": {
+ "format": "google-datetime",
+ "description": "Inventory availability dates. The start time will be truncated to seconds during serving. Thus, a field specified as 3:23:34.456 (HH:mm:ss.SSS) will be truncated to 3:23:34 when serving.",
+ "type": "string"
+ },
+ "hasCreatorSignedOff": {
+ "description": "If the creator has already signed off on the product, then the buyer can finalize the deal by accepting the product as is. When copying to a proposal, if any of the terms are changed, then auto_finalize is automatically set to false.",
+ "type": "boolean"
+ }
+ }
+ },
+ "CalloutStatusRow": {
+ "properties": {
+ "rowDimensions": {
+ "$ref": "RowDimensions",
+ "description": "The values of all dimensions associated with metric values in this row."
+ },
+ "calloutStatusId": {
+ "description": "The ID of the callout status. See [callout-status-codes](https://developers.google.com/authorized-buyers/rtb/downloads/callout-status-codes).",
+ "type": "integer",
+ "format": "int32"
+ },
+ "impressionCount": {
+ "$ref": "MetricValue",
+ "description": "The number of impressions for which there was a bid request or bid response with the specified callout status."
+ }
+ },
+ "description": "The number of impressions with the specified dimension values where the corresponding bid request or bid response was not successful, as described by the specified callout status.",
+ "id": "CalloutStatusRow",
+ "type": "object"
+ },
+ "WatchCreativeRequest": {
+ "type": "object",
+ "id": "WatchCreativeRequest",
+ "description": "A request for watching changes to creative Status.",
+ "properties": {
+ "topic": {
+ "type": "string",
+ "description": "The Pub/Sub topic to publish notifications to. This topic must already exist and must give permission to ad-exchange-buyside-reports@google.com to write to the topic. This should be the full resource name in \"projects/{project_id}/topics/{topic_id}\" format."
+ }
+ }
+ },
+ "Correction": {
+ "description": "Output only. Shows any corrections that were applied to this creative.",
+ "properties": {
+ "contexts": {
+ "items": {
+ "$ref": "ServingContext"
+ },
+ "type": "array",
+ "description": "The contexts for the correction."
+ },
+ "type": {
+ "enumDescriptions": [
+ "The correction type is unknown. Refer to the details for more information.",
+ "The ad's declared vendors did not match the vendors that were detected. The detected vendors were added.",
+ "The ad had the SSL attribute declared but was not SSL-compliant. The SSL attribute was removed.",
+ "The ad was declared as Flash-free but contained Flash, so the Flash-free attribute was removed.",
+ "The ad was not declared as Flash-free but it did not reference any flash content, so the Flash-free attribute was added.",
+ "The ad did not declare a required creative attribute. The attribute was added.",
+ "The ad did not declare a required technology vendor. The technology vendor was added.",
+ "The ad did not declare the SSL attribute but was SSL-compliant, so the SSL attribute was added.",
+ "Properties consistent with In-banner video were found, so an In-Banner Video attribute was added.",
+ "The ad makes calls to the MRAID API so the MRAID attribute was added.",
+ "The ad unnecessarily declared the Flash attribute, so the Flash attribute was removed.",
+ "The ad contains video content."
+ ],
+ "type": "string",
+ "enum": [
+ "CORRECTION_TYPE_UNSPECIFIED",
+ "VENDOR_IDS_ADDED",
+ "SSL_ATTRIBUTE_REMOVED",
+ "FLASH_FREE_ATTRIBUTE_REMOVED",
+ "FLASH_FREE_ATTRIBUTE_ADDED",
+ "REQUIRED_ATTRIBUTE_ADDED",
+ "REQUIRED_VENDOR_ADDED",
+ "SSL_ATTRIBUTE_ADDED",
+ "IN_BANNER_VIDEO_ATTRIBUTE_ADDED",
+ "MRAID_ATTRIBUTE_ADDED",
+ "FLASH_ATTRIBUTE_REMOVED",
+ "VIDEO_IN_SNIPPET_ATTRIBUTE_ADDED"
+ ],
+ "description": "The type of correction that was applied to the creative."
+ },
+ "details": {
+ "type": "array",
+ "description": "Additional details about what was corrected.",
+ "items": {
+ "type": "string"
+ }
+ }
+ },
+ "type": "object",
+ "id": "Correction"
+ },
+ "VideoTargeting": {
+ "properties": {
+ "targetedPositionTypes": {
+ "description": "A list of video positions to be included. When the included list is present, the excluded list must be empty. When the excluded list is present, the included list must be empty.",
+ "type": "array",
+ "items": {
+ "enumDescriptions": [
+ "A placeholder for an undefined video position.",
+ "Ad is played before the video.",
+ "Ad is played during the video.",
+ "Ad is played after the video."
+ ],
+ "enum": [
+ "POSITION_TYPE_UNSPECIFIED",
+ "PREROLL",
+ "MIDROLL",
+ "POSTROLL"
+ ],
+ "type": "string"
+ }
+ },
+ "excludedPositionTypes": {
+ "items": {
+ "enumDescriptions": [
+ "A placeholder for an undefined video position.",
+ "Ad is played before the video.",
+ "Ad is played during the video.",
+ "Ad is played after the video."
+ ],
+ "enum": [
+ "POSITION_TYPE_UNSPECIFIED",
+ "PREROLL",
+ "MIDROLL",
+ "POSTROLL"
+ ],
+ "type": "string"
+ },
+ "type": "array",
+ "description": "A list of video positions to be excluded. Position types can either be included or excluded (XOR)."
+ }
+ },
+ "description": "Represents targeting information about video.",
+ "id": "VideoTargeting",
+ "type": "object"
+ },
+ "AcceptProposalRequest": {
+ "description": "Request to accept a proposal.",
+ "properties": {
+ "proposalRevision": {
+ "description": "The last known client revision number of the proposal.",
+ "format": "int64",
+ "type": "string"
+ }
+ },
+ "type": "object",
+ "id": "AcceptProposalRequest"
+ },
+ "SecurityContext": {
+ "properties": {
+ "securities": {
+ "type": "array",
+ "items": {
+ "enumDescriptions": [
+ "Matches impressions that require insecure compatibility.",
+ "Matches impressions that require SSL compatibility."
+ ],
+ "type": "string",
+ "enum": [
+ "INSECURE",
+ "SSL"
+ ]
+ },
+ "description": "The security types in this context."
+ }
+ },
+ "id": "SecurityContext",
+ "type": "object",
+ "description": "Output only. A security context."
+ },
+ "AuctionContext": {
+ "properties": {
+ "auctionTypes": {
+ "description": "The auction types this restriction applies to.",
+ "items": {
+ "type": "string",
+ "enumDescriptions": [
+ "The restriction applies to open auction.",
+ "The restriction applies to direct deals."
+ ],
+ "enum": [
+ "OPEN_AUCTION",
+ "DIRECT_DEALS"
+ ]
+ },
+ "type": "array"
+ }
+ },
+ "id": "AuctionContext",
+ "type": "object",
+ "description": "Output only. The auction type the restriction applies to."
+ },
+ "Size": {
+ "type": "object",
+ "id": "Size",
+ "properties": {
+ "width": {
+ "description": "The width of the creative",
+ "type": "integer",
+ "format": "int32"
+ },
+ "height": {
+ "format": "int32",
+ "type": "integer",
+ "description": "The height of the creative."
+ }
+ },
+ "description": "Message depicting the size of the creative. The units of width and height depend on the type of the targeting."
+ },
+ "HtmlContent": {
+ "properties": {
+ "width": {
+ "type": "integer",
+ "format": "int32",
+ "description": "The width of the HTML snippet in pixels."
+ },
+ "height": {
+ "format": "int32",
+ "type": "integer",
+ "description": "The height of the HTML snippet in pixels."
+ },
+ "snippet": {
+ "description": "The HTML snippet that displays the ad when inserted in the web page.",
+ "type": "string"
+ }
+ },
+ "type": "object",
+ "description": "HTML content for a creative.",
+ "id": "HtmlContent"
+ },
+ "OperatingSystemTargeting": {
+ "description": "Represents targeting information for operating systems.",
+ "type": "object",
+ "properties": {
+ "operatingSystemCriteria": {
+ "description": "IDs of operating systems to be included/excluded.",
+ "$ref": "CriteriaTargeting"
+ },
+ "operatingSystemVersionCriteria": {
+ "description": "IDs of operating system versions to be included/excluded.",
+ "$ref": "CriteriaTargeting"
+ }
+ },
+ "id": "OperatingSystemTargeting"
+ },
+ "ListFilterSetsResponse": {
+ "type": "object",
+ "id": "ListFilterSetsResponse",
+ "description": "Response message for listing filter sets.",
+ "properties": {
+ "nextPageToken": {
+ "type": "string",
+ "description": "A token to retrieve the next page of results. Pass this value in the ListFilterSetsRequest.pageToken field in the subsequent call to the accounts.filterSets.list method to retrieve the next page of results."
+ },
+ "filterSets": {
+ "items": {
+ "$ref": "FilterSet"
+ },
+ "type": "array",
+ "description": "The filter sets belonging to the buyer."
+ }
+ }
+ },
+ "CancelNegotiationRequest": {
+ "properties": {},
+ "id": "CancelNegotiationRequest",
+ "type": "object",
+ "description": "Request to cancel an ongoing negotiation."
+ },
+ "UrlTargeting": {
+ "type": "object",
+ "id": "UrlTargeting",
+ "properties": {
+ "excludedUrls": {
+ "description": "A list of URLs to be excluded.",
+ "items": {
+ "type": "string"
+ },
+ "type": "array"
+ },
+ "targetedUrls": {
+ "type": "array",
+ "description": "A list of URLs to be included.",
+ "items": {
+ "type": "string"
+ }
+ }
+ },
+ "description": "Represents a list of targeted and excluded URLs (e.g., google.com). For Private Auction and AdX Preferred Deals, URLs are either included or excluded. For Programmatic Guaranteed and Preferred Deals, this doesn't apply."
+ },
+ "ListImpressionMetricsResponse": {
+ "id": "ListImpressionMetricsResponse",
+ "type": "object",
+ "properties": {
+ "nextPageToken": {
+ "description": "A token to retrieve the next page of results. Pass this value in the ListImpressionMetricsRequest.pageToken field in the subsequent call to the impressionMetrics.list method to retrieve the next page of results.",
+ "type": "string"
+ },
+ "impressionMetricsRows": {
+ "type": "array",
+ "items": {
+ "$ref": "ImpressionMetricsRow"
+ },
+ "description": "List of rows, each containing a set of impression metrics."
+ }
+ },
+ "description": "Response message for listing the metrics that are measured in number of impressions."
+ },
+ "ListCreativeStatusBreakdownByDetailResponse": {
+ "description": "Response message for listing all details associated with a given filtered bid reason.",
+ "type": "object",
+ "properties": {
+ "detailType": {
+ "enum": [
+ "DETAIL_TYPE_UNSPECIFIED",
+ "CREATIVE_ATTRIBUTE",
+ "VENDOR",
+ "SENSITIVE_CATEGORY",
+ "PRODUCT_CATEGORY",
+ "DISAPPROVAL_REASON",
+ "POLICY_TOPIC"
+ ],
+ "type": "string",
+ "enumDescriptions": [
+ "A placeholder for an undefined status. This value will never be returned in responses.",
+ "Indicates that the detail ID refers to a creative attribute; see [publisher-excludable-creative-attributes](https://developers.google.com/authorized-buyers/rtb/downloads/publisher-excludable-creative-attributes).",
+ "Indicates that the detail ID refers to a vendor; see [vendors](https://developers.google.com/authorized-buyers/rtb/downloads/vendors).",
+ "Indicates that the detail ID refers to a sensitive category; see [ad-sensitive-categories](https://developers.google.com/authorized-buyers/rtb/downloads/ad-sensitive-categories).",
+ "Indicates that the detail ID refers to a product category; see [ad-product-categories](https://developers.google.com/authorized-buyers/rtb/downloads/ad-product-categories).",
+ "Indicates that the detail ID refers to a disapproval reason; see DisapprovalReason enum in [snippet-status-report-proto](https://developers.google.com/authorized-buyers/rtb/downloads/snippet-status-report-proto).",
+ "Indicates that the detail ID refers to a policy topic."
+ ],
+ "description": "The type of detail that the detail IDs represent."
+ },
+ "nextPageToken": {
+ "description": "A token to retrieve the next page of results. Pass this value in the ListCreativeStatusBreakdownByDetailRequest.pageToken field in the subsequent call to the filteredBids.details.list method to retrieve the next page of results.",
+ "type": "string"
+ },
+ "filteredBidDetailRows": {
+ "type": "array",
+ "items": {
+ "$ref": "FilteredBidDetailRow"
+ },
+ "description": "List of rows, with counts of bids with a given creative status aggregated by detail."
+ }
+ },
+ "id": "ListCreativeStatusBreakdownByDetailResponse"
+ },
+ "AddDealAssociationRequest": {
+ "id": "AddDealAssociationRequest",
+ "type": "object",
+ "description": "A request for associating a deal and a creative.",
+ "properties": {
+ "association": {
+ "description": "The association between a creative and a deal that should be added.",
+ "$ref": "CreativeDealAssociation"
+ }
+ }
+ },
+ "AbsoluteDateRange": {
+ "id": "AbsoluteDateRange",
+ "description": "An absolute date range, specified by its start date and end date. The supported range of dates begins 30 days before today and ends today. Validity checked upon filter set creation. If a filter set with an absolute date range is run at a later date more than 30 days after start_date, it will fail.",
+ "type": "object",
+ "properties": {
+ "startDate": {
+ "$ref": "Date",
+ "description": "The start date of the range (inclusive). Must be within the 30 days leading up to current date, and must be equal to or before end_date."
+ },
+ "endDate": {
+ "$ref": "Date",
+ "description": "The end date of the range (inclusive). Must be within the 30 days leading up to current date, and must be equal to or after start_date."
+ }
+ }
+ },
+ "Buyer": {
+ "type": "object",
+ "id": "Buyer",
+ "description": "Represents a buyer of inventory. Each buyer is identified by a unique Authorized Buyers account ID.",
+ "properties": {
+ "accountId": {
+ "description": "Authorized Buyers account ID of the buyer.",
+ "type": "string"
+ }
+ }
+ },
+ "TargetingCriteria": {
+ "type": "object",
+ "id": "TargetingCriteria",
+ "description": "Advertisers can target different attributes of an ad slot. For example, they can choose to show ads only if the user is in the U.S. Such targeting criteria can be specified as part of Shared Targeting.",
+ "properties": {
+ "key": {
+ "type": "string",
+ "description": "The key representing the shared targeting criterion. Targeting criteria defined by Google ad servers will begin with GOOG_. Third parties may define their own keys. A list of permissible keys along with the acceptable values will be provided as part of the external documentation."
+ },
+ "inclusions": {
+ "description": "The list of value to include as part of the targeting. Each value is OR'd together.",
+ "items": {
+ "$ref": "TargetingValue"
+ },
+ "type": "array"
+ },
+ "exclusions": {
+ "type": "array",
+ "items": {
+ "$ref": "TargetingValue"
+ },
+ "description": "The list of values to exclude from targeting. Each value is AND'd together."
+ }
+ }
+ },
+ "ListBidMetricsResponse": {
+ "type": "object",
+ "properties": {
+ "nextPageToken": {
+ "type": "string",
+ "description": "A token to retrieve the next page of results. Pass this value in the ListBidMetricsRequest.pageToken field in the subsequent call to the bidMetrics.list method to retrieve the next page of results."
+ },
+ "bidMetricsRows": {
+ "items": {
+ "$ref": "BidMetricsRow"
+ },
+ "description": "List of rows, each containing a set of bid metrics.",
+ "type": "array"
+ }
+ },
+ "description": "Response message for listing the metrics that are measured in number of bids.",
+ "id": "ListBidMetricsResponse"
+ },
+ "MarketplaceTargeting": {
+ "type": "object",
+ "properties": {
+ "videoTargeting": {
+ "description": "Video targeting information.",
+ "$ref": "VideoTargeting"
+ },
+ "technologyTargeting": {
+ "description": "Technology targeting information, e.g., operating system, device category.",
+ "$ref": "TechnologyTargeting"
+ },
+ "placementTargeting": {
+ "$ref": "PlacementTargeting",
+ "description": "Placement targeting information, e.g., URL, mobile applications."
+ },
+ "inventorySizeTargeting": {
+ "$ref": "InventorySizeTargeting",
+ "description": "Inventory sizes to be included/excluded."
+ },
+ "geoTargeting": {
+ "description": "Geo criteria IDs to be included/excluded.",
+ "$ref": "CriteriaTargeting"
+ }
+ },
+ "id": "MarketplaceTargeting",
+ "description": "Targeting represents different criteria that can be used by advertisers to target ad inventory. For example, they can choose to target ad requests only if the user is in the US. Multiple types of targeting are always applied as a logical AND, unless noted otherwise."
+ }
+ }
+}