"description":"Accesses the latest features for managing Authorized Buyers accounts, Real-Time Bidding configurations and auction metrics, and Marketplace programmatic deals.",
"Responses with Content-Type of application/json",
"Media download with context-dependent Content-Type",
"Responses with Content-Type of application/x-protobuf"
],
"location":"query",
"type":"string"
},
"callback":{
"description":"JSONP",
"location":"query",
"type":"string"
},
"fields":{
"description":"Selector specifying which fields to include in a partial response.",
"location":"query",
"type":"string"
},
"key":{
"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.",
"location":"query",
"type":"string"
},
"oauth_token":{
"description":"OAuth 2.0 token for the current user.",
"location":"query",
"type":"string"
},
"prettyPrint":{
"default":"true",
"description":"Returns response with indentations and line breaks.",
"location":"query",
"type":"boolean"
},
"quotaUser":{
"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",
"type":"string"
},
"uploadType":{
"description":"Legacy upload protocol for media (e.g. \"media\", \"multipart\").",
"location":"query",
"type":"string"
},
"upload_protocol":{
"description":"Upload protocol for media (e.g. \"raw\", \"multipart\").",
"description":"Unique numerical account ID for the buyer of which the client buyer\nis a customer; the sponsor buyer to create a client for. (required)",
"description":"Unique numerical account ID of the sponsor buyer to list the clients for.",
"format":"int64",
"location":"path",
"required":true,
"type":"string"
},
"pageSize":{
"description":"Requested page size. The server may return fewer clients than requested.\nIf unspecified, the server will pick an appropriate default.",
"description":"A token identifying a page of results the server should return.\nTypically, this is the value of\nListClientsResponse.nextPageToken\nreturned from the previous call to the\naccounts.clients.list\nmethod.",
"description":"Optional unique identifier (from the standpoint of an Ad Exchange sponsor\nbuyer partner) of the client to return.\nIf specified, at most one client will be returned in the response.",
"description":"Unique numerical account ID for the buyer of which the client buyer\nis a customer; the sponsor buyer to update a client for. (required)",
"format":"int64",
"location":"path",
"required":true,
"type":"string"
},
"clientAccountId":{
"description":"Unique numerical account ID of the client to update. (required)",
"description":"Numerical account ID of the client's sponsor buyer. (required)",
"format":"int64",
"location":"path",
"required":true,
"type":"string"
},
"clientAccountId":{
"description":"Numerical account ID of the client buyer to list invitations for.\n(required)\nYou must either specify a string representation of a\nnumerical account identifier or the `-` character\nto list all the invitations for all the clients\nof a given sponsor buyer.",
"location":"path",
"required":true,
"type":"string"
},
"pageSize":{
"description":"Requested page size. Server may return fewer clients than requested.\nIf unspecified, server will pick an appropriate default.",
"format":"int32",
"location":"query",
"type":"integer"
},
"pageToken":{
"description":"A token identifying a page of results the server should return.\nTypically, this is the value of\nListClientUserInvitationsResponse.nextPageToken\nreturned from the previous call to the\nclients.invitations.list\nmethod.",
"description":"Numerical account ID of the sponsor buyer of the client to list users for.\n(required)",
"format":"int64",
"location":"path",
"required":true,
"type":"string"
},
"clientAccountId":{
"description":"The account ID of the client buyer to list users for. (required)\nYou must specify either a string representation of a\nnumerical account identifier or the `-` character\nto list all the client users for all the clients\nof a given sponsor buyer.",
"location":"path",
"required":true,
"type":"string"
},
"pageSize":{
"description":"Requested page size. The server may return fewer clients than requested.\nIf unspecified, the server will pick an appropriate default.",
"format":"int32",
"location":"query",
"type":"integer"
},
"pageToken":{
"description":"A token identifying a page of results the server should return.\nTypically, this is the value of\nListClientUsersResponse.nextPageToken\nreturned from the previous call to the\naccounts.clients.users.list method.",
"description":"The account to list the creatives from.\nSpecify \"-\" to list all creatives the current user has access to.",
"location":"path",
"required":true,
"type":"string"
},
"pageSize":{
"description":"Requested page size. The server may return fewer creatives than requested\n(due to timeout constraint) even if more are available via another call.\nIf unspecified, server will pick an appropriate default.\nAcceptable values are 1 to 1000, inclusive.",
"format":"int32",
"location":"query",
"type":"integer"
},
"pageToken":{
"description":"A token identifying a page of results the server should return.\nTypically, this is the value of\nListCreativesResponse.next_page_token\nreturned from the previous call to 'ListCreatives' method.",
"location":"query",
"type":"string"
},
"query":{
"description":"An optional query string to filter creatives. If no filter is specified,\nall active creatives will be returned.\n\u003cp\u003eSupported queries are:\n\u003cul\u003e\n\u003cli\u003eaccountId=\u003ci\u003eaccount_id_string\u003c/i\u003e\n\u003cli\u003ecreativeId=\u003ci\u003ecreative_id_string\u003c/i\u003e\n\u003cli\u003edealsStatus: {approved, conditionally_approved, disapproved,\n not_checked}\n\u003cli\u003eopenAuctionStatus: {approved, conditionally_approved, disapproved,\n not_checked}\n\u003cli\u003eattribute: {a numeric attribute from the list of attributes}\n\u003cli\u003edisapprovalReason: {a reason from\nDisapprovalReason}\n\u003c/ul\u003e\nExample: 'accountId=12345 AND (dealsStatus:disapproved AND\ndisapprovalReason:unacceptable_content) OR attribute:47'",
"description":"The account of the creative to watch.",
"location":"path",
"required":true,
"type":"string"
},
"creativeId":{
"description":"The creative ID to watch for status changes.\nSpecify \"-\" to watch all creatives under the above account.\nIf both creative-level and account-level notifications are\nsent, only a single notification will be sent to the\ncreative-level notification topic.",
"description":"The account to list the associations from.\nSpecify \"-\" to list all creatives the current user has access to.",
"location":"path",
"required":true,
"type":"string"
},
"creativeId":{
"description":"The creative ID to list the associations from.\nSpecify \"-\" to list all creatives under the above account.",
"location":"path",
"required":true,
"type":"string"
},
"pageSize":{
"description":"Requested page size. Server may return fewer associations than requested.\nIf unspecified, server will pick an appropriate default.",
"format":"int32",
"location":"query",
"type":"integer"
},
"pageToken":{
"description":"A token identifying a page of results the server should return.\nTypically, this is the value of\nListDealAssociationsResponse.next_page_token\nreturned from the previous call to 'ListDealAssociations' method.",
"location":"query",
"type":"string"
},
"query":{
"description":"An optional query string to filter deal associations. If no filter is\nspecified, all associations will be returned.\nSupported queries are:\n\u003cul\u003e\n\u003cli\u003eaccountId=\u003ci\u003eaccount_id_string\u003c/i\u003e\n\u003cli\u003ecreativeId=\u003ci\u003ecreative_id_string\u003c/i\u003e\n\u003cli\u003edealsId=\u003ci\u003edeals_id_string\u003c/i\u003e\n\u003cli\u003edealsStatus:{approved, conditionally_approved, disapproved,\n not_checked}\n\u003cli\u003eopenAuctionStatus:{approved, conditionally_approved, disapproved,\n not_checked}\n\u003c/ul\u003e\nExample: 'dealsId=12345 AND dealsStatus:disapproved'",
"description":"List finalized proposals, regardless if a proposal is being renegotiated.\nA filter expression (PQL query) may be specified to filter the results.\nThe notes will not be returned.",
"description":"An optional PQL filter query used to query for proposals.\n\nNested repeated fields, such as proposal.deals.targetingCriterion,\ncannot be filtered.",
"description":"Requested page size. The server may return fewer results than requested.\nIf unspecified, the server will pick an appropriate default.",
"format":"int32",
"location":"query",
"type":"integer"
},
"pageToken":{
"description":"The page token as returned from ListProposalsResponse.",
"description":"An optional PQL query used to query for products. See\nhttps://developers.google.com/ad-manager/docs/pqlreference\nfor documentation about PQL and examples.\n\nNested repeated fields, such as product.targetingCriterion.inclusions,\ncannot be filtered.",
"description":"Requested page size. The server may return fewer results than requested.\nIf unspecified, the server will pick an appropriate default.",
"description":"Mark the proposal as accepted at the given revision number. If the number\ndoes not match the server's revision number an `ABORTED` error message will\nbe returned. This call updates the proposal_state from `PROPOSED` to\n`BUYER_ACCEPTED`, or from `SELLER_ACCEPTED` to `FINALIZED`.",
"description":"Create a new note and attach it to the proposal. The note is assigned\na unique ID by the server.\nThe proposal revision number will not increase when associated with a\nnew note.",
"description":"Cancel an ongoing negotiation on a proposal. This does not cancel or end\nserving for the deals if the proposal has been finalized, but only cancels\na negotiation unilaterally.",
"description":"Update the given proposal to indicate that setup has been completed.\nThis method is called by the buyer when the line items have been created\non their end for a finalized proposal and all the required creatives\nhave been uploaded using the creatives API. This call updates the\n`is_setup_completed` bit on the proposal and also notifies the seller.\nThe server will advance the revision number of the most recent proposal.",
"description":"List proposals. A filter expression (PQL query) may be specified to\nfilter the results. To retrieve all finalized proposals, regardless if a\nproposal is being renegotiated, see the FinalizedProposals resource.\nNote that Bidder/ChildSeat relationships differ from the usual behavior.\nA Bidder account can only see its child seats' proposals by specifying\nthe ChildSeat's accountId in the request path.",
"description":"An optional PQL filter query used to query for proposals.\n\nNested repeated fields, such as proposal.deals.targetingCriterion,\ncannot be filtered.",
"location":"query",
"type":"string"
},
"filterSyntax":{
"description":"Syntax the filter is written in. Current implementation defaults to PQL\nbut in the future it will be LIST_FILTER.",
"description":"Requested page size. The server may return fewer results than requested.\nIf unspecified, the server will pick an appropriate default.",
"description":"Update the given proposal to pause serving.\nThis method will set the\n`DealServingMetadata.DealPauseStatus.has_buyer_paused` bit to true for all\ndeals in the proposal.\n\nIt is a no-op to pause an already-paused proposal.\nIt is an error to call PauseProposal for a proposal that is not\nfinalized or renegotiating.",
"description":"Update the given proposal to resume serving.\nThis method will set the\n`DealServingMetadata.DealPauseStatus.has_buyer_paused` bit to false for all\ndeals in the proposal.\n\nNote that if the `has_seller_paused` bit is also set, serving will not\nresume until the seller also resumes.\n\nIt is a no-op to resume an already-running proposal.\nIt is an error to call ResumeProposal for a proposal that is not\nfinalized or renegotiating.",
"description":"Update the given proposal at the client known revision number. If the\nserver revision has advanced since the passed-in\n`proposal.proposal_revision`, an `ABORTED` error message will be returned.\nOnly the buyer-modifiable fields of the proposal will be updated.\n\nNote that the deals in the proposal will be updated to match the passed-in\ncopy.\nIf a passed-in deal does not have a `deal_id`, the server will assign a new\nunique ID and create the deal.\nIf passed-in deal has a `deal_id`, it will be updated to match the\npassed-in copy.\nAny existing deals not present in the passed-in proposal will be deleted.\nIt is an error to pass in a deal with a `deal_id` not present at head.",
"description":"Deletes a single creative.\n\nA creative is deactivated upon deletion and does not count against active\nsnippet quota. A deleted creative should not be used in bidding (all bids\nwith that creative will be rejected).",
"description":"Name of the owner (bidder or account) of the creative to be deleted.\nFor example:\n\n- For an account-level creative for the buyer account representing bidder\n 123: `bidders/123/accounts/123`\n\n- For an account-level creative for the child seat buyer account 456\n whose bidder is 123: `bidders/123/accounts/456`",
"description":"Whether the filter set is transient, or should be persisted indefinitely.\nBy default, filter sets are not transient.\nIf transient, it will be available for at least 1 hour after creation.",
"description":"Name of the owner (bidder or account) of the filter set to be created.\nFor example:\n\n- For a bidder-level filter set for bidder 123: `bidders/123`\n\n- For an account-level filter set for the buyer account representing bidder\n 123: `bidders/123/accounts/123`\n\n- For an account-level filter set for the child seat buyer account 456\n whose bidder is 123: `bidders/123/accounts/456`",
"description":"Full name of the resource to delete.\nFor example:\n\n- For a bidder-level filter set for bidder 123:\n `bidders/123/filterSets/abc`\n\n- For an account-level filter set for the buyer account representing bidder\n 123: `bidders/123/accounts/123/filterSets/abc`\n\n- For an account-level filter set for the child seat buyer account 456\n whose bidder is 123: `bidders/123/accounts/456/filterSets/abc`",
"description":"Full name of the resource being requested.\nFor example:\n\n- For a bidder-level filter set for bidder 123:\n `bidders/123/filterSets/abc`\n\n- For an account-level filter set for the buyer account representing bidder\n 123: `bidders/123/accounts/123/filterSets/abc`\n\n- For an account-level filter set for the child seat buyer account 456\n whose bidder is 123: `bidders/123/accounts/456/filterSets/abc`",
"description":"Name of the owner (bidder or account) of the filter sets to be listed.\nFor example:\n\n- For a bidder-level filter set for bidder 123: `bidders/123`\n\n- For an account-level filter set for the buyer account representing bidder\n 123: `bidders/123/accounts/123`\n\n- For an account-level filter set for the child seat buyer account 456\n whose bidder is 123: `bidders/123/accounts/456`",
"description":"Requested page size. The server may return fewer results than requested.\nIf unspecified, the server will pick an appropriate default.",
"description":"A token identifying a page of results the server should return.\nTypically, this is the value of\nListFilterSetsResponse.nextPageToken\nreturned from the previous call to the\naccounts.filterSets.list\nmethod.",
"description":"Name of the filter set that should be applied to the requested metrics.\nFor example:\n\n- For a bidder-level filter set for bidder 123:\n `bidders/123/filterSets/abc`\n\n- For an account-level filter set for the buyer account representing bidder\n 123: `bidders/123/accounts/123/filterSets/abc`\n\n- For an account-level filter set for the child seat buyer account 456\n whose bidder is 123: `bidders/123/accounts/456/filterSets/abc`",
"description":"Requested page size. The server may return fewer results than requested.\nIf unspecified, the server will pick an appropriate default.",
"description":"A token identifying a page of results the server should return.\nTypically, this is the value of\nListBidMetricsResponse.nextPageToken\nreturned from the previous call to the bidMetrics.list\nmethod.",
"description":"Name of the filter set that should be applied to the requested metrics.\nFor example:\n\n- For a bidder-level filter set for bidder 123:\n `bidders/123/filterSets/abc`\n\n- For an account-level filter set for the buyer account representing bidder\n 123: `bidders/123/accounts/123/filterSets/abc`\n\n- For an account-level filter set for the child seat buyer account 456\n whose bidder is 123: `bidders/123/accounts/456/filterSets/abc`",
"description":"Requested page size. The server may return fewer results than requested.\nIf unspecified, the server will pick an appropriate default.",
"description":"A token identifying a page of results the server should return.\nTypically, this is the value of\nListBidResponseErrorsResponse.nextPageToken\nreturned from the previous call to the bidResponseErrors.list\nmethod.",
"description":"List all reasons for which bid responses were considered to have no\napplicable bids, with the number of bid responses affected for each reason.",
"description":"Name of the filter set that should be applied to the requested metrics.\nFor example:\n\n- For a bidder-level filter set for bidder 123:\n `bidders/123/filterSets/abc`\n\n- For an account-level filter set for the buyer account representing bidder\n 123: `bidders/123/accounts/123/filterSets/abc`\n\n- For an account-level filter set for the child seat buyer account 456\n whose bidder is 123: `bidders/123/accounts/456/filterSets/abc`",
"description":"Requested page size. The server may return fewer results than requested.\nIf unspecified, the server will pick an appropriate default.",
"description":"A token identifying a page of results the server should return.\nTypically, this is the value of\nListBidResponsesWithoutBidsResponse.nextPageToken\nreturned from the previous call to the bidResponsesWithoutBids.list\nmethod.",
"description":"List all reasons that caused a bid request not to be sent for an\nimpression, with the number of bid requests not sent for each reason.",
"description":"Name of the filter set that should be applied to the requested metrics.\nFor example:\n\n- For a bidder-level filter set for bidder 123:\n `bidders/123/filterSets/abc`\n\n- For an account-level filter set for the buyer account representing bidder\n 123: `bidders/123/accounts/123/filterSets/abc`\n\n- For an account-level filter set for the child seat buyer account 456\n whose bidder is 123: `bidders/123/accounts/456/filterSets/abc`",
"description":"Requested page size. The server may return fewer results than requested.\nIf unspecified, the server will pick an appropriate default.",
"description":"A token identifying a page of results the server should return.\nTypically, this is the value of\nListFilteredBidRequestsResponse.nextPageToken\nreturned from the previous call to the filteredBidRequests.list\nmethod.",
"description":"Name of the filter set that should be applied to the requested metrics.\nFor example:\n\n- For a bidder-level filter set for bidder 123:\n `bidders/123/filterSets/abc`\n\n- For an account-level filter set for the buyer account representing bidder\n 123: `bidders/123/accounts/123/filterSets/abc`\n\n- For an account-level filter set for the child seat buyer account 456\n whose bidder is 123: `bidders/123/accounts/456/filterSets/abc`",
"description":"Requested page size. The server may return fewer results than requested.\nIf unspecified, the server will pick an appropriate default.",
"format":"int32",
"location":"query",
"type":"integer"
},
"pageToken":{
"description":"A token identifying a page of results the server should return.\nTypically, this is the value of\nListFilteredBidsResponse.nextPageToken\nreturned from the previous call to the filteredBids.list\nmethod.",
"description":"List all creatives associated with a specific reason for which bids were\nfiltered, with the number of bids filtered for each creative.",
"description":"The ID of the creative status for which to retrieve a breakdown by\ncreative.\nSee\n[creative-status-codes](https://developers.google.com/authorized-buyers/rtb/downloads/creative-status-codes).",
"format":"int32",
"location":"path",
"required":true,
"type":"integer"
},
"filterSetName":{
"description":"Name of the filter set that should be applied to the requested metrics.\nFor example:\n\n- For a bidder-level filter set for bidder 123:\n `bidders/123/filterSets/abc`\n\n- For an account-level filter set for the buyer account representing bidder\n 123: `bidders/123/accounts/123/filterSets/abc`\n\n- For an account-level filter set for the child seat buyer account 456\n whose bidder is 123: `bidders/123/accounts/456/filterSets/abc`",
"description":"Requested page size. The server may return fewer results than requested.\nIf unspecified, the server will pick an appropriate default.",
"format":"int32",
"location":"query",
"type":"integer"
},
"pageToken":{
"description":"A token identifying a page of results the server should return.\nTypically, this is the value of\nListCreativeStatusBreakdownByCreativeResponse.nextPageToken\nreturned from the previous call to the filteredBids.creatives.list\nmethod.",
"description":"The ID of the creative status for which to retrieve a breakdown by detail.\nSee\n[creative-status-codes](https://developers.google.com/authorized-buyers/rtb/downloads/creative-status-codes).\nDetails are only available for statuses 10, 14, 15, 17, 18, 19, 86, and 87.",
"format":"int32",
"location":"path",
"required":true,
"type":"integer"
},
"filterSetName":{
"description":"Name of the filter set that should be applied to the requested metrics.\nFor example:\n\n- For a bidder-level filter set for bidder 123:\n `bidders/123/filterSets/abc`\n\n- For an account-level filter set for the buyer account representing bidder\n 123: `bidders/123/accounts/123/filterSets/abc`\n\n- For an account-level filter set for the child seat buyer account 456\n whose bidder is 123: `bidders/123/accounts/456/filterSets/abc`",
"description":"Requested page size. The server may return fewer results than requested.\nIf unspecified, the server will pick an appropriate default.",
"format":"int32",
"location":"query",
"type":"integer"
},
"pageToken":{
"description":"A token identifying a page of results the server should return.\nTypically, this is the value of\nListCreativeStatusBreakdownByDetailResponse.nextPageToken\nreturned from the previous call to the filteredBids.details.list\nmethod.",
"description":"Name of the filter set that should be applied to the requested metrics.\nFor example:\n\n- For a bidder-level filter set for bidder 123:\n `bidders/123/filterSets/abc`\n\n- For an account-level filter set for the buyer account representing bidder\n 123: `bidders/123/accounts/123/filterSets/abc`\n\n- For an account-level filter set for the child seat buyer account 456\n whose bidder is 123: `bidders/123/accounts/456/filterSets/abc`",
"description":"Requested page size. The server may return fewer results than requested.\nIf unspecified, the server will pick an appropriate default.",
"format":"int32",
"location":"query",
"type":"integer"
},
"pageToken":{
"description":"A token identifying a page of results the server should return.\nTypically, this is the value of\nListImpressionMetricsResponse.nextPageToken\nreturned from the previous call to the impressionMetrics.list\nmethod.",
"description":"Name of the filter set that should be applied to the requested metrics.\nFor example:\n\n- For a bidder-level filter set for bidder 123:\n `bidders/123/filterSets/abc`\n\n- For an account-level filter set for the buyer account representing bidder\n 123: `bidders/123/accounts/123/filterSets/abc`\n\n- For an account-level filter set for the child seat buyer account 456\n whose bidder is 123: `bidders/123/accounts/456/filterSets/abc`",
"description":"Requested page size. The server may return fewer results than requested.\nIf unspecified, the server will pick an appropriate default.",
"format":"int32",
"location":"query",
"type":"integer"
},
"pageToken":{
"description":"A token identifying a page of results the server should return.\nTypically, this is the value of\nListLosingBidsResponse.nextPageToken\nreturned from the previous call to the losingBids.list\nmethod.",
"description":"Name of the filter set that should be applied to the requested metrics.\nFor example:\n\n- For a bidder-level filter set for bidder 123:\n `bidders/123/filterSets/abc`\n\n- For an account-level filter set for the buyer account representing bidder\n 123: `bidders/123/accounts/123/filterSets/abc`\n\n- For an account-level filter set for the child seat buyer account 456\n whose bidder is 123: `bidders/123/accounts/456/filterSets/abc`",
"description":"Requested page size. The server may return fewer results than requested.\nIf unspecified, the server will pick an appropriate default.",
"format":"int32",
"location":"query",
"type":"integer"
},
"pageToken":{
"description":"A token identifying a page of results the server should return.\nTypically, this is the value of\nListNonBillableWinningBidsResponse.nextPageToken\nreturned from the previous call to the nonBillableWinningBids.list\nmethod.",
"description":"Whether the filter set is transient, or should be persisted indefinitely.\nBy default, filter sets are not transient.\nIf transient, it will be available for at least 1 hour after creation.",
"location":"query",
"type":"boolean"
},
"ownerName":{
"description":"Name of the owner (bidder or account) of the filter set to be created.\nFor example:\n\n- For a bidder-level filter set for bidder 123: `bidders/123`\n\n- For an account-level filter set for the buyer account representing bidder\n 123: `bidders/123/accounts/123`\n\n- For an account-level filter set for the child seat buyer account 456\n whose bidder is 123: `bidders/123/accounts/456`",
"description":"Full name of the resource to delete.\nFor example:\n\n- For a bidder-level filter set for bidder 123:\n `bidders/123/filterSets/abc`\n\n- For an account-level filter set for the buyer account representing bidder\n 123: `bidders/123/accounts/123/filterSets/abc`\n\n- For an account-level filter set for the child seat buyer account 456\n whose bidder is 123: `bidders/123/accounts/456/filterSets/abc`",
"description":"Full name of the resource being requested.\nFor example:\n\n- For a bidder-level filter set for bidder 123:\n `bidders/123/filterSets/abc`\n\n- For an account-level filter set for the buyer account representing bidder\n 123: `bidders/123/accounts/123/filterSets/abc`\n\n- For an account-level filter set for the child seat buyer account 456\n whose bidder is 123: `bidders/123/accounts/456/filterSets/abc`",
"description":"Name of the owner (bidder or account) of the filter sets to be listed.\nFor example:\n\n- For a bidder-level filter set for bidder 123: `bidders/123`\n\n- For an account-level filter set for the buyer account representing bidder\n 123: `bidders/123/accounts/123`\n\n- For an account-level filter set for the child seat buyer account 456\n whose bidder is 123: `bidders/123/accounts/456`",
"location":"path",
"pattern":"^bidders/[^/]+$",
"required":true,
"type":"string"
},
"pageSize":{
"description":"Requested page size. The server may return fewer results than requested.\nIf unspecified, the server will pick an appropriate default.",
"format":"int32",
"location":"query",
"type":"integer"
},
"pageToken":{
"description":"A token identifying a page of results the server should return.\nTypically, this is the value of\nListFilterSetsResponse.nextPageToken\nreturned from the previous call to the\naccounts.filterSets.list\nmethod.",
"description":"Name of the filter set that should be applied to the requested metrics.\nFor example:\n\n- For a bidder-level filter set for bidder 123:\n `bidders/123/filterSets/abc`\n\n- For an account-level filter set for the buyer account representing bidder\n 123: `bidders/123/accounts/123/filterSets/abc`\n\n- For an account-level filter set for the child seat buyer account 456\n whose bidder is 123: `bidders/123/accounts/456/filterSets/abc`",
"location":"path",
"pattern":"^bidders/[^/]+/filterSets/[^/]+$",
"required":true,
"type":"string"
},
"pageSize":{
"description":"Requested page size. The server may return fewer results than requested.\nIf unspecified, the server will pick an appropriate default.",
"description":"A token identifying a page of results the server should return.\nTypically, this is the value of\nListBidMetricsResponse.nextPageToken\nreturned from the previous call to the bidMetrics.list\nmethod.",
"description":"Name of the filter set that should be applied to the requested metrics.\nFor example:\n\n- For a bidder-level filter set for bidder 123:\n `bidders/123/filterSets/abc`\n\n- For an account-level filter set for the buyer account representing bidder\n 123: `bidders/123/accounts/123/filterSets/abc`\n\n- For an account-level filter set for the child seat buyer account 456\n whose bidder is 123: `bidders/123/accounts/456/filterSets/abc`",
"location":"path",
"pattern":"^bidders/[^/]+/filterSets/[^/]+$",
"required":true,
"type":"string"
},
"pageSize":{
"description":"Requested page size. The server may return fewer results than requested.\nIf unspecified, the server will pick an appropriate default.",
"format":"int32",
"location":"query",
"type":"integer"
},
"pageToken":{
"description":"A token identifying a page of results the server should return.\nTypically, this is the value of\nListBidResponseErrorsResponse.nextPageToken\nreturned from the previous call to the bidResponseErrors.list\nmethod.",
"description":"List all reasons for which bid responses were considered to have no\napplicable bids, with the number of bid responses affected for each reason.",
"description":"Name of the filter set that should be applied to the requested metrics.\nFor example:\n\n- For a bidder-level filter set for bidder 123:\n `bidders/123/filterSets/abc`\n\n- For an account-level filter set for the buyer account representing bidder\n 123: `bidders/123/accounts/123/filterSets/abc`\n\n- For an account-level filter set for the child seat buyer account 456\n whose bidder is 123: `bidders/123/accounts/456/filterSets/abc`",
"location":"path",
"pattern":"^bidders/[^/]+/filterSets/[^/]+$",
"required":true,
"type":"string"
},
"pageSize":{
"description":"Requested page size. The server may return fewer results than requested.\nIf unspecified, the server will pick an appropriate default.",
"format":"int32",
"location":"query",
"type":"integer"
},
"pageToken":{
"description":"A token identifying a page of results the server should return.\nTypically, this is the value of\nListBidResponsesWithoutBidsResponse.nextPageToken\nreturned from the previous call to the bidResponsesWithoutBids.list\nmethod.",
"description":"List all reasons that caused a bid request not to be sent for an\nimpression, with the number of bid requests not sent for each reason.",
"description":"Name of the filter set that should be applied to the requested metrics.\nFor example:\n\n- For a bidder-level filter set for bidder 123:\n `bidders/123/filterSets/abc`\n\n- For an account-level filter set for the buyer account representing bidder\n 123: `bidders/123/accounts/123/filterSets/abc`\n\n- For an account-level filter set for the child seat buyer account 456\n whose bidder is 123: `bidders/123/accounts/456/filterSets/abc`",
"location":"path",
"pattern":"^bidders/[^/]+/filterSets/[^/]+$",
"required":true,
"type":"string"
},
"pageSize":{
"description":"Requested page size. The server may return fewer results than requested.\nIf unspecified, the server will pick an appropriate default.",
"format":"int32",
"location":"query",
"type":"integer"
},
"pageToken":{
"description":"A token identifying a page of results the server should return.\nTypically, this is the value of\nListFilteredBidRequestsResponse.nextPageToken\nreturned from the previous call to the filteredBidRequests.list\nmethod.",
"description":"Name of the filter set that should be applied to the requested metrics.\nFor example:\n\n- For a bidder-level filter set for bidder 123:\n `bidders/123/filterSets/abc`\n\n- For an account-level filter set for the buyer account representing bidder\n 123: `bidders/123/accounts/123/filterSets/abc`\n\n- For an account-level filter set for the child seat buyer account 456\n whose bidder is 123: `bidders/123/accounts/456/filterSets/abc`",
"location":"path",
"pattern":"^bidders/[^/]+/filterSets/[^/]+$",
"required":true,
"type":"string"
},
"pageSize":{
"description":"Requested page size. The server may return fewer results than requested.\nIf unspecified, the server will pick an appropriate default.",
"format":"int32",
"location":"query",
"type":"integer"
},
"pageToken":{
"description":"A token identifying a page of results the server should return.\nTypically, this is the value of\nListFilteredBidsResponse.nextPageToken\nreturned from the previous call to the filteredBids.list\nmethod.",
"description":"List all creatives associated with a specific reason for which bids were\nfiltered, with the number of bids filtered for each creative.",
"description":"The ID of the creative status for which to retrieve a breakdown by\ncreative.\nSee\n[creative-status-codes](https://developers.google.com/authorized-buyers/rtb/downloads/creative-status-codes).",
"format":"int32",
"location":"path",
"required":true,
"type":"integer"
},
"filterSetName":{
"description":"Name of the filter set that should be applied to the requested metrics.\nFor example:\n\n- For a bidder-level filter set for bidder 123:\n `bidders/123/filterSets/abc`\n\n- For an account-level filter set for the buyer account representing bidder\n 123: `bidders/123/accounts/123/filterSets/abc`\n\n- For an account-level filter set for the child seat buyer account 456\n whose bidder is 123: `bidders/123/accounts/456/filterSets/abc`",
"location":"path",
"pattern":"^bidders/[^/]+/filterSets/[^/]+$",
"required":true,
"type":"string"
},
"pageSize":{
"description":"Requested page size. The server may return fewer results than requested.\nIf unspecified, the server will pick an appropriate default.",
"format":"int32",
"location":"query",
"type":"integer"
},
"pageToken":{
"description":"A token identifying a page of results the server should return.\nTypically, this is the value of\nListCreativeStatusBreakdownByCreativeResponse.nextPageToken\nreturned from the previous call to the filteredBids.creatives.list\nmethod.",
"description":"The ID of the creative status for which to retrieve a breakdown by detail.\nSee\n[creative-status-codes](https://developers.google.com/authorized-buyers/rtb/downloads/creative-status-codes).\nDetails are only available for statuses 10, 14, 15, 17, 18, 19, 86, and 87.",
"format":"int32",
"location":"path",
"required":true,
"type":"integer"
},
"filterSetName":{
"description":"Name of the filter set that should be applied to the requested metrics.\nFor example:\n\n- For a bidder-level filter set for bidder 123:\n `bidders/123/filterSets/abc`\n\n- For an account-level filter set for the buyer account representing bidder\n 123: `bidders/123/accounts/123/filterSets/abc`\n\n- For an account-level filter set for the child seat buyer account 456\n whose bidder is 123: `bidders/123/accounts/456/filterSets/abc`",
"location":"path",
"pattern":"^bidders/[^/]+/filterSets/[^/]+$",
"required":true,
"type":"string"
},
"pageSize":{
"description":"Requested page size. The server may return fewer results than requested.\nIf unspecified, the server will pick an appropriate default.",
"format":"int32",
"location":"query",
"type":"integer"
},
"pageToken":{
"description":"A token identifying a page of results the server should return.\nTypically, this is the value of\nListCreativeStatusBreakdownByDetailResponse.nextPageToken\nreturned from the previous call to the filteredBids.details.list\nmethod.",
"description":"Name of the filter set that should be applied to the requested metrics.\nFor example:\n\n- For a bidder-level filter set for bidder 123:\n `bidders/123/filterSets/abc`\n\n- For an account-level filter set for the buyer account representing bidder\n 123: `bidders/123/accounts/123/filterSets/abc`\n\n- For an account-level filter set for the child seat buyer account 456\n whose bidder is 123: `bidders/123/accounts/456/filterSets/abc`",
"location":"path",
"pattern":"^bidders/[^/]+/filterSets/[^/]+$",
"required":true,
"type":"string"
},
"pageSize":{
"description":"Requested page size. The server may return fewer results than requested.\nIf unspecified, the server will pick an appropriate default.",
"format":"int32",
"location":"query",
"type":"integer"
},
"pageToken":{
"description":"A token identifying a page of results the server should return.\nTypically, this is the value of\nListImpressionMetricsResponse.nextPageToken\nreturned from the previous call to the impressionMetrics.list\nmethod.",
"description":"Name of the filter set that should be applied to the requested metrics.\nFor example:\n\n- For a bidder-level filter set for bidder 123:\n `bidders/123/filterSets/abc`\n\n- For an account-level filter set for the buyer account representing bidder\n 123: `bidders/123/accounts/123/filterSets/abc`\n\n- For an account-level filter set for the child seat buyer account 456\n whose bidder is 123: `bidders/123/accounts/456/filterSets/abc`",
"location":"path",
"pattern":"^bidders/[^/]+/filterSets/[^/]+$",
"required":true,
"type":"string"
},
"pageSize":{
"description":"Requested page size. The server may return fewer results than requested.\nIf unspecified, the server will pick an appropriate default.",
"format":"int32",
"location":"query",
"type":"integer"
},
"pageToken":{
"description":"A token identifying a page of results the server should return.\nTypically, this is the value of\nListLosingBidsResponse.nextPageToken\nreturned from the previous call to the losingBids.list\nmethod.",
"description":"Name of the filter set that should be applied to the requested metrics.\nFor example:\n\n- For a bidder-level filter set for bidder 123:\n `bidders/123/filterSets/abc`\n\n- For an account-level filter set for the buyer account representing bidder\n 123: `bidders/123/accounts/123/filterSets/abc`\n\n- For an account-level filter set for the child seat buyer account 456\n whose bidder is 123: `bidders/123/accounts/456/filterSets/abc`",
"location":"path",
"pattern":"^bidders/[^/]+/filterSets/[^/]+$",
"required":true,
"type":"string"
},
"pageSize":{
"description":"Requested page size. The server may return fewer results than requested.\nIf unspecified, the server will pick an appropriate default.",
"format":"int32",
"location":"query",
"type":"integer"
},
"pageToken":{
"description":"A token identifying a page of results the server should return.\nTypically, this is the value of\nListNonBillableWinningBidsResponse.nextPageToken\nreturned from the previous call to the nonBillableWinningBids.list\nmethod.",
"description":"An absolute date range, specified by its start date and end date.\nThe supported range of dates begins 30 days before today and ends today.\nValidity checked upon filter set creation. If a filter set with an absolute\ndate range is run at a later date more than 30 days after start_date, it will\nfail.",
"id":"AbsoluteDateRange",
"properties":{
"endDate":{
"$ref":"Date",
"description":"The end date of the range (inclusive).\nMust be within the 30 days leading up to current date, and must be equal to\nor after start_date."
},
"startDate":{
"$ref":"Date",
"description":"The start date of the range (inclusive).\nMust be within the 30 days leading up to current date, and must be equal to\nor before end_date."
}
},
"type":"object"
},
"AcceptProposalRequest":{
"description":"Request to accept a proposal.",
"id":"AcceptProposalRequest",
"properties":{
"proposalRevision":{
"description":"The last known client revision number of the proposal.",
"format":"int64",
"type":"string"
}
},
"type":"object"
},
"AdSize":{
"description":"Represents size of a single ad slot, or a creative.",
"id":"AdSize",
"properties":{
"height":{
"description":"The height of the ad slot in pixels.\nThis field will be present only when size type is `PIXEL`.",
"format":"int64",
"type":"string"
},
"sizeType":{
"description":"The size type of the ad slot.",
"enum":[
"SIZE_TYPE_UNSPECIFIED",
"PIXEL",
"INTERSTITIAL",
"NATIVE",
"FLUID"
],
"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\nchange of outside environment."
],
"type":"string"
},
"width":{
"description":"The width of the ad slot in pixels.\nThis field will be present only when size type is `PIXEL`.",
"format":"int64",
"type":"string"
}
},
"type":"object"
},
"AddDealAssociationRequest":{
"description":"A request for associating a deal and a creative.",
"id":"AddDealAssociationRequest",
"properties":{
"association":{
"$ref":"CreativeDealAssociation",
"description":"The association between a creative and a deal that should be added."
}
},
"type":"object"
},
"AddNoteRequest":{
"description":"Request message for adding a note to a given proposal.",
"id":"AddNoteRequest",
"properties":{
"note":{
"$ref":"Note",
"description":"Details of the note to add."
}
},
"type":"object"
},
"AppContext":{
"description":"@OutputOnly The app type the restriction applies to for mobile device.",
"id":"AppContext",
"properties":{
"appTypes":{
"description":"The app types this restriction applies to.",
"enumDescriptions":[
"Native app context.",
"Mobile web app context."
],
"items":{
"enum":[
"NATIVE",
"WEB"
],
"type":"string"
},
"type":"array"
}
},
"type":"object"
},
"AuctionContext":{
"description":"@OutputOnly The auction type the restriction applies to.",
"id":"AuctionContext",
"properties":{
"auctionTypes":{
"description":"The auction types this restriction applies to.",
"enumDescriptions":[
"The restriction applies to open auction.",
"The restriction applies to direct deals."
],
"items":{
"enum":[
"OPEN_AUCTION",
"DIRECT_DEALS"
],
"type":"string"
},
"type":"array"
}
},
"type":"object"
},
"BidMetricsRow":{
"description":"The set of metrics that are measured in numbers of bids, representing how\nmany bids with the specified dimension values were considered eligible at\neach stage of the bidding funnel;",
"id":"BidMetricsRow",
"properties":{
"bids":{
"$ref":"MetricValue",
"description":"The number of bids that Ad Exchange received from the buyer."
},
"bidsInAuction":{
"$ref":"MetricValue",
"description":"The number of bids that were permitted to compete in the auction."
},
"billedImpressions":{
"$ref":"MetricValue",
"description":"The number of bids for which the buyer was billed."
},
"impressionsWon":{
"$ref":"MetricValue",
"description":"The number of bids that won an impression."
},
"measurableImpressions":{
"$ref":"MetricValue",
"description":"The number of bids for which the corresponding impression was measurable\nfor viewability (as defined by Active View)."
},
"rowDimensions":{
"$ref":"RowDimensions",
"description":"The values of all dimensions associated with metric values in this row."
},
"viewableImpressions":{
"$ref":"MetricValue",
"description":"The number of bids for which the corresponding impression was viewable (as\ndefined by Active View)."
}
},
"type":"object"
},
"BidResponseWithoutBidsStatusRow":{
"description":"The number of impressions with the specified dimension values that were\nconsidered to have no applicable bids, as described by the specified status.",
"id":"BidResponseWithoutBidsStatusRow",
"properties":{
"impressionCount":{
"$ref":"MetricValue",
"description":"The number of impressions for which there was a bid response with the\nspecified status."
},
"rowDimensions":{
"$ref":"RowDimensions",
"description":"The values of all dimensions associated with metric values in this row."
},
"status":{
"description":"The status specifying why the bid responses were considered to have no\napplicable bids.",
"enum":[
"STATUS_UNSPECIFIED",
"RESPONSES_WITHOUT_BIDS",
"RESPONSES_WITHOUT_BIDS_FOR_ACCOUNT",
"RESPONSES_WITHOUT_BIDS_FOR_DEAL"
],
"enumDescriptions":[
"A placeholder for an undefined status.\nThis 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\nincluded bids on behalf of other accounts.",
"The response had no bids for the specified deal, though it may have\nincluded bids on other deals on behalf of the account to which the deal\nbelongs."
],
"type":"string"
}
},
"type":"object"
},
"Buyer":{
"description":"Represents a buyer of inventory. Each buyer is identified by a unique\nAuthorized Buyers account ID.",
"id":"Buyer",
"properties":{
"accountId":{
"description":"Authorized Buyers account ID of the buyer.",
"type":"string"
}
},
"type":"object"
},
"CalloutStatusRow":{
"description":"The number of impressions with the specified dimension values where the\ncorresponding bid request or bid response was not successful, as described by\nthe specified callout status.",
"id":"CalloutStatusRow",
"properties":{
"calloutStatusId":{
"description":"The ID of the callout status.\nSee [callout-status-codes](https://developers.google.com/authorized-buyers/rtb/downloads/callout-status-codes).",
"format":"int32",
"type":"integer"
},
"impressionCount":{
"$ref":"MetricValue",
"description":"The number of impressions for which there was a bid request or bid response\nwith the specified callout status."
},
"rowDimensions":{
"$ref":"RowDimensions",
"description":"The values of all dimensions associated with metric values in this row."
}
},
"type":"object"
},
"CancelNegotiationRequest":{
"description":"Request to cancel an ongoing negotiation.",
"id":"CancelNegotiationRequest",
"properties":{},
"type":"object"
},
"Client":{
"description":"A client resource represents a client buyer\u0026mdash;an agency, a brand, or an\nadvertiser customer of the sponsor buyer. Users associated with the client\nbuyer have restricted access to the Marketplace and certain other sections of\nthe Authorized Buyers UI based on the role granted to the client buyer. All\nfields are required unless otherwise specified.",
"id":"Client",
"properties":{
"clientAccountId":{
"description":"The globally-unique numerical ID of the client.\nThe value of this field is ignored in create and update operations.",
"format":"int64",
"type":"string"
},
"clientName":{
"description":"Name used to represent this client to publishers.\nYou may have multiple clients that map to the same entity,\nbut for each client the combination of `clientName` and entity\nmust be unique.\nYou can specify this field as empty.",
"type":"string"
},
"entityId":{
"description":"Numerical identifier of the client entity.\nThe entity can be an advertiser, a brand, or an agency.\nThis identifier is unique among all the entities with the same type.\n\nA list of all known advertisers with their identifiers is available in the\n[advertisers.txt](https://storage.googleapis.com/adx-rtb-dictionaries/advertisers.txt)\nfile.\n\nA list of all known brands with their identifiers is available in the\n[brands.txt](https://storage.googleapis.com/adx-rtb-dictionaries/brands.txt)\nfile.\n\nA list of all known agencies with their identifiers is available in the\n[agencies.txt](https://storage.googleapis.com/adx-rtb-dictionaries/agencies.txt)\nfile.",
"format":"int64",
"type":"string"
},
"entityName":{
"description":"The name of the entity. This field is automatically fetched based on\nthe type and ID.\nThe value of this field is ignored in create and update operations.",
"type":"string"
},
"entityType":{
"description":"The type of the client entity: `ADVERTISER`, `BRAND`, or `AGENCY`.",
"enum":[
"ENTITY_TYPE_UNSPECIFIED",
"ADVERTISER",
"BRAND",
"AGENCY"
],
"enumDescriptions":[
"A placeholder for an undefined client entity type. Should not be used.",
"An advertiser.",
"A brand.",
"An advertising agency."
],
"type":"string"
},
"partnerClientId":{
"description":"Optional arbitrary unique identifier of this client buyer from the\nstandpoint of its Ad Exchange sponsor buyer.\n\nThis field can be used to associate a client buyer with the identifier\nin the namespace of its sponsor buyer, lookup client buyers by that\nidentifier and verify whether an Ad Exchange counterpart of a given client\nbuyer already exists.\n\nIf present, must be unique among all the client buyers for its\nAd Exchange sponsor buyer.",
"type":"string"
},
"role":{
"description":"The role which is assigned to the client buyer. Each role implies a set of\npermissions granted to the client. Must be one of `CLIENT_DEAL_VIEWER`,\n`CLIENT_DEAL_NEGOTIATOR` or `CLIENT_DEAL_APPROVER`.",
"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\nin the Marketplace.\nThey can neither negotiate proposals nor approve deals.\nIf this client is visible to publishers, they can send deal proposals\nto this client.",
"Users associated with this client can respond to deal proposals\nsent to them by publishers. They can also initiate deal proposals\nof their own.",
"Users associated with this client can approve eligible deals\non your behalf. Some deals may still explicitly require publisher\nfinalization. If this role is not selected, the sponsor buyer\nwill need to manually approve each of their deals."
],
"type":"string"
},
"status":{
"description":"The status of the client buyer.",
"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."
],
"type":"string"
},
"visibleToSeller":{
"description":"Whether the client buyer will be visible to sellers.",
"type":"boolean"
}
},
"type":"object"
},
"ClientUser":{
"description":"A client user is created under a client buyer and has restricted access to\nthe Marketplace and certain other sections of the Authorized Buyers UI based\non the role granted to the associated client buyer.\n\nThe only way a new client user can be created is via accepting an\nemail invitation\n(see the\naccounts.clients.invitations.create\nmethod).\n\nAll fields are required unless otherwise specified.",
"id":"ClientUser",
"properties":{
"clientAccountId":{
"description":"Numerical account ID of the client buyer\nwith which the user is associated; the\nbuyer must be a client of the current sponsor buyer.\nThe value of this field is ignored in an update operation.",
"format":"int64",
"type":"string"
},
"email":{
"description":"User's email address. The value of this field\nis ignored in an update operation.",
"type":"string"
},
"status":{
"description":"The status of the client user.",
"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."
],
"type":"string"
},
"userId":{
"description":"The unique numerical ID of the client user\nthat has accepted an invitation.\nThe value of this field is ignored in an update operation.",
"format":"int64",
"type":"string"
}
},
"type":"object"
},
"ClientUserInvitation":{
"description":"An invitation for a new client user to get access to the Authorized Buyers\nUI. All fields are required unless otherwise specified.",
"id":"ClientUserInvitation",
"properties":{
"clientAccountId":{
"description":"Numerical account ID of the client buyer\nthat the invited user is associated with.\nThe value of this field is ignored in create operations.",
"format":"int64",
"type":"string"
},
"email":{
"description":"The email address to which the invitation is sent. Email\naddresses should be unique among all client users under each sponsor\nbuyer.",
"type":"string"
},
"invitationId":{
"description":"The unique numerical ID of the invitation that is sent to the user.\nThe value of this field is ignored in create operations.",
"format":"int64",
"type":"string"
}
},
"type":"object"
},
"CompleteSetupRequest":{
"description":"Request message for indicating that the proposal's setup step is complete.",
"id":"CompleteSetupRequest",
"properties":{},
"type":"object"
},
"ContactInformation":{
"description":"Contains information on how a buyer or seller can be reached.",
"id":"ContactInformation",
"properties":{
"email":{
"description":"Email address for the contact.",
"type":"string"
},
"name":{
"description":"The name of the contact.",
"type":"string"
}
},
"type":"object"
},
"Correction":{
"description":"@OutputOnly Shows any corrections that were applied to this creative.",
"id":"Correction",
"properties":{
"contexts":{
"description":"The contexts for the correction.",
"items":{
"$ref":"ServingContext"
},
"type":"array"
},
"details":{
"description":"Additional details about what was corrected.",
"items":{
"type":"string"
},
"type":"array"
},
"type":{
"description":"The type of correction that was applied to the creative.",
"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"
],
"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.\nThe detected vendors were added.",
"The ad had the SSL attribute declared but was not SSL-compliant.\nThe SSL attribute was removed.",
"The ad was declared as Flash-free but contained Flash, so the Flash-free\nattribute was removed.",
"The ad was not declared as Flash-free but it did not reference any flash\ncontent, so the Flash-free attribute was added.",
"The ad did not declare a required creative attribute.\nThe attribute was added.",
"The ad did not declare a required technology vendor.\nThe technology vendor was added.",
"The ad did not declare the SSL attribute but was SSL-compliant, so the\nSSL attribute was added.",
"Properties consistent with In-banner video were found, so an\nIn-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\nwas removed.",
"The ad contains video content."
],
"type":"string"
}
},
"type":"object"
},
"Creative":{
"description":"A creative and its classification data.\n\nNext ID: 42",
"id":"Creative",
"properties":{
"accountId":{
"description":"The account that this creative belongs to.\nCan be used to filter the response of the\ncreatives.list\nmethod.",
"type":"string"
},
"adChoicesDestinationUrl":{
"description":"The link to AdChoices destination page.",
"type":"string"
},
"advertiserName":{
"description":"The name of the company being advertised in the creative.",
"type":"string"
},
"agencyId":{
"description":"The agency ID for this creative.",
"format":"int64",
"type":"string"
},
"apiUpdateTime":{
"description":"@OutputOnly The last update timestamp of the creative via API.",
"format":"google-datetime",
"type":"string"
},
"attributes":{
"description":"All attributes for the ads that may be shown from this creative.\nCan be used to filter the response of the\ncreatives.list\nmethod.",
"enumDescriptions":[
"Do not use. This is a placeholder value only.",
"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 is SSL.",
"The creative is non-SSL.",
"The creative is an interstitial.",
"The creative is eligible for native.",
"The creative is not eligible for native.",
"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."
],
"items":{
"enum":[
"ATTRIBUTE_UNSPECIFIED",
"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",
"RICH_MEDIA_CAPABILITY_TYPE_SSL",
"RICH_MEDIA_CAPABILITY_TYPE_NON_SSL",
"RICH_MEDIA_CAPABILITY_TYPE_INTERSTITIAL",
"NATIVE_ELIGIBILITY_ELIGIBLE",
"NATIVE_ELIGIBILITY_NOT_ELIGIBLE",
"IN_BANNER_VIDEO",
"RENDERING_SIZELESS_ADX",
"OMSDK_1_0"
],
"type":"string"
},
"type":"array"
},
"clickThroughUrls":{
"description":"The set of destination URLs for the creative.",
"items":{
"type":"string"
},
"type":"array"
},
"corrections":{
"description":"@OutputOnly Shows any corrections that were applied to this creative.",
"items":{
"$ref":"Correction"
},
"type":"array"
},
"creativeId":{
"description":"The buyer-defined creative ID of this creative.\nCan be used to filter the response of the\ncreatives.list\nmethod.",
"type":"string"
},
"dealsStatus":{
"description":"@OutputOnly The top-level deals status of this creative.\nIf disapproved, an entry for 'auctionType=DIRECT_DEALS' (or 'ALL') in\nserving_restrictions will also exist. Note\nthat this may be nuanced with other contextual restrictions, in which case,\nit may be preferable to read from serving_restrictions directly.\nCan be used to filter the response of the\ncreatives.list\nmethod.",
"enum":[
"STATUS_UNSPECIFIED",
"NOT_CHECKED",
"CONDITIONALLY_APPROVED",
"APPROVED",
"DISAPPROVED"
],
"enumDescriptions":[
"The status is unknown.",
"The creative has not been checked.",
"The creative has been conditionally approved.\nSee serving_restrictions for details.",
"The creative has been approved.",
"The creative has been disapproved."
],
"type":"string"
},
"declaredClickThroughUrls":{
"description":"The set of declared destination URLs for the creative.",
"items":{
"type":"string"
},
"type":"array"
},
"detectedAdvertiserIds":{
"description":"@OutputOnly Detected advertiser IDs, if any.",
"items":{
"format":"int64",
"type":"string"
},
"type":"array"
},
"detectedDomains":{
"description":"@OutputOnly\nThe detected domains for this creative.",
"items":{
"type":"string"
},
"type":"array"
},
"detectedLanguages":{
"description":"@OutputOnly\nThe detected languages for this creative. The order is arbitrary. The codes\nare 2 or 5 characters and are documented at\nhttps://developers.google.com/adwords/api/docs/appendix/languagecodes.",
"items":{
"type":"string"
},
"type":"array"
},
"detectedProductCategories":{
"description":"@OutputOnly Detected product categories, if any.\nSee the ad-product-categories.txt file in the technical documentation\nfor a list of IDs.",
"items":{
"format":"int32",
"type":"integer"
},
"type":"array"
},
"detectedSensitiveCategories":{
"description":"@OutputOnly Detected sensitive categories, if any.\nSee the ad-sensitive-categories.txt file in the technical documentation for\na list of IDs. You should use these IDs along with the\nexcluded-sensitive-category field in the bid request to filter your bids.",
"items":{
"format":"int32",
"type":"integer"
},
"type":"array"
},
"filteringStats":{
"$ref":"FilteringStats",
"description":"@OutputOnly The filtering stats for this creative."
},
"html":{
"$ref":"HtmlContent",
"description":"An HTML creative."
},
"impressionTrackingUrls":{
"description":"The set of URLs to be called to record an impression.",
"items":{
"type":"string"
},
"type":"array"
},
"native":{
"$ref":"NativeContent",
"description":"A native creative."
},
"openAuctionStatus":{
"description":"@OutputOnly The top-level open auction status of this creative.\nIf disapproved, an entry for 'auctionType = OPEN_AUCTION' (or 'ALL') in\nserving_restrictions will also exist. Note\nthat this may be nuanced with other contextual restrictions, in which case,\nit may be preferable to read from serving_restrictions directly.\nCan be used to filter the response of the\ncreatives.list\nmethod.",
"enum":[
"STATUS_UNSPECIFIED",
"NOT_CHECKED",
"CONDITIONALLY_APPROVED",
"APPROVED",
"DISAPPROVED"
],
"enumDescriptions":[
"The status is unknown.",
"The creative has not been checked.",
"The creative has been conditionally approved.\nSee serving_restrictions for details.",
"The creative has been approved.",
"The creative has been disapproved."
],
"type":"string"
},
"restrictedCategories":{
"description":"All restricted categories for the ads that may be shown from this creative.",
"enumDescriptions":[
"The ad has no restricted categories",
"The alcohol restricted category."
],
"items":{
"enum":[
"NO_RESTRICTED_CATEGORIES",
"ALCOHOL"
],
"type":"string"
},
"type":"array"
},
"servingRestrictions":{
"description":"@OutputOnly The granular status of this ad in specific contexts.\nA context here relates to where something ultimately serves (for example,\na physical location, a platform, an HTTPS vs HTTP request, or the type\nof auction).",
"items":{
"$ref":"ServingRestriction"
},
"type":"array"
},
"vendorIds":{
"description":"All vendor IDs for the ads that may be shown from this creative.\nSee https://storage.googleapis.com/adx-rtb-dictionaries/vendors.txt\nfor possible values.",
"items":{
"format":"int32",
"type":"integer"
},
"type":"array"
},
"version":{
"description":"@OutputOnly The version of this creative.",
"description":"Represents creative restrictions associated to Programmatic Guaranteed/\nPreferred Deal in Ad Manager.\nThis doesn't apply to Private Auction and AdX Preferred Deals.",
"description":"The format of the environment that the creatives will be displayed in.",
"enum":[
"CREATIVE_FORMAT_UNSPECIFIED",
"DISPLAY",
"VIDEO"
],
"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\nplayer."
],
"type":"string"
},
"creativeSpecifications":{
"items":{
"$ref":"CreativeSpecification"
},
"type":"array"
},
"skippableAdType":{
"description":"Skippable video ads allow viewers to skip ads after 5 seconds.",
"enum":[
"SKIPPABLE_AD_TYPE_UNSPECIFIED",
"SKIPPABLE",
"INSTREAM_SELECT",
"NOT_SKIPPABLE"
],
"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\nengaged view after 30 seconds. The creative is hosted on\nYouTube only, and viewcount of the YouTube video increments\nafter the engaged view.",
"description":"What formats are allowed by the publisher.\nIf this repeated field is empty then all formats are allowed.\nFor example, if this field contains AllowedFormatType.AUDIO then the\npublisher only allows an audio ad (without any video).",
"description":"For video creatives specifies the sizes of companion ads (if present).\nCompanion sizes may be filled in only when creative_size_type = VIDEO",
"items":{
"$ref":"Size"
},
"type":"array"
},
"creativeSizeType":{
"description":"The creative size type.",
"enum":[
"CREATIVE_SIZE_TYPE_UNSPECIFIED",
"REGULAR",
"INTERSTITIAL",
"VIDEO",
"NATIVE"
],
"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."
],
"type":"string"
},
"nativeTemplate":{
"description":"The native template for this creative. It will have a value only if\ncreative_size_type = CreativeSizeType.NATIVE.\n@OutputOnly",
"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."
],
"type":"string"
},
"size":{
"$ref":"Size",
"description":"For regular or video creative size type, specifies the size\nof the creative"
},
"skippableAdType":{
"description":"The type of skippable ad for this creative. It will have a value only if\ncreative_size_type = CreativeSizeType.VIDEO.",
"enum":[
"SKIPPABLE_AD_TYPE_UNSPECIFIED",
"GENERIC",
"INSTREAM_SELECT",
"NOT_SKIPPABLE"
],
"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\nengaged view after 30 seconds. The creative is hosted on\nYouTube only, and viewcount of the YouTube video increments\nafter the engaged view.",
"description":"The number of bids with the specified dimension values that did not win the\nauction (either were filtered pre-auction or lost the auction), as described\nby the specified creative status.",
"description":"The ID of the creative status.\nSee [creative-status-codes](https://developers.google.com/authorized-buyers/rtb/downloads/creative-status-codes).",
"description":"Represents a whole or partial calendar date, e.g. a birthday. The time of day\nand time zone are either specified elsewhere or are not significant. The date\nis relative to the Proleptic Gregorian Calendar. This can represent:\n\n* A full date, with non-zero year, month and day values\n* A month and day value, with a zero year, e.g. an anniversary\n* A year on its own, with zero month and day values\n* A year and month value, with a zero day, e.g. a credit card expiration date\n\nRelated types are google.type.TimeOfDay and `google.protobuf.Timestamp`.",
"description":"Day of month. Must be from 1 to 31 and valid for the year and month, or 0\nif specifying a year by itself or a year and month where the day is not\nsignificant.",
"description":"The ending time of the day for the ad to show (minute level granularity).\nThe end time is exclusive.\nThis field is not available for filtering in PQL queries."
},
"startTime":{
"$ref":"TimeOfDay",
"description":"The starting time of day for the ad to show (minute level granularity).\nThe start time is inclusive.\nThis field is not available for filtering in PQL queries."
"description":"A deal represents a segment of inventory for displaying ads on.\nA proposal can contain multiple deals. A deal contains the terms and targeting information that\nis used for serving.",
"description":"Proposed flight end time of the deal.\nThis will generally be stored in a granularity of a second.\nA value is not required for Private Auction deals or Preferred Deals.",
"description":"Optional proposed flight start time of the deal.\nThis will generally be stored in the granularity of one second since deal serving\nstarts at seconds boundary. Any time specified with more granularity\n(e.g., in milliseconds) will be truncated towards the start of time in seconds.",
"description":"Buyer private data (hidden from seller)."
},
"createProductId":{
"description":"The product ID from which this deal was created.\n\nNote: This field may be set only when creating the resource. Modifying\nthis field while updating the resource will result in an error.",
"type":"string"
},
"createProductRevision":{
"description":"Optional revision number of the product that the deal was created from.\nIf present on create, and the server `product_revision` has advanced sinced\nthe passed-in `create_product_revision`, an `ABORTED` error will be\nreturned.\n\nNote: This field may be set only when creating the resource. Modifying\nthis field while updating the resource will result in an error.",
"description":"Specifies the creative pre-approval policy.\n@OutputOnly",
"enum":[
"CREATIVE_PRE_APPROVAL_POLICY_UNSPECIFIED",
"SELLER_PRE_APPROVAL_REQUIRED",
"SELLER_PRE_APPROVAL_NOT_REQUIRED"
],
"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."
],
"type":"string"
},
"creativeRestrictions":{
"$ref":"CreativeRestrictions",
"description":"Restricitions about the creatives associated with the deal (i.e., size)\nThis is available for Programmatic Guaranteed/Preferred Deals in Ad Manager.\n@OutputOnly"
},
"creativeSafeFrameCompatibility":{
"description":"Specifies whether the creative is safeFrame compatible.\n@OutputOnly",
"enum":[
"CREATIVE_SAFE_FRAME_COMPATIBILITY_UNSPECIFIED",
"COMPATIBLE",
"INCOMPATIBLE"
],
"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."
],
"type":"string"
},
"dealId":{
"description":"A unique deal ID for the deal (server-assigned).\n@OutputOnly",
"type":"string"
},
"dealServingMetadata":{
"$ref":"DealServingMetadata",
"description":"Metadata about the serving status of this deal.\n@OutputOnly"
},
"dealTerms":{
"$ref":"DealTerms",
"description":"The negotiable terms of the deal."
},
"deliveryControl":{
"$ref":"DeliveryControl",
"description":"The set of fields around delivery control that are interesting for a buyer\nto see but are non-negotiable. These are set by the publisher."
},
"description":{
"description":"Description for the deal terms.",
"type":"string"
},
"displayName":{
"description":"The name of the deal.",
"type":"string"
},
"externalDealId":{
"description":"The external deal ID assigned to this deal once the deal is finalized.\nThis is the deal ID that shows up in serving/reporting etc.\n@OutputOnly",
"type":"string"
},
"isSetupComplete":{
"description":"True, if the buyside inventory setup is complete for this deal.\n@OutputOnly",
"type":"boolean"
},
"programmaticCreativeSource":{
"description":"Specifies the creative source for programmatic deals. PUBLISHER means\ncreative is provided by seller and ADVERTISER means creative is\nprovided by buyer.\n@OutputOnly",
"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"
},
"proposalId":{
"description":"ID of the proposal that this deal is part of.\n@OutputOnly",
"type":"string"
},
"sellerContacts":{
"description":"Seller contact information for the deal.\n@OutputOnly",
"items":{
"$ref":"ContactInformation"
},
"type":"array"
},
"syndicationProduct":{
"description":"The syndication product associated with the deal.\n\nNote: This field may be set only when creating the resource. Modifying\nthis field while updating the resource will result in an error.",
"enum":[
"SYNDICATION_PRODUCT_UNSPECIFIED",
"CONTENT",
"MOBILE",
"VIDEO",
"GAMES"
],
"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."
],
"type":"string"
},
"targeting":{
"$ref":"MarketplaceTargeting",
"description":"Specifies the subset of inventory targeted by the deal.\n@OutputOnly"
},
"targetingCriterion":{
"description":"The shared targeting visible to buyers and sellers. Each shared\ntargeting entity is AND'd together.",
"items":{
"$ref":"TargetingCriteria"
},
"type":"array"
},
"updateTime":{
"description":"The time when the deal was last updated.\n@OutputOnly",
"format":"google-datetime",
"type":"string"
},
"webPropertyCode":{
"description":"The web property code for the seller copied over from the product.",
"type":"string"
}
},
"type":"object"
},
"DealPauseStatus":{
"description":"Tracks which parties (if any) have paused a deal.\nThe deal is considered paused if either hasBuyerPaused or\nhasSellPaused is true.",
"id":"DealPauseStatus",
"properties":{
"buyerPauseReason":{
"description":"The buyer's reason for pausing, if the buyer paused the deal.",
"type":"string"
},
"firstPausedBy":{
"description":"The role of the person who first paused this deal.",
"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."
],
"type":"string"
},
"hasBuyerPaused":{
"description":"True, if the buyer has paused the deal unilaterally.",
"type":"boolean"
},
"hasSellerPaused":{
"description":"True, if the seller has paused the deal unilaterally.",
"type":"boolean"
},
"sellerPauseReason":{
"description":"The seller's reason for pausing, if the seller paused the deal.",
"type":"string"
}
},
"type":"object"
},
"DealServingMetadata":{
"description":"Message captures metadata about the serving status of a deal.",
"id":"DealServingMetadata",
"properties":{
"dealPauseStatus":{
"$ref":"DealPauseStatus",
"description":"Tracks which parties (if any) have paused a deal.\n@OutputOnly"
}
},
"type":"object"
},
"DealTerms":{
"description":"The deal terms specify the details of a Product/deal. They specify things\nlike price per buyer, the type of pricing model (e.g., fixed price, auction)\nand expected impressions from the publisher.",
"id":"DealTerms",
"properties":{
"brandingType":{
"description":"Visibility of the URL in bid requests. (default: BRANDED)",
"description":"Non-binding estimate of the estimated gross spend for this deal.\nCan be set by buyer or seller."
},
"estimatedImpressionsPerDay":{
"description":"Non-binding estimate of the impressions served per day.\nCan be set by buyer or seller.",
"format":"int64",
"type":"string"
},
"guaranteedFixedPriceTerms":{
"$ref":"GuaranteedFixedPriceTerms",
"description":"The terms for guaranteed fixed price deals."
},
"nonGuaranteedAuctionTerms":{
"$ref":"NonGuaranteedAuctionTerms",
"description":"The terms for non-guaranteed auction deals."
},
"nonGuaranteedFixedPriceTerms":{
"$ref":"NonGuaranteedFixedPriceTerms",
"description":"The terms for non-guaranteed fixed price deals."
},
"sellerTimeZone":{
"description":"The time zone name. For deals with Cost Per Day billing, defines the\ntime zone used to mark the boundaries of a day. It should be an\nIANA TZ name, such as \"America/Los_Angeles\". For more information,\nsee https://en.wikipedia.org/wiki/List_of_tz_database_time_zones.",
"type":"string"
}
},
"type":"object"
},
"DeliveryControl":{
"description":"Message contains details about how the deals will be paced.",
"id":"DeliveryControl",
"properties":{
"creativeBlockingLevel":{
"description":"Specified the creative blocking levels to be applied.\n@OutputOnly",
"description":"A generic empty message that you can re-use to avoid defining duplicated\nempty messages in your APIs. A typical example is to use it as the request\nor the response type of an API method. For instance:\n\n service Foo {\n rpc Bar(google.protobuf.Empty) returns (google.protobuf.Empty);\n }\n\nThe JSON representation for `Empty` is empty JSON object `{}`.",
"description":"A set of filters that is applied to a request for data.\nWithin a filter set, an AND operation is performed across the filters\nrepresented by each field. An OR operation is performed across the filters\nrepresented by the multiple values of a repeated field, e.g.,\n\"format=VIDEO AND deal_id=12 AND (seller_network_id=34 OR\nseller_network_id=56)\".",
"description":"The set of dimensions along which to break down the response; may be empty.\nIf multiple dimensions are requested, the breakdown is along the Cartesian\nproduct of the requested dimensions.",
"enumDescriptions":[
"A placeholder for an unspecified dimension; should not be used.",
"The response should be broken down by publisher identifier.\nThis option is available only for Open Bidding buyers."
"description":"The ID of the creative on which to filter; optional. This field may be set\nonly for a filter set that accesses account-level troubleshooting data,\ni.e., one whose name matches the `bidders/*/accounts/*/filterSets/*`\npattern.",
"description":"The ID of the deal on which to filter; optional. This field may be set\nonly for a filter set that accesses account-level troubleshooting data,\ni.e., one whose name matches the `bidders/*/accounts/*/filterSets/*`\npattern.",
"description":"The list of formats on which to filter; may be empty. The filters\nrepresented by multiple formats are ORed together (i.e., if non-empty,\nresults must match any one of the formats).",
"description":"A user-defined name of the filter set. Filter set names must be unique\nglobally and match one of the patterns:\n\n- `bidders/*/filterSets/*` (for accessing bidder-level troubleshooting\ndata)\n- `bidders/*/accounts/*/filterSets/*` (for accessing account-level\ntroubleshooting data)\n\nThis field is required in create operations.",
"description":"The list of platforms on which to filter; may be empty. The filters\nrepresented by multiple platforms are ORed together (i.e., if non-empty,\nresults must match any one of the platforms).",
"description":"For Open Bidding partners only.\nThe list of publisher identifiers on which to filter; may be empty.\nThe filters represented by multiple publisher identifiers are ORed\ntogether.",
"description":"For Authorized Buyers only.\nThe list of IDs of the seller (publisher) networks on which to filter;\nmay be empty. The filters represented by multiple seller network IDs are\nORed together (i.e., if non-empty, results must match any one of the\npublisher networks). See\n[seller-network-ids](https://developers.google.com/authorized-buyers/rtb/downloads/seller-network-ids)\nfile for the set of existing seller network IDs.",
"description":"The values of all dimensions associated with metric values in this row."
}
},
"type":"object"
},
"FilteredBidDetailRow":{
"description":"The number of filtered bids with the specified dimension values, among those\nfiltered due to the requested filtering reason (i.e. creative status), that\nhave the specified detail.",
"id":"FilteredBidDetailRow",
"properties":{
"bidCount":{
"$ref":"MetricValue",
"description":"The number of bids with the specified detail."
},
"detailId":{
"description":"The ID of the detail. The associated value can be looked up in the\ndictionary file corresponding to the DetailType in the response message.",
"format":"int32",
"type":"integer"
},
"rowDimensions":{
"$ref":"RowDimensions",
"description":"The values of all dimensions associated with metric values in this row."
}
},
"type":"object"
},
"FilteringStats":{
"description":"@OutputOnly Filtering reasons for this creative during a period of a single\nday (from midnight to midnight Pacific).",
"id":"FilteringStats",
"properties":{
"date":{
"$ref":"Date",
"description":"The day during which the data was collected.\nThe data is collected from 00:00:00 to 23:59:59 PT.\nDuring switches from PST to PDT and back, the day may\ncontain 23 or 25 hours of data instead of the usual 24."
},
"reasons":{
"description":"The set of filtering reasons for this date.",
"description":"Represents a list of targeted and excluded mobile application IDs that\npublishers own.\nMobile application IDs are from App Store and Google Play Store.\nAndroid App ID, for example, com.google.android.apps.maps, can be found in\nGoogle Play Store URL.\niOS App ID (which is a number) can be found at the end of iTunes store URL.\nFirst party mobile applications is either included or excluded.",
"id":"FirstPartyMobileApplicationTargeting",
"properties":{
"excludedAppIds":{
"description":"A list of application IDs to be excluded.",
"description":"The amount of time, in the units specified by time_unit_type. Defines the\namount of time over which impressions per user are counted and capped.",
"description":"The set of metrics that are measured in numbers of impressions, representing\nhow many impressions with the specified dimension values were considered\neligible at each stage of the bidding funnel.",
"id":"ImpressionMetricsRow",
"properties":{
"availableImpressions":{
"$ref":"MetricValue",
"description":"The number of impressions available to the buyer on Ad Exchange.\nIn some cases this value may be unavailable."
},
"bidRequests":{
"$ref":"MetricValue",
"description":"The number of impressions for which Ad Exchange sent the buyer a bid\nrequest."
},
"inventoryMatches":{
"$ref":"MetricValue",
"description":"The number of impressions that match the buyer's inventory pretargeting."
},
"responsesWithBids":{
"$ref":"MetricValue",
"description":"The number of impressions for which Ad Exchange received a response from\nthe buyer that contained at least one applicable bid."
},
"rowDimensions":{
"$ref":"RowDimensions",
"description":"The values of all dimensions associated with metric values in this row."
},
"successfulResponses":{
"$ref":"MetricValue",
"description":"The number of impressions for which the buyer successfully sent a response\nto Ad Exchange."
}
},
"type":"object"
},
"InventorySizeTargeting":{
"description":"Represents the size of an ad unit that can be targeted on an ad\nrequest. It only applies to Private Auction, AdX Preferred Deals and\nAuction Packages. This targeting does not apply to Programmatic Guaranteed\nand Preferred Deals in Ad Manager.",
"id":"InventorySizeTargeting",
"properties":{
"excludedInventorySizes":{
"description":"A list of inventory sizes to be excluded.",
"items":{
"$ref":"AdSize"
},
"type":"array"
},
"targetedInventorySizes":{
"description":"A list of inventory sizes to be included.",
"items":{
"$ref":"AdSize"
},
"type":"array"
}
},
"type":"object"
},
"ListBidMetricsResponse":{
"description":"Response message for listing the metrics that are measured in number of bids.",
"id":"ListBidMetricsResponse",
"properties":{
"bidMetricsRows":{
"description":"List of rows, each containing a set of bid metrics.",
"description":"A token to retrieve the next page of results.\nPass this value in the\nListBidMetricsRequest.pageToken\nfield in the subsequent call to the bidMetrics.list\nmethod to retrieve the next page of results.",
"description":"A token to retrieve the next page of results.\nPass this value in the\nListBidResponseErrorsRequest.pageToken\nfield in the subsequent call to the bidResponseErrors.list\nmethod to retrieve the next page of results.",
"description":"A token to retrieve the next page of results.\nPass this value in the\nListBidResponsesWithoutBidsRequest.pageToken\nfield in the subsequent call to the bidResponsesWithoutBids.list\nmethod to retrieve the next page of results.",
"type":"string"
}
},
"type":"object"
},
"ListClientUserInvitationsResponse":{
"id":"ListClientUserInvitationsResponse",
"properties":{
"invitations":{
"description":"The returned list of client users.",
"items":{
"$ref":"ClientUserInvitation"
},
"type":"array"
},
"nextPageToken":{
"description":"A token to retrieve the next page of results.\nPass this value in the\nListClientUserInvitationsRequest.pageToken\nfield in the subsequent call to the\nclients.invitations.list\nmethod to retrieve the next\npage of results.",
"description":"A token to retrieve the next page of results.\nPass this value in the\nListClientUsersRequest.pageToken\nfield in the subsequent call to the\nclients.invitations.list\nmethod to retrieve the next\npage of results.",
"type":"string"
},
"users":{
"description":"The returned list of client users.",
"description":"A token to retrieve the next page of results.\nPass this value in the\nListClientsRequest.pageToken\nfield in the subsequent call to the\naccounts.clients.list\nmethod to retrieve the next page of results.",
"description":"A token to retrieve the next page of results.\nPass this value in the\nListCreativeStatusBreakdownByCreativeRequest.pageToken\nfield in the subsequent call to the filteredBids.creatives.list\nmethod to retrieve the next page of results.",
"A placeholder for an undefined status.\nThis value will never be returned in responses.",
"Indicates that the detail ID refers to a creative attribute; see\n[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\n[vendors](https://developers.google.com/authorized-buyers/rtb/downloads/vendors).",
"Indicates that the detail ID refers to a sensitive category; see\n[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\n[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\nDisapprovalReason enum in [snippet-status-report-proto](https://developers.google.com/authorized-buyers/rtb/downloads/snippet-status-report-proto)."
"description":"List of rows, with counts of bids with a given creative status aggregated\nby detail.",
"items":{
"$ref":"FilteredBidDetailRow"
},
"type":"array"
},
"nextPageToken":{
"description":"A token to retrieve the next page of results.\nPass this value in the\nListCreativeStatusBreakdownByDetailRequest.pageToken\nfield in the subsequent call to the filteredBids.details.list\nmethod to retrieve the next page of results.",
"type":"string"
}
},
"type":"object"
},
"ListCreativesResponse":{
"description":"A response for listing creatives.",
"id":"ListCreativesResponse",
"properties":{
"creatives":{
"description":"The list of creatives.",
"items":{
"$ref":"Creative"
},
"type":"array"
},
"nextPageToken":{
"description":"A token to retrieve the next page of results.\nPass this value in the\nListCreativesRequest.page_token\nfield in the subsequent call to `ListCreatives` method to retrieve the next\npage of results.",
"type":"string"
}
},
"type":"object"
},
"ListDealAssociationsResponse":{
"description":"A response for listing creative and deal associations",
"id":"ListDealAssociationsResponse",
"properties":{
"associations":{
"description":"The list of associations.",
"items":{
"$ref":"CreativeDealAssociation"
},
"type":"array"
},
"nextPageToken":{
"description":"A token to retrieve the next page of results.\nPass this value in the\nListDealAssociationsRequest.page_token\nfield in the subsequent call to 'ListDealAssociation' method to retrieve\nthe next page of results.",
"type":"string"
}
},
"type":"object"
},
"ListFilterSetsResponse":{
"description":"Response message for listing filter sets.",
"id":"ListFilterSetsResponse",
"properties":{
"filterSets":{
"description":"The filter sets belonging to the buyer.",
"items":{
"$ref":"FilterSet"
},
"type":"array"
},
"nextPageToken":{
"description":"A token to retrieve the next page of results.\nPass this value in the\nListFilterSetsRequest.pageToken\nfield in the subsequent call to the\naccounts.filterSets.list\nmethod to retrieve the next page of results.",
"type":"string"
}
},
"type":"object"
},
"ListFilteredBidRequestsResponse":{
"description":"Response message for listing all reasons that bid requests were filtered and\nnot sent to the buyer.",
"id":"ListFilteredBidRequestsResponse",
"properties":{
"calloutStatusRows":{
"description":"List of rows, with counts of filtered bid requests aggregated by callout\nstatus.",
"items":{
"$ref":"CalloutStatusRow"
},
"type":"array"
},
"nextPageToken":{
"description":"A token to retrieve the next page of results.\nPass this value in the\nListFilteredBidRequestsRequest.pageToken\nfield in the subsequent call to the filteredBidRequests.list\nmethod to retrieve the next page of results.",
"type":"string"
}
},
"type":"object"
},
"ListFilteredBidsResponse":{
"description":"Response message for listing all reasons that bids were filtered from the\nauction.",
"id":"ListFilteredBidsResponse",
"properties":{
"creativeStatusRows":{
"description":"List of rows, with counts of filtered bids aggregated by filtering reason\n(i.e. creative status).",
"items":{
"$ref":"CreativeStatusRow"
},
"type":"array"
},
"nextPageToken":{
"description":"A token to retrieve the next page of results.\nPass this value in the\nListFilteredBidsRequest.pageToken\nfield in the subsequent call to the filteredBids.list\nmethod to retrieve the next page of results.",
"type":"string"
}
},
"type":"object"
},
"ListImpressionMetricsResponse":{
"description":"Response message for listing the metrics that are measured in number of\nimpressions.",
"id":"ListImpressionMetricsResponse",
"properties":{
"impressionMetricsRows":{
"description":"List of rows, each containing a set of impression metrics.",
"items":{
"$ref":"ImpressionMetricsRow"
},
"type":"array"
},
"nextPageToken":{
"description":"A token to retrieve the next page of results.\nPass this value in the\nListImpressionMetricsRequest.pageToken\nfield in the subsequent call to the impressionMetrics.list\nmethod to retrieve the next page of results.",
"type":"string"
}
},
"type":"object"
},
"ListLosingBidsResponse":{
"description":"Response message for listing all reasons that bids lost in the auction.",
"id":"ListLosingBidsResponse",
"properties":{
"creativeStatusRows":{
"description":"List of rows, with counts of losing bids aggregated by loss reason (i.e.\ncreative status).",
"items":{
"$ref":"CreativeStatusRow"
},
"type":"array"
},
"nextPageToken":{
"description":"A token to retrieve the next page of results.\nPass this value in the\nListLosingBidsRequest.pageToken\nfield in the subsequent call to the losingBids.list\nmethod to retrieve the next page of results.",
"type":"string"
}
},
"type":"object"
},
"ListNonBillableWinningBidsResponse":{
"description":"Response message for listing all reasons for which a buyer was not billed for\na winning bid.",
"id":"ListNonBillableWinningBidsResponse",
"properties":{
"nextPageToken":{
"description":"A token to retrieve the next page of results.\nPass this value in the\nListNonBillableWinningBidsRequest.pageToken\nfield in the subsequent call to the nonBillableWinningBids.list\nmethod to retrieve the next page of results.",
"type":"string"
},
"nonBillableWinningBidStatusRows":{
"description":"List of rows, with counts of bids not billed aggregated by reason.",
"items":{
"$ref":"NonBillableWinningBidStatusRow"
},
"type":"array"
}
},
"type":"object"
},
"ListProductsResponse":{
"description":"Response message for listing products visible to the buyer.",
"id":"ListProductsResponse",
"properties":{
"nextPageToken":{
"description":"List pagination support.",
"type":"string"
},
"products":{
"description":"The list of matching products at their head revision number.",
"description":"@OutputOnly The Geo criteria the restriction applies to.",
"id":"LocationContext",
"properties":{
"geoCriteriaIds":{
"description":"IDs representing the geo location for this context.\nPlease refer to the\n[geo-table.csv](https://storage.googleapis.com/adx-rtb-dictionaries/geo-table.csv)\nfile for different geo criteria IDs.",
"description":"Targeting represents different criteria that can be used by advertisers to\ntarget ad inventory. For example, they can choose to target ad requests only\nif the user is in the US.\nMultiple types of targeting are always applied as a logical AND, unless noted\notherwise.",
"description":"The variance (i.e. square of the standard deviation) of the metric value.\nIf value is exact, variance is 0.\nCan be used to calculate margin of error as a percentage of value, using\nthe following formula, where Z is the standard constant that depends on the\ndesired size of the confidence interval (e.g. for 90% confidence interval,\nuse Z = 1.645):\n\n marginOfError = 100 * Z * sqrt(variance) / value",
"description":"Number of nano (10^-9) units of the amount.\nThe value must be between -999,999,999 and +999,999,999 inclusive.\nIf `units` is positive, `nanos` must be positive or zero.\nIf `units` is zero, `nanos` can be positive, zero, or negative.\nIf `units` is negative, `nanos` must be negative or zero.\nFor example $-1.75 is represented as `units`=-1 and `nanos`=-750,000,000.",
"description":"The number of winning bids with the specified dimension values for which the\nbuyer was not billed, as described by the specified status.",
"description":"Terms for Private Auctions. Note that Private Auctions can be created only\nby the seller, but they can be returned in a get or list request.",
"description":"Terms for Preferred Deals. Note that Preferred Deals cannot be created via\nthe API at this time, but can be returned in a get or list request.",
"description":"The role of the person (buyer/seller) creating the note.\n@OutputOnly",
"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."
],
"type":"string"
},
"note":{
"description":"The actual note to attach.\n(max-length: 1024 unicode code units)\n\nNote: This field may be set only when creating the resource. Modifying\nthis field while updating the resource will result in an error.",
"type":"string"
},
"noteId":{
"description":"The unique ID for the note.\n@OutputOnly",
"type":"string"
},
"proposalRevision":{
"description":"The revision number of the proposal when the note is created.\n@OutputOnly",
"description":"The reason why the proposal is being paused.\nThis human readable message will be displayed in the seller's UI.\n(Max length: 1000 unicode code units.)",
"description":"Represents targeting about where the ads can appear, e.g., certain sites or\nmobile applications.\nDifferent placement targeting types will be logically OR'ed.",
"description":"Used to specify pricing rules for buyers/advertisers. Each PricePerBuyer in\na product can become 0 or 1 deals. To check if there is a PricePerBuyer for\na particular buyer or buyer/advertiser pair, we look for the most specific\nmatching rule - we first look for a rule matching the buyer and advertiser,\nnext a rule with the buyer but an empty advertiser list, and otherwise look\nfor a matching rule where no buyer is set.",
"description":"The buyer who will pay this price. If unset, all buyers can pay this price\n(if the\nadvertisers match, and there's no more specific rule matching the buyer)."
"description":"Note: this resource requires whitelisting for access. Please contact your\naccount manager for access to Marketplace resources.\n\nA product is a segment of inventory that a seller wishes to sell. It is\nassociated with certain terms and targeting information which helps the buyer\nknow more about the inventory.",
"description":"The proposed end time for the deal. The field will be truncated to the order of\nseconds during serving.",
"format":"google-datetime",
"type":"string"
},
"availableStartTime":{
"description":"Inventory availability dates. The start time will be truncated to seconds during serving.\nThus, a field specified as 3:23:34.456 (HH:mm:ss.SSS) will be truncated to 3:23:34\nwhen serving.",
"format":"google-datetime",
"type":"string"
},
"createTime":{
"description":"Creation time.",
"format":"google-datetime",
"type":"string"
},
"creatorContacts":{
"description":"Optional contact information for the creator of this product.",
"description":"If the creator has already signed off on the product, then the buyer can\nfinalize the deal by accepting the product as is. When copying to a\nproposal, if any of the terms are changed, then auto_finalize is\nautomatically set to false.",
"type":"boolean"
},
"productId":{
"description":"The unique ID for the product.",
"type":"string"
},
"productRevision":{
"description":"The revision number of the product (auto-assigned by Marketplace).",
"format":"int64",
"type":"string"
},
"publisherProfileId":{
"description":"An ID which can be used by the Publisher Profile API to get more\ninformation about the seller that created this product.",
"type":"string"
},
"seller":{
"$ref":"Seller",
"description":"Information about the seller that created this product."
},
"syndicationProduct":{
"description":"The syndication product associated with the deal.",
"enum":[
"SYNDICATION_PRODUCT_UNSPECIFIED",
"CONTENT",
"MOBILE",
"VIDEO",
"GAMES"
],
"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."
],
"type":"string"
},
"targetingCriterion":{
"description":"Targeting that is shared between the buyer and the seller. Each targeting\ncriterion has a specified key and for each key there is a list of inclusion\nvalue or exclusion values.",
"description":"Note: this resource requires whitelisting for access. Please contact your\naccount manager for access to Marketplace resources.\n\nRepresents a proposal in the Marketplace. A proposal is the unit of\nnegotiation between a seller and a buyer and contains deals which\nare served.\n\nNote: you can not update, create, or otherwise modify Private\nAuction or Preferred Deals deals through the API.\n\nFields are updatable unless noted otherwise.",
"description":"Reference to the buyer that will get billed for this proposal.\n@OutputOnly"
},
"buyer":{
"$ref":"Buyer",
"description":"Reference to the buyer on the proposal.\n\nNote: This field may be set only when creating the resource. Modifying\nthis field while updating the resource will result in an error."
},
"buyerContacts":{
"description":"Contact information for the buyer.",
"description":"Private data for buyer. (hidden from seller)."
},
"deals":{
"description":"The deals associated with this proposal. For Private Auction proposals (whose deals have\nNonGuaranteedAuctionTerms), there will only be one deal.",
"description":"Indicates whether the buyer/seller created the proposal.\n@OutputOnly",
"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."
],
"type":"string"
},
"privateAuctionId":{
"description":"Private auction ID if this proposal is a private auction proposal.\n@OutputOnly",
"type":"string"
},
"proposalId":{
"description":"The unique ID of the proposal.\n@OutputOnly",
"type":"string"
},
"proposalRevision":{
"description":"The revision number for the proposal.\nEach update to the proposal or the deal causes the proposal revision number\nto auto-increment. The buyer keeps track of the last revision number they\nknow of and pass it in when making an update. If the head revision number\non the server has since incremented, then an ABORTED error is returned\nduring the update operation to let the buyer know that a subsequent update\nwas made.\n@OutputOnly",
"format":"int64",
"type":"string"
},
"proposalState":{
"description":"The current state of the proposal.\n@OutputOnly",
"enum":[
"PROPOSAL_STATE_UNSPECIFIED",
"PROPOSED",
"BUYER_ACCEPTED",
"SELLER_ACCEPTED",
"CANCELED",
"FINALIZED"
],
"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\nfinalized.",
"The proposal is finalized. During renegotiation, the proposal may\nnot be in this state."
],
"type":"string"
},
"seller":{
"$ref":"Seller",
"description":"Reference to the seller on the proposal.\n\nNote: This field may be set only when creating the resource. Modifying\nthis field while updating the resource will result in an error."
},
"sellerContacts":{
"description":"Contact information for the seller.\n@OutputOnly",
"description":"Note: this resource requires whitelisting for access. Please contact your\naccount manager for access to Marketplace resources.\n\nRepresents a publisher profile in Marketplace.\n\nAll fields are read only. All string fields are free-form text entered by the publisher\nunless noted otherwise.",
"description":"Contact information for direct reservation deals. This is free text entered by the publisher\nand may include information like names, phone numbers and email addresses.",
"description":"The list of domains represented in this publisher profile. Empty if this is a parent profile.\nThese are top private domains, meaning that these will not contain a string like\n\"photos.google.co.uk/123\", but will instead contain \"google.co.uk\".",
"description":"Contact information for programmatic deals. This is free text entered by the publisher\nand may include information like names, phone numbers and email addresses.",
"description":"An open-ended realtime time range specified by the start timestamp.\nFor filter sets that specify a realtime time range RTB metrics continue to\nbe aggregated throughout the lifetime of the filter set.",
"id":"RealtimeTimeRange",
"properties":{
"startTimestamp":{
"description":"The start timestamp of the real-time RTB metrics aggregation.",
"format":"google-datetime",
"type":"string"
}
},
"type":"object"
},
"Reason":{
"description":"A specific filtering status and how many times it occurred.",
"id":"Reason",
"properties":{
"count":{
"description":"The number of times the creative was filtered for the status. The\ncount is aggregated across all publishers on the exchange.",
"format":"int64",
"type":"string"
},
"status":{
"description":"The filtering status code. Please refer to the\n[creative-status-codes.txt](https://storage.googleapis.com/adx-rtb-dictionaries/creative-status-codes.txt)\nfile for different statuses.",
"description":"A relative date range, specified by an offset and a duration.\nThe supported range of dates begins 30 days before today and ends today,\ni.e., the limits for these values are:\noffset_days \u003e= 0\nduration_days \u003e= 1\noffset_days + duration_days \u003c= 30",
"description":"A response may include multiple rows, breaking down along various dimensions.\nEncapsulates the values of all dimensions for a given row.",
"description":"The publisher identifier for this row, if a breakdown by\n[BreakdownDimension.PUBLISHER_IDENTIFIER](https://developers.google.com/authorized-buyers/apis/reference/rest/v2beta1/bidders.accounts.filterSets#FilterSet.BreakdownDimension)\nwas requested.",
"description":"The serving context for this restriction.",
"id":"ServingContext",
"properties":{
"all":{
"description":"Matches all contexts.",
"enum":[
"SIMPLE_CONTEXT"
],
"enumDescriptions":[
"A simple context."
],
"type":"string"
},
"appType":{
"$ref":"AppContext",
"description":"Matches impressions for a particular app type."
},
"auctionType":{
"$ref":"AuctionContext",
"description":"Matches impressions for a particular auction type."
},
"location":{
"$ref":"LocationContext",
"description":"Matches impressions coming from users *or* publishers in a specific\nlocation."
},
"platform":{
"$ref":"PlatformContext",
"description":"Matches impressions coming from a particular platform."
},
"securityType":{
"$ref":"SecurityContext",
"description":"Matches impressions for a particular security type."
}
},
"type":"object"
},
"ServingRestriction":{
"description":"@OutputOnly A representation of the status of an ad in a\nspecific context. A context here relates to where something ultimately serves\n(for example, a user or publisher geo, a platform, an HTTPS vs HTTP request,\nor the type of auction).",
"id":"ServingRestriction",
"properties":{
"contexts":{
"description":"The contexts for the restriction.",
"description":"Disapproval bound to this restriction.\nOnly present if status=DISAPPROVED.\nCan be used to filter the response of the\ncreatives.list\nmethod."
"description":"Any disapprovals bound to this restriction.\nOnly present if status=DISAPPROVED.\nCan be used to filter the response of the\ncreatives.list\nmethod.\nDeprecated; please use\ndisapproval\nfield instead.",
"description":"Advertisers can target different attributes of an ad slot. For example,\nthey can choose to show ads only if the user is in the U.S. Such\ntargeting criteria can be specified as part of Shared Targeting.",
"id":"TargetingCriteria",
"properties":{
"exclusions":{
"description":"The list of values to exclude from targeting. Each value is AND'd\ntogether.",
"items":{
"$ref":"TargetingValue"
},
"type":"array"
},
"inclusions":{
"description":"The list of value to include as part of the targeting. Each value is OR'd\ntogether.",
"items":{
"$ref":"TargetingValue"
},
"type":"array"
},
"key":{
"description":"The key representing the shared targeting criterion.\nTargeting criteria defined by Google ad servers will begin with GOOG_.\nThird parties may define their own keys.\nA list of permissible keys along with the acceptable values will be\nprovided as part of the external documentation.",
"type":"string"
}
},
"type":"object"
},
"TargetingValue":{
"description":"A polymorphic targeting value used as part of Shared Targeting.",
"id":"TargetingValue",
"properties":{
"creativeSizeValue":{
"$ref":"CreativeSize",
"description":"The creative size value to include/exclude.\nFilled in when key = GOOG_CREATIVE_SIZE"
},
"dayPartTargetingValue":{
"$ref":"DayPartTargeting",
"description":"The daypart targeting to include / exclude.\nFilled in when the key is GOOG_DAYPART_TARGETING.\nThe definition of this targeting is derived from the structure\nused by Ad Manager."
},
"longValue":{
"description":"The long value to include/exclude.",
"format":"int64",
"type":"string"
},
"stringValue":{
"description":"The string value to include/exclude.",
"type":"string"
}
},
"type":"object"
},
"TechnologyTargeting":{
"description":"Represents targeting about various types of technology.",
"id":"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":{
"$ref":"OperatingSystemTargeting",
"description":"Operating system related targeting information."
"description":"Represents a time of day. The date and time zone are either not significant\nor are specified elsewhere. An API may choose to allow leap seconds. Related\ntypes are google.type.Date and `google.protobuf.Timestamp`.",
"id":"TimeOfDay",
"properties":{
"hours":{
"description":"Hours of day in 24 hour format. Should be from 0 to 23. An API may choose\nto allow the value \"24:00:00\" for scenarios like business closing time.",
"format":"int32",
"type":"integer"
},
"minutes":{
"description":"Minutes of hour of day. Must be from 0 to 59.",
"format":"int32",
"type":"integer"
},
"nanos":{
"description":"Fractions of seconds in nanoseconds. Must be from 0 to 999,999,999.",
"format":"int32",
"type":"integer"
},
"seconds":{
"description":"Seconds of minutes of the time. Must normally be from 0 to 59. An API may\nallow the value 60 if it allows leap-seconds.",
"format":"int32",
"type":"integer"
}
},
"type":"object"
},
"UrlTargeting":{
"description":"Represents a list of targeted and excluded URLs (e.g., google.com).\nFor Private Auction and AdX Preferred Deals, URLs are either included or\nexcluded.\nFor Programmatic Guaranteed and Preferred Deals, this doesn't\napply.",
"description":"Represents targeting information about video.",
"id":"VideoTargeting",
"properties":{
"excludedPositionTypes":{
"description":"A list of video positions to be excluded.\nPosition types can either be included or excluded (XOR).",
"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."
],
"items":{
"enum":[
"POSITION_TYPE_UNSPECIFIED",
"PREROLL",
"MIDROLL",
"POSTROLL"
],
"type":"string"
},
"type":"array"
},
"targetedPositionTypes":{
"description":"A list of video positions to be included.\nWhen the included list is present, the excluded list must be empty.\nWhen the excluded list is present, the included list must be empty.",
"description":"A request for watching changes to creative Status.",
"id":"WatchCreativeRequest",
"properties":{
"topic":{
"description":"The Pub/Sub topic to publish notifications to.\nThis topic must already exist and must give permission to\nad-exchange-buyside-reports@google.com to write to the topic.\nThis should be the full resource name in\n\"projects/{project_id}/topics/{topic_id}\" format.",
