blob: 6ebfeea14d9a43f8a90b21937966362940e1d80a [file] [log] [blame]
{
"auth": {
"oauth2": {
"scopes": {
"https://www.googleapis.com/auth/adexchange.buyer": {
"description": "Manage your Ad Exchange buyer account configuration"
}
}
}
},
"basePath": "",
"baseUrl": "https://adexchangebuyer.googleapis.com/",
"batchPath": "batch",
"canonicalName": "AdExchangeBuyerII",
"description": "Accesses the latest features for managing Authorized Buyers accounts, Real-Time Bidding configurations and auction metrics, and Marketplace programmatic deals.",
"discoveryVersion": "v1",
"documentationLink": "https://developers.google.com/authorized-buyers/apis/reference/rest/",
"icons": {
"x16": "http://www.google.com/images/icons/product/search-16.gif",
"x32": "http://www.google.com/images/icons/product/search-32.gif"
},
"id": "adexchangebuyer2:v2beta1",
"kind": "discovery#restDescription",
"mtlsRootUrl": "https://adexchangebuyer.mtls.googleapis.com/",
"name": "adexchangebuyer2",
"ownerDomain": "google.com",
"ownerName": "Google",
"parameters": {
"$.xgafv": {
"description": "V1 error format.",
"enum": [
"1",
"2"
],
"enumDescriptions": [
"v1 error format",
"v2 error format"
],
"location": "query",
"type": "string"
},
"access_token": {
"description": "OAuth access token.",
"location": "query",
"type": "string"
},
"alt": {
"default": "json",
"description": "Data format for response.",
"enum": [
"json",
"media",
"proto"
],
"enumDescriptions": [
"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\").",
"location": "query",
"type": "string"
}
},
"protocol": "rest",
"resources": {
"accounts": {
"resources": {
"clients": {
"methods": {
"create": {
"description": "Creates a new client buyer.",
"flatPath": "v2beta1/accounts/{accountId}/clients",
"httpMethod": "POST",
"id": "adexchangebuyer2.accounts.clients.create",
"parameterOrder": [
"accountId"
],
"parameters": {
"accountId": {
"description": "Unique numerical account ID for the buyer of which the client buyer is a customer; the sponsor buyer to create a client for. (required)",
"format": "int64",
"location": "path",
"required": true,
"type": "string"
}
},
"path": "v2beta1/accounts/{accountId}/clients",
"request": {
"$ref": "Client"
},
"response": {
"$ref": "Client"
},
"scopes": [
"https://www.googleapis.com/auth/adexchange.buyer"
]
},
"get": {
"description": "Gets a client buyer with a given client account ID.",
"flatPath": "v2beta1/accounts/{accountId}/clients/{clientAccountId}",
"httpMethod": "GET",
"id": "adexchangebuyer2.accounts.clients.get",
"parameterOrder": [
"accountId",
"clientAccountId"
],
"parameters": {
"accountId": {
"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 retrieve. (required)",
"format": "int64",
"location": "path",
"required": true,
"type": "string"
}
},
"path": "v2beta1/accounts/{accountId}/clients/{clientAccountId}",
"response": {
"$ref": "Client"
},
"scopes": [
"https://www.googleapis.com/auth/adexchange.buyer"
]
},
"list": {
"description": "Lists all the clients for the current sponsor buyer.",
"flatPath": "v2beta1/accounts/{accountId}/clients",
"httpMethod": "GET",
"id": "adexchangebuyer2.accounts.clients.list",
"parameterOrder": [
"accountId"
],
"parameters": {
"accountId": {
"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. If 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. Typically, this is the value of ListClientsResponse.nextPageToken returned from the previous call to the accounts.clients.list method.",
"location": "query",
"type": "string"
},
"partnerClientId": {
"description": "Optional unique identifier (from the standpoint of an Ad Exchange sponsor buyer partner) of the client to return. If specified, at most one client will be returned in the response.",
"location": "query",
"type": "string"
}
},
"path": "v2beta1/accounts/{accountId}/clients",
"response": {
"$ref": "ListClientsResponse"
},
"scopes": [
"https://www.googleapis.com/auth/adexchange.buyer"
]
},
"update": {
"description": "Updates an existing client buyer.",
"flatPath": "v2beta1/accounts/{accountId}/clients/{clientAccountId}",
"httpMethod": "PUT",
"id": "adexchangebuyer2.accounts.clients.update",
"parameterOrder": [
"accountId",
"clientAccountId"
],
"parameters": {
"accountId": {
"description": "Unique numerical account ID for the buyer of which the client buyer is a customer; the sponsor buyer to update a client for. (required)",
"format": "int64",
"location": "path",
"required": true,
"type": "string"
},
"clientAccountId": {
"description": "Unique numerical account ID of the client to update. (required)",
"format": "int64",
"location": "path",
"required": true,
"type": "string"
}
},
"path": "v2beta1/accounts/{accountId}/clients/{clientAccountId}",
"request": {
"$ref": "Client"
},
"response": {
"$ref": "Client"
},
"scopes": [
"https://www.googleapis.com/auth/adexchange.buyer"
]
}
},
"resources": {
"invitations": {
"methods": {
"create": {
"description": "Creates and sends out an email invitation to access an Ad Exchange client buyer account.",
"flatPath": "v2beta1/accounts/{accountId}/clients/{clientAccountId}/invitations",
"httpMethod": "POST",
"id": "adexchangebuyer2.accounts.clients.invitations.create",
"parameterOrder": [
"accountId",
"clientAccountId"
],
"parameters": {
"accountId": {
"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 that the user should be associated with. (required)",
"format": "int64",
"location": "path",
"required": true,
"type": "string"
}
},
"path": "v2beta1/accounts/{accountId}/clients/{clientAccountId}/invitations",
"request": {
"$ref": "ClientUserInvitation"
},
"response": {
"$ref": "ClientUserInvitation"
},
"scopes": [
"https://www.googleapis.com/auth/adexchange.buyer"
]
},
"get": {
"description": "Retrieves an existing client user invitation.",
"flatPath": "v2beta1/accounts/{accountId}/clients/{clientAccountId}/invitations/{invitationId}",
"httpMethod": "GET",
"id": "adexchangebuyer2.accounts.clients.invitations.get",
"parameterOrder": [
"accountId",
"clientAccountId",
"invitationId"
],
"parameters": {
"accountId": {
"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 that the user invitation to be retrieved is associated with. (required)",
"format": "int64",
"location": "path",
"required": true,
"type": "string"
},
"invitationId": {
"description": "Numerical identifier of the user invitation to retrieve. (required)",
"format": "int64",
"location": "path",
"required": true,
"type": "string"
}
},
"path": "v2beta1/accounts/{accountId}/clients/{clientAccountId}/invitations/{invitationId}",
"response": {
"$ref": "ClientUserInvitation"
},
"scopes": [
"https://www.googleapis.com/auth/adexchange.buyer"
]
},
"list": {
"description": "Lists all the client users invitations for a client with a given account ID.",
"flatPath": "v2beta1/accounts/{accountId}/clients/{clientAccountId}/invitations",
"httpMethod": "GET",
"id": "adexchangebuyer2.accounts.clients.invitations.list",
"parameterOrder": [
"accountId",
"clientAccountId"
],
"parameters": {
"accountId": {
"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. (required) You must either specify a string representation of a numerical account identifier or the `-` character to list all the invitations for all the clients of a given sponsor buyer.",
"location": "path",
"required": true,
"type": "string"
},
"pageSize": {
"description": "Requested page size. Server may return fewer clients than requested. If 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. Typically, this is the value of ListClientUserInvitationsResponse.nextPageToken returned from the previous call to the clients.invitations.list method.",
"location": "query",
"type": "string"
}
},
"path": "v2beta1/accounts/{accountId}/clients/{clientAccountId}/invitations",
"response": {
"$ref": "ListClientUserInvitationsResponse"
},
"scopes": [
"https://www.googleapis.com/auth/adexchange.buyer"
]
}
}
},
"users": {
"methods": {
"get": {
"description": "Retrieves an existing client user.",
"flatPath": "v2beta1/accounts/{accountId}/clients/{clientAccountId}/users/{userId}",
"httpMethod": "GET",
"id": "adexchangebuyer2.accounts.clients.users.get",
"parameterOrder": [
"accountId",
"clientAccountId",
"userId"
],
"parameters": {
"accountId": {
"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 that the user to be retrieved is associated with. (required)",
"format": "int64",
"location": "path",
"required": true,
"type": "string"
},
"userId": {
"description": "Numerical identifier of the user to retrieve. (required)",
"format": "int64",
"location": "path",
"required": true,
"type": "string"
}
},
"path": "v2beta1/accounts/{accountId}/clients/{clientAccountId}/users/{userId}",
"response": {
"$ref": "ClientUser"
},
"scopes": [
"https://www.googleapis.com/auth/adexchange.buyer"
]
},
"list": {
"description": "Lists all the known client users for a specified sponsor buyer account ID.",
"flatPath": "v2beta1/accounts/{accountId}/clients/{clientAccountId}/users",
"httpMethod": "GET",
"id": "adexchangebuyer2.accounts.clients.users.list",
"parameterOrder": [
"accountId",
"clientAccountId"
],
"parameters": {
"accountId": {
"description": "Numerical account ID of the sponsor buyer of the client to list users for. (required)",
"format": "int64",
"location": "path",
"required": true,
"type": "string"
},
"clientAccountId": {
"description": "The account ID of the client buyer to list users for. (required) You must specify either a string representation of a numerical account identifier or the `-` character to list all the client users for all the clients of a given sponsor buyer.",
"location": "path",
"required": true,
"type": "string"
},
"pageSize": {
"description": "Requested page size. The server may return fewer clients than requested. If 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. Typically, this is the value of ListClientUsersResponse.nextPageToken returned from the previous call to the accounts.clients.users.list method.",
"location": "query",
"type": "string"
}
},
"path": "v2beta1/accounts/{accountId}/clients/{clientAccountId}/users",
"response": {
"$ref": "ListClientUsersResponse"
},
"scopes": [
"https://www.googleapis.com/auth/adexchange.buyer"
]
},
"update": {
"description": "Updates an existing client user. Only the user status can be changed on update.",
"flatPath": "v2beta1/accounts/{accountId}/clients/{clientAccountId}/users/{userId}",
"httpMethod": "PUT",
"id": "adexchangebuyer2.accounts.clients.users.update",
"parameterOrder": [
"accountId",
"clientAccountId",
"userId"
],
"parameters": {
"accountId": {
"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 that the user to be retrieved is associated with. (required)",
"format": "int64",
"location": "path",
"required": true,
"type": "string"
},
"userId": {
"description": "Numerical identifier of the user to retrieve. (required)",
"format": "int64",
"location": "path",
"required": true,
"type": "string"
}
},
"path": "v2beta1/accounts/{accountId}/clients/{clientAccountId}/users/{userId}",
"request": {
"$ref": "ClientUser"
},
"response": {
"$ref": "ClientUser"
},
"scopes": [
"https://www.googleapis.com/auth/adexchange.buyer"
]
}
}
}
}
},
"creatives": {
"methods": {
"create": {
"description": "Creates a creative.",
"flatPath": "v2beta1/accounts/{accountId}/creatives",
"httpMethod": "POST",
"id": "adexchangebuyer2.accounts.creatives.create",
"parameterOrder": [
"accountId"
],
"parameters": {
"accountId": {
"description": "The account that this creative belongs to. Can be used to filter the response of the creatives.list method.",
"location": "path",
"required": true,
"type": "string"
},
"duplicateIdMode": {
"description": "Indicates if multiple creatives can share an ID or not. Default is NO_DUPLICATES (one ID per creative).",
"enum": [
"NO_DUPLICATES",
"FORCE_ENABLE_DUPLICATE_IDS"
],
"enumDescriptions": [
"Recommended. This means that an ID will be unique to a single creative. Multiple creatives will not share an ID.",
"Not recommended. Using this option will allow multiple creatives to share the same ID. Get and Update requests will not be possible for any ID that has more than one creative associated. (List will still function.) This is only intended for backwards compatibility in cases where a single ID is already shared by multiple creatives from previous APIs."
],
"location": "query",
"type": "string"
}
},
"path": "v2beta1/accounts/{accountId}/creatives",
"request": {
"$ref": "Creative"
},
"response": {
"$ref": "Creative"
},
"scopes": [
"https://www.googleapis.com/auth/adexchange.buyer"
]
},
"get": {
"description": "Gets a creative.",
"flatPath": "v2beta1/accounts/{accountId}/creatives/{creativeId}",
"httpMethod": "GET",
"id": "adexchangebuyer2.accounts.creatives.get",
"parameterOrder": [
"accountId",
"creativeId"
],
"parameters": {
"accountId": {
"description": "The account the creative belongs to.",
"location": "path",
"required": true,
"type": "string"
},
"creativeId": {
"description": "The ID of the creative to retrieve.",
"location": "path",
"required": true,
"type": "string"
}
},
"path": "v2beta1/accounts/{accountId}/creatives/{creativeId}",
"response": {
"$ref": "Creative"
},
"scopes": [
"https://www.googleapis.com/auth/adexchange.buyer"
]
},
"list": {
"description": "Lists creatives.",
"flatPath": "v2beta1/accounts/{accountId}/creatives",
"httpMethod": "GET",
"id": "adexchangebuyer2.accounts.creatives.list",
"parameterOrder": [
"accountId"
],
"parameters": {
"accountId": {
"description": "The account to list the creatives from. Specify \"-\" 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 (due to timeout constraint) even if more are available via another call. If unspecified, server will pick an appropriate default. Acceptable values are 1 to 1000, inclusive.",
"format": "int32",
"location": "query",
"type": "integer"
},
"pageToken": {
"description": "A token identifying a page of results the server should return. Typically, this is the value of ListCreativesResponse.next_page_token returned from the previous call to 'ListCreatives' method.",
"location": "query",
"type": "string"
},
"query": {
"description": "An optional query string to filter creatives. If no filter is specified, all active creatives will be returned. Supported queries are: - accountId=*account_id_string* - creativeId=*creative_id_string* - dealsStatus: {approved, conditionally_approved, disapproved, not_checked} - openAuctionStatus: {approved, conditionally_approved, disapproved, not_checked} - attribute: {a numeric attribute from the list of attributes} - disapprovalReason: {a reason from DisapprovalReason} Example: 'accountId=12345 AND (dealsStatus:disapproved AND disapprovalReason:unacceptable_content) OR attribute:47'",
"location": "query",
"type": "string"
}
},
"path": "v2beta1/accounts/{accountId}/creatives",
"response": {
"$ref": "ListCreativesResponse"
},
"scopes": [
"https://www.googleapis.com/auth/adexchange.buyer"
]
},
"stopWatching": {
"description": "Stops watching a creative. Will stop push notifications being sent to the topics when the creative changes status.",
"flatPath": "v2beta1/accounts/{accountId}/creatives/{creativeId}:stopWatching",
"httpMethod": "POST",
"id": "adexchangebuyer2.accounts.creatives.stopWatching",
"parameterOrder": [
"accountId",
"creativeId"
],
"parameters": {
"accountId": {
"description": "The account of the creative to stop notifications for.",
"location": "path",
"required": true,
"type": "string"
},
"creativeId": {
"description": "The creative ID of the creative to stop notifications for. Specify \"-\" to specify stopping account level notifications.",
"location": "path",
"required": true,
"type": "string"
}
},
"path": "v2beta1/accounts/{accountId}/creatives/{creativeId}:stopWatching",
"request": {
"$ref": "StopWatchingCreativeRequest"
},
"response": {
"$ref": "Empty"
},
"scopes": [
"https://www.googleapis.com/auth/adexchange.buyer"
]
},
"update": {
"description": "Updates a creative.",
"flatPath": "v2beta1/accounts/{accountId}/creatives/{creativeId}",
"httpMethod": "PUT",
"id": "adexchangebuyer2.accounts.creatives.update",
"parameterOrder": [
"accountId",
"creativeId"
],
"parameters": {
"accountId": {
"description": "The account that this creative belongs to. Can be used to filter the response of the creatives.list method.",
"location": "path",
"required": true,
"type": "string"
},
"creativeId": {
"description": "The buyer-defined creative ID of this creative. Can be used to filter the response of the creatives.list method.",
"location": "path",
"required": true,
"type": "string"
}
},
"path": "v2beta1/accounts/{accountId}/creatives/{creativeId}",
"request": {
"$ref": "Creative"
},
"response": {
"$ref": "Creative"
},
"scopes": [
"https://www.googleapis.com/auth/adexchange.buyer"
]
},
"watch": {
"description": "Watches a creative. Will result in push notifications being sent to the topic when the creative changes status.",
"flatPath": "v2beta1/accounts/{accountId}/creatives/{creativeId}:watch",
"httpMethod": "POST",
"id": "adexchangebuyer2.accounts.creatives.watch",
"parameterOrder": [
"accountId",
"creativeId"
],
"parameters": {
"accountId": {
"description": "The account of the creative to watch.",
"location": "path",
"required": true,
"type": "string"
},
"creativeId": {
"description": "The creative ID to watch for status changes. Specify \"-\" to watch all creatives under the above account. If both creative-level and account-level notifications are sent, only a single notification will be sent to the creative-level notification topic.",
"location": "path",
"required": true,
"type": "string"
}
},
"path": "v2beta1/accounts/{accountId}/creatives/{creativeId}:watch",
"request": {
"$ref": "WatchCreativeRequest"
},
"response": {
"$ref": "Empty"
},
"scopes": [
"https://www.googleapis.com/auth/adexchange.buyer"
]
}
},
"resources": {
"dealAssociations": {
"methods": {
"add": {
"description": "Associate an existing deal with a creative.",
"flatPath": "v2beta1/accounts/{accountId}/creatives/{creativeId}/dealAssociations:add",
"httpMethod": "POST",
"id": "adexchangebuyer2.accounts.creatives.dealAssociations.add",
"parameterOrder": [
"accountId",
"creativeId"
],
"parameters": {
"accountId": {
"description": "The account the creative belongs to.",
"location": "path",
"required": true,
"type": "string"
},
"creativeId": {
"description": "The ID of the creative associated with the deal.",
"location": "path",
"required": true,
"type": "string"
}
},
"path": "v2beta1/accounts/{accountId}/creatives/{creativeId}/dealAssociations:add",
"request": {
"$ref": "AddDealAssociationRequest"
},
"response": {
"$ref": "Empty"
},
"scopes": [
"https://www.googleapis.com/auth/adexchange.buyer"
]
},
"list": {
"description": "List all creative-deal associations.",
"flatPath": "v2beta1/accounts/{accountId}/creatives/{creativeId}/dealAssociations",
"httpMethod": "GET",
"id": "adexchangebuyer2.accounts.creatives.dealAssociations.list",
"parameterOrder": [
"accountId",
"creativeId"
],
"parameters": {
"accountId": {
"description": "The account to list the associations from. Specify \"-\" 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. Specify \"-\" 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. If 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. Typically, this is the value of ListDealAssociationsResponse.next_page_token returned 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 specified, all associations will be returned. Supported queries are: - accountId=*account_id_string* - creativeId=*creative_id_string* - dealsId=*deals_id_string* - dealsStatus:{approved, conditionally_approved, disapproved, not_checked} - openAuctionStatus:{approved, conditionally_approved, disapproved, not_checked} Example: 'dealsId=12345 AND dealsStatus:disapproved'",
"location": "query",
"type": "string"
}
},
"path": "v2beta1/accounts/{accountId}/creatives/{creativeId}/dealAssociations",
"response": {
"$ref": "ListDealAssociationsResponse"
},
"scopes": [
"https://www.googleapis.com/auth/adexchange.buyer"
]
},
"remove": {
"description": "Remove the association between a deal and a creative.",
"flatPath": "v2beta1/accounts/{accountId}/creatives/{creativeId}/dealAssociations:remove",
"httpMethod": "POST",
"id": "adexchangebuyer2.accounts.creatives.dealAssociations.remove",
"parameterOrder": [
"accountId",
"creativeId"
],
"parameters": {
"accountId": {
"description": "The account the creative belongs to.",
"location": "path",
"required": true,
"type": "string"
},
"creativeId": {
"description": "The ID of the creative associated with the deal.",
"location": "path",
"required": true,
"type": "string"
}
},
"path": "v2beta1/accounts/{accountId}/creatives/{creativeId}/dealAssociations:remove",
"request": {
"$ref": "RemoveDealAssociationRequest"
},
"response": {
"$ref": "Empty"
},
"scopes": [
"https://www.googleapis.com/auth/adexchange.buyer"
]
}
}
}
}
},
"finalizedProposals": {
"methods": {
"list": {
"description": "List finalized proposals, regardless if a proposal is being renegotiated. A filter expression (PQL query) may be specified to filter the results. The notes will not be returned.",
"flatPath": "v2beta1/accounts/{accountId}/finalizedProposals",
"httpMethod": "GET",
"id": "adexchangebuyer2.accounts.finalizedProposals.list",
"parameterOrder": [
"accountId"
],
"parameters": {
"accountId": {
"description": "Account ID of the buyer.",
"location": "path",
"required": true,
"type": "string"
},
"filter": {
"description": "An optional PQL filter query used to query for proposals. Nested repeated fields, such as proposal.deals.targetingCriterion, cannot be filtered.",
"location": "query",
"type": "string"
},
"filterSyntax": {
"description": "Syntax the filter is written in. Current implementation defaults to PQL but in the future it will be LIST_FILTER.",
"enum": [
"FILTER_SYNTAX_UNSPECIFIED",
"PQL",
"LIST_FILTER"
],
"enumDescriptions": [
"A placeholder for an undefined filter syntax.",
"PQL query syntax. Visit https://developers.google.com/ad-manager/api/pqlreference for PQL documentation and examples.",
"API list filtering syntax. Read about syntax and usage at https://developers.google.com/authorized-buyers/apis/guides/v2/list-filters."
],
"location": "query",
"type": "string"
},
"pageSize": {
"description": "Requested page size. The server may return fewer results than requested. If unspecified, the server will pick an appropriate default.",
"format": "int32",
"location": "query",
"type": "integer"
},
"pageToken": {
"description": "The page token as returned from ListProposalsResponse.",
"location": "query",
"type": "string"
}
},
"path": "v2beta1/accounts/{accountId}/finalizedProposals",
"response": {
"$ref": "ListProposalsResponse"
},
"scopes": [
"https://www.googleapis.com/auth/adexchange.buyer"
]
}
}
},
"products": {
"methods": {
"get": {
"description": "Gets the requested product by ID.",
"flatPath": "v2beta1/accounts/{accountId}/products/{productId}",
"httpMethod": "GET",
"id": "adexchangebuyer2.accounts.products.get",
"parameterOrder": [
"accountId",
"productId"
],
"parameters": {
"accountId": {
"description": "Account ID of the buyer.",
"location": "path",
"required": true,
"type": "string"
},
"productId": {
"description": "The ID for the product to get the head revision for.",
"location": "path",
"required": true,
"type": "string"
}
},
"path": "v2beta1/accounts/{accountId}/products/{productId}",
"response": {
"$ref": "Product"
},
"scopes": [
"https://www.googleapis.com/auth/adexchange.buyer"
]
},
"list": {
"description": "List all products visible to the buyer (optionally filtered by the specified PQL query).",
"flatPath": "v2beta1/accounts/{accountId}/products",
"httpMethod": "GET",
"id": "adexchangebuyer2.accounts.products.list",
"parameterOrder": [
"accountId"
],
"parameters": {
"accountId": {
"description": "Account ID of the buyer.",
"location": "path",
"required": true,
"type": "string"
},
"filter": {
"description": "An optional PQL query used to query for products. See https://developers.google.com/ad-manager/docs/pqlreference for documentation about PQL and examples. Nested repeated fields, such as product.targetingCriterion.inclusions, cannot be filtered.",
"location": "query",
"type": "string"
},
"pageSize": {
"description": "Requested page size. The server may return fewer results than requested. If unspecified, the server will pick an appropriate default.",
"format": "int32",
"location": "query",
"type": "integer"
},
"pageToken": {
"description": "The page token as returned from ListProductsResponse.",
"location": "query",
"type": "string"
}
},
"path": "v2beta1/accounts/{accountId}/products",
"response": {
"$ref": "ListProductsResponse"
},
"scopes": [
"https://www.googleapis.com/auth/adexchange.buyer"
]
}
}
},
"proposals": {
"methods": {
"accept": {
"description": "Mark the proposal as accepted at the given revision number. If the number does not match the server's revision number an `ABORTED` error message will be returned. This call updates the proposal_state from `PROPOSED` to `BUYER_ACCEPTED`, or from `SELLER_ACCEPTED` to `FINALIZED`.",
"flatPath": "v2beta1/accounts/{accountId}/proposals/{proposalId}:accept",
"httpMethod": "POST",
"id": "adexchangebuyer2.accounts.proposals.accept",
"parameterOrder": [
"accountId",
"proposalId"
],
"parameters": {
"accountId": {
"description": "Account ID of the buyer.",
"location": "path",
"required": true,
"type": "string"
},
"proposalId": {
"description": "The ID of the proposal to accept.",
"location": "path",
"required": true,
"type": "string"
}
},
"path": "v2beta1/accounts/{accountId}/proposals/{proposalId}:accept",
"request": {
"$ref": "AcceptProposalRequest"
},
"response": {
"$ref": "Proposal"
},
"scopes": [
"https://www.googleapis.com/auth/adexchange.buyer"
]
},
"addNote": {
"description": "Create a new note and attach it to the proposal. The note is assigned a unique ID by the server. The proposal revision number will not increase when associated with a new note.",
"flatPath": "v2beta1/accounts/{accountId}/proposals/{proposalId}:addNote",
"httpMethod": "POST",
"id": "adexchangebuyer2.accounts.proposals.addNote",
"parameterOrder": [
"accountId",
"proposalId"
],
"parameters": {
"accountId": {
"description": "Account ID of the buyer.",
"location": "path",
"required": true,
"type": "string"
},
"proposalId": {
"description": "The ID of the proposal to attach the note to.",
"location": "path",
"required": true,
"type": "string"
}
},
"path": "v2beta1/accounts/{accountId}/proposals/{proposalId}:addNote",
"request": {
"$ref": "AddNoteRequest"
},
"response": {
"$ref": "Note"
},
"scopes": [
"https://www.googleapis.com/auth/adexchange.buyer"
]
},
"cancelNegotiation": {
"description": "Cancel an ongoing negotiation on a proposal. This does not cancel or end serving for the deals if the proposal has been finalized, but only cancels a negotiation unilaterally.",
"flatPath": "v2beta1/accounts/{accountId}/proposals/{proposalId}:cancelNegotiation",
"httpMethod": "POST",
"id": "adexchangebuyer2.accounts.proposals.cancelNegotiation",
"parameterOrder": [
"accountId",
"proposalId"
],
"parameters": {
"accountId": {
"description": "Account ID of the buyer.",
"location": "path",
"required": true,
"type": "string"
},
"proposalId": {
"description": "The ID of the proposal to cancel negotiation for.",
"location": "path",
"required": true,
"type": "string"
}
},
"path": "v2beta1/accounts/{accountId}/proposals/{proposalId}:cancelNegotiation",
"request": {
"$ref": "CancelNegotiationRequest"
},
"response": {
"$ref": "Proposal"
},
"scopes": [
"https://www.googleapis.com/auth/adexchange.buyer"
]
},
"completeSetup": {
"description": "Update the given proposal to indicate that setup has been completed. This method is called by the buyer when the line items have been created on their end for a finalized proposal and all the required creatives have been uploaded using the creatives API. This call updates the `is_setup_completed` bit on the proposal and also notifies the seller. The server will advance the revision number of the most recent proposal.",
"flatPath": "v2beta1/accounts/{accountId}/proposals/{proposalId}:completeSetup",
"httpMethod": "POST",
"id": "adexchangebuyer2.accounts.proposals.completeSetup",
"parameterOrder": [
"accountId",
"proposalId"
],
"parameters": {
"accountId": {
"description": "Account ID of the buyer.",
"location": "path",
"required": true,
"type": "string"
},
"proposalId": {
"description": "The ID of the proposal to mark as setup completed.",
"location": "path",
"required": true,
"type": "string"
}
},
"path": "v2beta1/accounts/{accountId}/proposals/{proposalId}:completeSetup",
"request": {
"$ref": "CompleteSetupRequest"
},
"response": {
"$ref": "Proposal"
},
"scopes": [
"https://www.googleapis.com/auth/adexchange.buyer"
]
},
"create": {
"description": "Create the given proposal. Each created proposal and any deals it contains are assigned a unique ID by the server.",
"flatPath": "v2beta1/accounts/{accountId}/proposals",
"httpMethod": "POST",
"id": "adexchangebuyer2.accounts.proposals.create",
"parameterOrder": [
"accountId"
],
"parameters": {
"accountId": {
"description": "Account ID of the buyer.",
"location": "path",
"required": true,
"type": "string"
}
},
"path": "v2beta1/accounts/{accountId}/proposals",
"request": {
"$ref": "Proposal"
},
"response": {
"$ref": "Proposal"
},
"scopes": [
"https://www.googleapis.com/auth/adexchange.buyer"
]
},
"get": {
"description": "Gets a proposal given its ID. The proposal is returned at its head revision.",
"flatPath": "v2beta1/accounts/{accountId}/proposals/{proposalId}",
"httpMethod": "GET",
"id": "adexchangebuyer2.accounts.proposals.get",
"parameterOrder": [
"accountId",
"proposalId"
],
"parameters": {
"accountId": {
"description": "Account ID of the buyer.",
"location": "path",
"required": true,
"type": "string"
},
"proposalId": {
"description": "The unique ID of the proposal",
"location": "path",
"required": true,
"type": "string"
}
},
"path": "v2beta1/accounts/{accountId}/proposals/{proposalId}",
"response": {
"$ref": "Proposal"
},
"scopes": [
"https://www.googleapis.com/auth/adexchange.buyer"
]
},
"list": {
"description": "List proposals. A filter expression (PQL query) may be specified to filter the results. To retrieve all finalized proposals, regardless if a proposal is being renegotiated, see the FinalizedProposals resource. Note that Bidder/ChildSeat relationships differ from the usual behavior. A Bidder account can only see its child seats' proposals by specifying the ChildSeat's accountId in the request path.",
"flatPath": "v2beta1/accounts/{accountId}/proposals",
"httpMethod": "GET",
"id": "adexchangebuyer2.accounts.proposals.list",
"parameterOrder": [
"accountId"
],
"parameters": {
"accountId": {
"description": "Account ID of the buyer.",
"location": "path",
"required": true,
"type": "string"
},
"filter": {
"description": "An optional PQL filter query used to query for proposals. Nested repeated fields, such as proposal.deals.targetingCriterion, cannot be filtered.",
"location": "query",
"type": "string"
},
"filterSyntax": {
"description": "Syntax the filter is written in. Current implementation defaults to PQL but in the future it will be LIST_FILTER.",
"enum": [
"FILTER_SYNTAX_UNSPECIFIED",
"PQL",
"LIST_FILTER"
],
"enumDescriptions": [
"A placeholder for an undefined filter syntax.",
"PQL query syntax. Visit https://developers.google.com/ad-manager/api/pqlreference for PQL documentation and examples.",
"API list filtering syntax. Read about syntax and usage at https://developers.google.com/authorized-buyers/apis/guides/v2/list-filters."
],
"location": "query",
"type": "string"
},
"pageSize": {
"description": "Requested page size. The server may return fewer results than requested. If unspecified, the server will pick an appropriate default.",
"format": "int32",
"location": "query",
"type": "integer"
},
"pageToken": {
"description": "The page token as returned from ListProposalsResponse.",
"location": "query",
"type": "string"
}
},
"path": "v2beta1/accounts/{accountId}/proposals",
"response": {
"$ref": "ListProposalsResponse"
},
"scopes": [
"https://www.googleapis.com/auth/adexchange.buyer"
]
},
"pause": {
"description": "Update the given proposal to pause serving. This method will set the `DealServingMetadata.DealPauseStatus.has_buyer_paused` bit to true for all deals in the proposal. It is a no-op to pause an already-paused proposal. It is an error to call PauseProposal for a proposal that is not finalized or renegotiating.",
"flatPath": "v2beta1/accounts/{accountId}/proposals/{proposalId}:pause",
"httpMethod": "POST",
"id": "adexchangebuyer2.accounts.proposals.pause",
"parameterOrder": [
"accountId",
"proposalId"
],
"parameters": {
"accountId": {
"description": "Account ID of the buyer.",
"location": "path",
"required": true,
"type": "string"
},
"proposalId": {
"description": "The ID of the proposal to pause.",
"location": "path",
"required": true,
"type": "string"
}
},
"path": "v2beta1/accounts/{accountId}/proposals/{proposalId}:pause",
"request": {
"$ref": "PauseProposalRequest"
},
"response": {
"$ref": "Proposal"
},
"scopes": [
"https://www.googleapis.com/auth/adexchange.buyer"
]
},
"resume": {
"description": "Update the given proposal to resume serving. This method will set the `DealServingMetadata.DealPauseStatus.has_buyer_paused` bit to false for all deals in the proposal. Note that if the `has_seller_paused` bit is also set, serving will not resume until the seller also resumes. It is a no-op to resume an already-running proposal. It is an error to call ResumeProposal for a proposal that is not finalized or renegotiating.",
"flatPath": "v2beta1/accounts/{accountId}/proposals/{proposalId}:resume",
"httpMethod": "POST",
"id": "adexchangebuyer2.accounts.proposals.resume",
"parameterOrder": [
"accountId",
"proposalId"
],
"parameters": {
"accountId": {
"description": "Account ID of the buyer.",
"location": "path",
"required": true,
"type": "string"
},
"proposalId": {
"description": "The ID of the proposal to resume.",
"location": "path",
"required": true,
"type": "string"
}
},
"path": "v2beta1/accounts/{accountId}/proposals/{proposalId}:resume",
"request": {
"$ref": "ResumeProposalRequest"
},
"response": {
"$ref": "Proposal"
},
"scopes": [
"https://www.googleapis.com/auth/adexchange.buyer"
]
},
"update": {
"description": "Update the given proposal at the client known revision number. If the server revision has advanced since the passed-in `proposal.proposal_revision`, an `ABORTED` error message will be returned. Only the buyer-modifiable fields of the proposal will be updated. Note that the deals in the proposal will be updated to match the passed-in copy. If a passed-in deal does not have a `deal_id`, the server will assign a new unique ID and create the deal. If passed-in deal has a `deal_id`, it will be updated to match the passed-in copy. Any existing deals not present in the passed-in proposal will be deleted. It is an error to pass in a deal with a `deal_id` not present at head.",
"flatPath": "v2beta1/accounts/{accountId}/proposals/{proposalId}",
"httpMethod": "PUT",
"id": "adexchangebuyer2.accounts.proposals.update",
"parameterOrder": [
"accountId",
"proposalId"
],
"parameters": {
"accountId": {
"description": "Account ID of the buyer.",
"location": "path",
"required": true,
"type": "string"
},
"proposalId": {
"description": "The unique ID of the proposal.",
"location": "path",
"required": true,
"type": "string"
}
},
"path": "v2beta1/accounts/{accountId}/proposals/{proposalId}",
"request": {
"$ref": "Proposal"
},
"response": {
"$ref": "Proposal"
},
"scopes": [
"https://www.googleapis.com/auth/adexchange.buyer"
]
}
}
},
"publisherProfiles": {
"methods": {
"get": {
"description": "Gets the requested publisher profile by id.",
"flatPath": "v2beta1/accounts/{accountId}/publisherProfiles/{publisherProfileId}",
"httpMethod": "GET",
"id": "adexchangebuyer2.accounts.publisherProfiles.get",
"parameterOrder": [
"accountId",
"publisherProfileId"
],
"parameters": {
"accountId": {
"description": "Account ID of the buyer.",
"location": "path",
"required": true,
"type": "string"
},
"publisherProfileId": {
"description": "The id for the publisher profile to get.",
"location": "path",
"required": true,
"type": "string"
}
},
"path": "v2beta1/accounts/{accountId}/publisherProfiles/{publisherProfileId}",
"response": {
"$ref": "PublisherProfile"
},
"scopes": [
"https://www.googleapis.com/auth/adexchange.buyer"
]
},
"list": {
"description": "List all publisher profiles visible to the buyer",
"flatPath": "v2beta1/accounts/{accountId}/publisherProfiles",
"httpMethod": "GET",
"id": "adexchangebuyer2.accounts.publisherProfiles.list",
"parameterOrder": [
"accountId"
],
"parameters": {
"accountId": {
"description": "Account ID of the buyer.",
"location": "path",
"required": true,
"type": "string"
},
"pageSize": {
"description": "Specify the number of results to include per page.",
"format": "int32",
"location": "query",
"type": "integer"
},
"pageToken": {
"description": "The page token as return from ListPublisherProfilesResponse.",
"location": "query",
"type": "string"
}
},
"path": "v2beta1/accounts/{accountId}/publisherProfiles",
"response": {
"$ref": "ListPublisherProfilesResponse"
},
"scopes": [
"https://www.googleapis.com/auth/adexchange.buyer"
]
}
}
}
}
},
"bidders": {
"resources": {
"accounts": {
"resources": {
"filterSets": {
"methods": {
"create": {
"description": "Creates the specified filter set for the account with the given account ID.",
"flatPath": "v2beta1/bidders/{biddersId}/accounts/{accountsId}/filterSets",
"httpMethod": "POST",
"id": "adexchangebuyer2.bidders.accounts.filterSets.create",
"parameterOrder": [
"ownerName"
],
"parameters": {
"isTransient": {
"description": "Whether the filter set is transient, or should be persisted indefinitely. By default, filter sets are not transient. If transient, it will be available for at least 1 hour after creation.",
"location": "query",
"type": "boolean"
},
"ownerName": {
"description": "Name of the owner (bidder or account) of the filter set to be created. For example: - For a bidder-level filter set for bidder 123: `bidders/123` - For an account-level filter set for the buyer account representing bidder 123: `bidders/123/accounts/123` - For an account-level filter set for the child seat buyer account 456 whose bidder is 123: `bidders/123/accounts/456`",
"location": "path",
"pattern": "^bidders/[^/]+/accounts/[^/]+$",
"required": true,
"type": "string"
}
},
"path": "v2beta1/{+ownerName}/filterSets",
"request": {
"$ref": "FilterSet"
},
"response": {
"$ref": "FilterSet"
},
"scopes": [
"https://www.googleapis.com/auth/adexchange.buyer"
]
},
"delete": {
"description": "Deletes the requested filter set from the account with the given account ID.",
"flatPath": "v2beta1/bidders/{biddersId}/accounts/{accountsId}/filterSets/{filterSetsId}",
"httpMethod": "DELETE",
"id": "adexchangebuyer2.bidders.accounts.filterSets.delete",
"parameterOrder": [
"name"
],
"parameters": {
"name": {
"description": "Full name of the resource to delete. For example: - For a bidder-level filter set for bidder 123: `bidders/123/filterSets/abc` - For an account-level filter set for the buyer account representing bidder 123: `bidders/123/accounts/123/filterSets/abc` - For an account-level filter set for the child seat buyer account 456 whose bidder is 123: `bidders/123/accounts/456/filterSets/abc`",
"location": "path",
"pattern": "^bidders/[^/]+/accounts/[^/]+/filterSets/[^/]+$",
"required": true,
"type": "string"
}
},
"path": "v2beta1/{+name}",
"response": {
"$ref": "Empty"
},
"scopes": [
"https://www.googleapis.com/auth/adexchange.buyer"
]
},
"get": {
"description": "Retrieves the requested filter set for the account with the given account ID.",
"flatPath": "v2beta1/bidders/{biddersId}/accounts/{accountsId}/filterSets/{filterSetsId}",
"httpMethod": "GET",
"id": "adexchangebuyer2.bidders.accounts.filterSets.get",
"parameterOrder": [
"name"
],
"parameters": {
"name": {
"description": "Full name of the resource being requested. For example: - For a bidder-level filter set for bidder 123: `bidders/123/filterSets/abc` - For an account-level filter set for the buyer account representing bidder 123: `bidders/123/accounts/123/filterSets/abc` - For an account-level filter set for the child seat buyer account 456 whose bidder is 123: `bidders/123/accounts/456/filterSets/abc`",
"location": "path",
"pattern": "^bidders/[^/]+/accounts/[^/]+/filterSets/[^/]+$",
"required": true,
"type": "string"
}
},
"path": "v2beta1/{+name}",
"response": {
"$ref": "FilterSet"
},
"scopes": [
"https://www.googleapis.com/auth/adexchange.buyer"
]
},
"list": {
"description": "Lists all filter sets for the account with the given account ID.",
"flatPath": "v2beta1/bidders/{biddersId}/accounts/{accountsId}/filterSets",
"httpMethod": "GET",
"id": "adexchangebuyer2.bidders.accounts.filterSets.list",
"parameterOrder": [
"ownerName"
],
"parameters": {
"ownerName": {
"description": "Name of the owner (bidder or account) of the filter sets to be listed. For example: - For a bidder-level filter set for bidder 123: `bidders/123` - For an account-level filter set for the buyer account representing bidder 123: `bidders/123/accounts/123` - For an account-level filter set for the child seat buyer account 456 whose bidder is 123: `bidders/123/accounts/456`",
"location": "path",
"pattern": "^bidders/[^/]+/accounts/[^/]+$",
"required": true,
"type": "string"
},
"pageSize": {
"description": "Requested page size. The server may return fewer results than requested. If 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. Typically, this is the value of ListFilterSetsResponse.nextPageToken returned from the previous call to the accounts.filterSets.list method.",
"location": "query",
"type": "string"
}
},
"path": "v2beta1/{+ownerName}/filterSets",
"response": {
"$ref": "ListFilterSetsResponse"
},
"scopes": [
"https://www.googleapis.com/auth/adexchange.buyer"
]
}
},
"resources": {
"bidMetrics": {
"methods": {
"list": {
"description": "Lists all metrics that are measured in terms of number of bids.",
"flatPath": "v2beta1/bidders/{biddersId}/accounts/{accountsId}/filterSets/{filterSetsId}/bidMetrics",
"httpMethod": "GET",
"id": "adexchangebuyer2.bidders.accounts.filterSets.bidMetrics.list",
"parameterOrder": [
"filterSetName"
],
"parameters": {
"filterSetName": {
"description": "Name of the filter set that should be applied to the requested metrics. For example: - For a bidder-level filter set for bidder 123: `bidders/123/filterSets/abc` - For an account-level filter set for the buyer account representing bidder 123: `bidders/123/accounts/123/filterSets/abc` - For an account-level filter set for the child seat buyer account 456 whose bidder is 123: `bidders/123/accounts/456/filterSets/abc`",
"location": "path",
"pattern": "^bidders/[^/]+/accounts/[^/]+/filterSets/[^/]+$",
"required": true,
"type": "string"
},
"pageSize": {
"description": "Requested page size. The server may return fewer results than requested. If 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. Typically, this is the value of ListBidMetricsResponse.nextPageToken returned from the previous call to the bidMetrics.list method.",
"location": "query",
"type": "string"
}
},
"path": "v2beta1/{+filterSetName}/bidMetrics",
"response": {
"$ref": "ListBidMetricsResponse"
},
"scopes": [
"https://www.googleapis.com/auth/adexchange.buyer"
]
}
}
},
"bidResponseErrors": {
"methods": {
"list": {
"description": "List all errors that occurred in bid responses, with the number of bid responses affected for each reason.",
"flatPath": "v2beta1/bidders/{biddersId}/accounts/{accountsId}/filterSets/{filterSetsId}/bidResponseErrors",
"httpMethod": "GET",
"id": "adexchangebuyer2.bidders.accounts.filterSets.bidResponseErrors.list",
"parameterOrder": [
"filterSetName"
],
"parameters": {
"filterSetName": {
"description": "Name of the filter set that should be applied to the requested metrics. For example: - For a bidder-level filter set for bidder 123: `bidders/123/filterSets/abc` - For an account-level filter set for the buyer account representing bidder 123: `bidders/123/accounts/123/filterSets/abc` - For an account-level filter set for the child seat buyer account 456 whose bidder is 123: `bidders/123/accounts/456/filterSets/abc`",
"location": "path",
"pattern": "^bidders/[^/]+/accounts/[^/]+/filterSets/[^/]+$",
"required": true,
"type": "string"
},
"pageSize": {
"description": "Requested page size. The server may return fewer results than requested. If 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. Typically, this is the value of ListBidResponseErrorsResponse.nextPageToken returned from the previous call to the bidResponseErrors.list method.",
"location": "query",
"type": "string"
}
},
"path": "v2beta1/{+filterSetName}/bidResponseErrors",
"response": {
"$ref": "ListBidResponseErrorsResponse"
},
"scopes": [
"https://www.googleapis.com/auth/adexchange.buyer"
]
}
}
},
"bidResponsesWithoutBids": {
"methods": {
"list": {
"description": "List all reasons for which bid responses were considered to have no applicable bids, with the number of bid responses affected for each reason.",
"flatPath": "v2beta1/bidders/{biddersId}/accounts/{accountsId}/filterSets/{filterSetsId}/bidResponsesWithoutBids",
"httpMethod": "GET",
"id": "adexchangebuyer2.bidders.accounts.filterSets.bidResponsesWithoutBids.list",
"parameterOrder": [
"filterSetName"
],
"parameters": {
"filterSetName": {
"description": "Name of the filter set that should be applied to the requested metrics. For example: - For a bidder-level filter set for bidder 123: `bidders/123/filterSets/abc` - For an account-level filter set for the buyer account representing bidder 123: `bidders/123/accounts/123/filterSets/abc` - For an account-level filter set for the child seat buyer account 456 whose bidder is 123: `bidders/123/accounts/456/filterSets/abc`",
"location": "path",
"pattern": "^bidders/[^/]+/accounts/[^/]+/filterSets/[^/]+$",
"required": true,
"type": "string"
},
"pageSize": {
"description": "Requested page size. The server may return fewer results than requested. If 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. Typically, this is the value of ListBidResponsesWithoutBidsResponse.nextPageToken returned from the previous call to the bidResponsesWithoutBids.list method.",
"location": "query",
"type": "string"
}
},
"path": "v2beta1/{+filterSetName}/bidResponsesWithoutBids",
"response": {
"$ref": "ListBidResponsesWithoutBidsResponse"
},
"scopes": [
"https://www.googleapis.com/auth/adexchange.buyer"
]
}
}
},
"filteredBidRequests": {
"methods": {
"list": {
"description": "List all reasons that caused a bid request not to be sent for an impression, with the number of bid requests not sent for each reason.",
"flatPath": "v2beta1/bidders/{biddersId}/accounts/{accountsId}/filterSets/{filterSetsId}/filteredBidRequests",
"httpMethod": "GET",
"id": "adexchangebuyer2.bidders.accounts.filterSets.filteredBidRequests.list",
"parameterOrder": [
"filterSetName"
],
"parameters": {
"filterSetName": {
"description": "Name of the filter set that should be applied to the requested metrics. For example: - For a bidder-level filter set for bidder 123: `bidders/123/filterSets/abc` - For an account-level filter set for the buyer account representing bidder 123: `bidders/123/accounts/123/filterSets/abc` - For an account-level filter set for the child seat buyer account 456 whose bidder is 123: `bidders/123/accounts/456/filterSets/abc`",
"location": "path",
"pattern": "^bidders/[^/]+/accounts/[^/]+/filterSets/[^/]+$",
"required": true,
"type": "string"
},
"pageSize": {
"description": "Requested page size. The server may return fewer results than requested. If 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. Typically, this is the value of ListFilteredBidRequestsResponse.nextPageToken returned from the previous call to the filteredBidRequests.list method.",
"location": "query",
"type": "string"
}
},
"path": "v2beta1/{+filterSetName}/filteredBidRequests",
"response": {
"$ref": "ListFilteredBidRequestsResponse"
},
"scopes": [
"https://www.googleapis.com/auth/adexchange.buyer"
]
}
}
},
"filteredBids": {
"methods": {
"list": {
"description": "List all reasons for which bids were filtered, with the number of bids filtered for each reason.",
"flatPath": "v2beta1/bidders/{biddersId}/accounts/{accountsId}/filterSets/{filterSetsId}/filteredBids",
"httpMethod": "GET",
"id": "adexchangebuyer2.bidders.accounts.filterSets.filteredBids.list",
"parameterOrder": [
"filterSetName"
],
"parameters": {
"filterSetName": {
"description": "Name of the filter set that should be applied to the requested metrics. For example: - For a bidder-level filter set for bidder 123: `bidders/123/filterSets/abc` - For an account-level filter set for the buyer account representing bidder 123: `bidders/123/accounts/123/filterSets/abc` - For an account-level filter set for the child seat buyer account 456 whose bidder is 123: `bidders/123/accounts/456/filterSets/abc`",
"location": "path",
"pattern": "^bidders/[^/]+/accounts/[^/]+/filterSets/[^/]+$",
"required": true,
"type": "string"
},
"pageSize": {
"description": "Requested page size. The server may return fewer results than requested. If 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. Typically, this is the value of ListFilteredBidsResponse.nextPageToken returned from the previous call to the filteredBids.list method.",
"location": "query",
"type": "string"
}
},
"path": "v2beta1/{+filterSetName}/filteredBids",
"response": {
"$ref": "ListFilteredBidsResponse"
},
"scopes": [
"https://www.googleapis.com/auth/adexchange.buyer"
]
}
},
"resources": {
"creatives": {
"methods": {
"list": {
"description": "List all creatives associated with a specific reason for which bids were filtered, with the number of bids filtered for each creative.",
"flatPath": "v2beta1/bidders/{biddersId}/accounts/{accountsId}/filterSets/{filterSetsId}/filteredBids/{creativeStatusId}/creatives",
"httpMethod": "GET",
"id": "adexchangebuyer2.bidders.accounts.filterSets.filteredBids.creatives.list",
"parameterOrder": [
"filterSetName",
"creativeStatusId"
],
"parameters": {
"creativeStatusId": {
"description": "The ID of the creative status for which to retrieve a breakdown by creative. See [creative-status-codes](https://developers.google.com/authorized-buyers/rtb/downloads/creative-status-codes).",
"format": "int32",
"location": "path",
"required": true,
"type": "integer"
},
"filterSetName": {
"description": "Name of the filter set that should be applied to the requested metrics. For example: - For a bidder-level filter set for bidder 123: `bidders/123/filterSets/abc` - For an account-level filter set for the buyer account representing bidder 123: `bidders/123/accounts/123/filterSets/abc` - For an account-level filter set for the child seat buyer account 456 whose bidder is 123: `bidders/123/accounts/456/filterSets/abc`",
"location": "path",
"pattern": "^bidders/[^/]+/accounts/[^/]+/filterSets/[^/]+$",
"required": true,
"type": "string"
},
"pageSize": {
"description": "Requested page size. The server may return fewer results than requested. If 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. Typically, this is the value of ListCreativeStatusBreakdownByCreativeResponse.nextPageToken returned from the previous call to the filteredBids.creatives.list method.",
"location": "query",
"type": "string"
}
},
"path": "v2beta1/{+filterSetName}/filteredBids/{creativeStatusId}/creatives",
"response": {
"$ref": "ListCreativeStatusBreakdownByCreativeResponse"
},
"scopes": [
"https://www.googleapis.com/auth/adexchange.buyer"
]
}
}
},
"details": {
"methods": {
"list": {
"description": "List all details associated with a specific reason for which bids were filtered, with the number of bids filtered for each detail.",
"flatPath": "v2beta1/bidders/{biddersId}/accounts/{accountsId}/filterSets/{filterSetsId}/filteredBids/{creativeStatusId}/details",
"httpMethod": "GET",
"id": "adexchangebuyer2.bidders.accounts.filterSets.filteredBids.details.list",
"parameterOrder": [
"filterSetName",
"creativeStatusId"
],
"parameters": {
"creativeStatusId": {
"description": "The ID of the creative status for which to retrieve a breakdown by detail. See [creative-status-codes](https://developers.google.com/authorized-buyers/rtb/downloads/creative-status-codes). Details are only available for statuses 10, 14, 15, 17, 18, 19, 86, and 87.",
"format": "int32",
"location": "path",
"required": true,
"type": "integer"
},
"filterSetName": {
"description": "Name of the filter set that should be applied to the requested metrics. For example: - For a bidder-level filter set for bidder 123: `bidders/123/filterSets/abc` - For an account-level filter set for the buyer account representing bidder 123: `bidders/123/accounts/123/filterSets/abc` - For an account-level filter set for the child seat buyer account 456 whose bidder is 123: `bidders/123/accounts/456/filterSets/abc`",
"location": "path",
"pattern": "^bidders/[^/]+/accounts/[^/]+/filterSets/[^/]+$",
"required": true,
"type": "string"
},
"pageSize": {
"description": "Requested page size. The server may return fewer results than requested. If 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. Typically, this is the value of ListCreativeStatusBreakdownByDetailResponse.nextPageToken returned from the previous call to the filteredBids.details.list method.",
"location": "query",
"type": "string"
}
},
"path": "v2beta1/{+filterSetName}/filteredBids/{creativeStatusId}/details",
"response": {
"$ref": "ListCreativeStatusBreakdownByDetailResponse"
},
"scopes": [
"https://www.googleapis.com/auth/adexchange.buyer"
]
}
}
}
}
},
"impressionMetrics": {
"methods": {
"list": {
"description": "Lists all metrics that are measured in terms of number of impressions.",
"flatPath": "v2beta1/bidders/{biddersId}/accounts/{accountsId}/filterSets/{filterSetsId}/impressionMetrics",
"httpMethod": "GET",
"id": "adexchangebuyer2.bidders.accounts.filterSets.impressionMetrics.list",
"parameterOrder": [
"filterSetName"
],
"parameters": {
"filterSetName": {
"description": "Name of the filter set that should be applied to the requested metrics. For example: - For a bidder-level filter set for bidder 123: `bidders/123/filterSets/abc` - For an account-level filter set for the buyer account representing bidder 123: `bidders/123/accounts/123/filterSets/abc` - For an account-level filter set for the child seat buyer account 456 whose bidder is 123: `bidders/123/accounts/456/filterSets/abc`",
"location": "path",
"pattern": "^bidders/[^/]+/accounts/[^/]+/filterSets/[^/]+$",
"required": true,
"type": "string"
},
"pageSize": {
"description": "Requested page size. The server may return fewer results than requested. If 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. Typically, this is the value of ListImpressionMetricsResponse.nextPageToken returned from the previous call to the impressionMetrics.list method.",
"location": "query",
"type": "string"
}
},
"path": "v2beta1/{+filterSetName}/impressionMetrics",
"response": {
"$ref": "ListImpressionMetricsResponse"
},
"scopes": [
"https://www.googleapis.com/auth/adexchange.buyer"
]
}
}
},
"losingBids": {
"methods": {
"list": {
"description": "List all reasons for which bids lost in the auction, with the number of bids that lost for each reason.",
"flatPath": "v2beta1/bidders/{biddersId}/accounts/{accountsId}/filterSets/{filterSetsId}/losingBids",
"httpMethod": "GET",
"id": "adexchangebuyer2.bidders.accounts.filterSets.losingBids.list",
"parameterOrder": [
"filterSetName"
],
"parameters": {
"filterSetName": {
"description": "Name of the filter set that should be applied to the requested metrics. For example: - For a bidder-level filter set for bidder 123: `bidders/123/filterSets/abc` - For an account-level filter set for the buyer account representing bidder 123: `bidders/123/accounts/123/filterSets/abc` - For an account-level filter set for the child seat buyer account 456 whose bidder is 123: `bidders/123/accounts/456/filterSets/abc`",
"location": "path",
"pattern": "^bidders/[^/]+/accounts/[^/]+/filterSets/[^/]+$",
"required": true,
"type": "string"
},
"pageSize": {
"description": "Requested page size. The server may return fewer results than requested. If 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. Typically, this is the value of ListLosingBidsResponse.nextPageToken returned from the previous call to the losingBids.list method.",
"location": "query",
"type": "string"
}
},
"path": "v2beta1/{+filterSetName}/losingBids",
"response": {
"$ref": "ListLosingBidsResponse"
},
"scopes": [
"https://www.googleapis.com/auth/adexchange.buyer"
]
}
}
},
"nonBillableWinningBids": {
"methods": {
"list": {
"description": "List all reasons for which winning bids were not billable, with the number of bids not billed for each reason.",
"flatPath": "v2beta1/bidders/{biddersId}/accounts/{accountsId}/filterSets/{filterSetsId}/nonBillableWinningBids",
"httpMethod": "GET",
"id": "adexchangebuyer2.bidders.accounts.filterSets.nonBillableWinningBids.list",
"parameterOrder": [
"filterSetName"
],
"parameters": {
"filterSetName": {
"description": "Name of the filter set that should be applied to the requested metrics. For example: - For a bidder-level filter set for bidder 123: `bidders/123/filterSets/abc` - For an account-level filter set for the buyer account representing bidder 123: `bidders/123/accounts/123/filterSets/abc` - For an account-level filter set for the child seat buyer account 456 whose bidder is 123: `bidders/123/accounts/456/filterSets/abc`",
"location": "path",
"pattern": "^bidders/[^/]+/accounts/[^/]+/filterSets/[^/]+$",
"required": true,
"type": "string"
},
"pageSize": {
"description": "Requested page size. The server may return fewer results than requested. If 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. Typically, this is the value of ListNonBillableWinningBidsResponse.nextPageToken returned from the previous call to the nonBillableWinningBids.list method.",
"location": "query",
"type": "string"
}
},
"path": "v2beta1/{+filterSetName}/nonBillableWinningBids",
"response": {
"$ref": "ListNonBillableWinningBidsResponse"
},
"scopes": [
"https://www.googleapis.com/auth/adexchange.buyer"
]
}
}
}
}
}
}
},
"filterSets": {
"methods": {
"create": {
"description": "Creates the specified filter set for the account with the given account ID.",
"flatPath": "v2beta1/bidders/{biddersId}/filterSets",
"httpMethod": "POST",
"id": "adexchangebuyer2.bidders.filterSets.create",
"parameterOrder": [
"ownerName"
],
"parameters": {
"isTransient": {
"description": "Whether the filter set is transient, or should be persisted indefinitely. By default, filter sets are not transient. If transient, it will be available for at least 1 hour after creation.",
"location": "query",
"type": "boolean"
},
"ownerName": {
"description": "Name of the owner (bidder or account) of the filter set to be created. For example: - For a bidder-level filter set for bidder 123: `bidders/123` - For an account-level filter set for the buyer account representing bidder 123: `bidders/123/accounts/123` - For an account-level filter set for the child seat buyer account 456 whose bidder is 123: `bidders/123/accounts/456`",
"location": "path",
"pattern": "^bidders/[^/]+$",
"required": true,
"type": "string"
}
},
"path": "v2beta1/{+ownerName}/filterSets",
"request": {
"$ref": "FilterSet"
},
"response": {
"$ref": "FilterSet"
},
"scopes": [
"https://www.googleapis.com/auth/adexchange.buyer"
]
},
"delete": {
"description": "Deletes the requested filter set from the account with the given account ID.",
"flatPath": "v2beta1/bidders/{biddersId}/filterSets/{filterSetsId}",
"httpMethod": "DELETE",
"id": "adexchangebuyer2.bidders.filterSets.delete",
"parameterOrder": [
"name"
],
"parameters": {
"name": {
"description": "Full name of the resource to delete. For example: - For a bidder-level filter set for bidder 123: `bidders/123/filterSets/abc` - For an account-level filter set for the buyer account representing bidder 123: `bidders/123/accounts/123/filterSets/abc` - For an account-level filter set for the child seat buyer account 456 whose bidder is 123: `bidders/123/accounts/456/filterSets/abc`",
"location": "path",
"pattern": "^bidders/[^/]+/filterSets/[^/]+$",
"required": true,
"type": "string"
}
},
"path": "v2beta1/{+name}",
"response": {
"$ref": "Empty"
},
"scopes": [
"https://www.googleapis.com/auth/adexchange.buyer"
]
},
"get": {
"description": "Retrieves the requested filter set for the account with the given account ID.",
"flatPath": "v2beta1/bidders/{biddersId}/filterSets/{filterSetsId}",
"httpMethod": "GET",
"id": "adexchangebuyer2.bidders.filterSets.get",
"parameterOrder": [
"name"
],
"parameters": {
"name": {
"description": "Full name of the resource being requested. For example: - For a bidder-level filter set for bidder 123: `bidders/123/filterSets/abc` - For an account-level filter set for the buyer account representing bidder 123: `bidders/123/accounts/123/filterSets/abc` - For an account-level filter set for the child seat buyer account 456 whose bidder is 123: `bidders/123/accounts/456/filterSets/abc`",
"location": "path",
"pattern": "^bidders/[^/]+/filterSets/[^/]+$",
"required": true,
"type": "string"
}
},
"path": "v2beta1/{+name}",
"response": {
"$ref": "FilterSet"
},
"scopes": [
"https://www.googleapis.com/auth/adexchange.buyer"
]
},
"list": {
"description": "Lists all filter sets for the account with the given account ID.",
"flatPath": "v2beta1/bidders/{biddersId}/filterSets",
"httpMethod": "GET",
"id": "adexchangebuyer2.bidders.filterSets.list",
"parameterOrder": [
"ownerName"
],
"parameters": {
"ownerName": {
"description": "Name of the owner (bidder or account) of the filter sets to be listed. For example: - For a bidder-level filter set for bidder 123: `bidders/123` - For an account-level filter set for the buyer account representing bidder 123: `bidders/123/accounts/123` - For an account-level filter set for the child seat buyer account 456 whose bidder is 123: `bidders/123/accounts/456`",
"location": "path",
"pattern": "^bidders/[^/]+$",
"required": true,
"type": "string"
},
"pageSize": {
"description": "Requested page size. The server may return fewer results than requested. If 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. Typically, this is the value of ListFilterSetsResponse.nextPageToken returned from the previous call to the accounts.filterSets.list method.",
"location": "query",
"type": "string"
}
},
"path": "v2beta1/{+ownerName}/filterSets",
"response": {
"$ref": "ListFilterSetsResponse"
},
"scopes": [
"https://www.googleapis.com/auth/adexchange.buyer"
]
}
},
"resources": {
"bidMetrics": {
"methods": {
"list": {
"description": "Lists all metrics that are measured in terms of number of bids.",
"flatPath": "v2beta1/bidders/{biddersId}/filterSets/{filterSetsId}/bidMetrics",
"httpMethod": "GET",
"id": "adexchangebuyer2.bidders.filterSets.bidMetrics.list",
"parameterOrder": [
"filterSetName"
],
"parameters": {
"filterSetName": {
"description": "Name of the filter set that should be applied to the requested metrics. For example: - For a bidder-level filter set for bidder 123: `bidders/123/filterSets/abc` - For an account-level filter set for the buyer account representing bidder 123: `bidders/123/accounts/123/filterSets/abc` - For an account-level filter set for the child seat buyer account 456 whose bidder is 123: `bidders/123/accounts/456/filterSets/abc`",
"location": "path",
"pattern": "^bidders/[^/]+/filterSets/[^/]+$",
"required": true,
"type": "string"
},
"pageSize": {
"description": "Requested page size. The server may return fewer results than requested. If 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. Typically, this is the value of ListBidMetricsResponse.nextPageToken returned from the previous call to the bidMetrics.list method.",
"location": "query",
"type": "string"
}
},
"path": "v2beta1/{+filterSetName}/bidMetrics",
"response": {
"$ref": "ListBidMetricsResponse"
},
"scopes": [
"https://www.googleapis.com/auth/adexchange.buyer"
]
}
}
},
"bidResponseErrors": {
"methods": {
"list": {
"description": "List all errors that occurred in bid responses, with the number of bid responses affected for each reason.",
"flatPath": "v2beta1/bidders/{biddersId}/filterSets/{filterSetsId}/bidResponseErrors",
"httpMethod": "GET",
"id": "adexchangebuyer2.bidders.filterSets.bidResponseErrors.list",
"parameterOrder": [
"filterSetName"
],
"parameters": {
"filterSetName": {
"description": "Name of the filter set that should be applied to the requested metrics. For example: - For a bidder-level filter set for bidder 123: `bidders/123/filterSets/abc` - For an account-level filter set for the buyer account representing bidder 123: `bidders/123/accounts/123/filterSets/abc` - For an account-level filter set for the child seat buyer account 456 whose bidder is 123: `bidders/123/accounts/456/filterSets/abc`",
"location": "path",
"pattern": "^bidders/[^/]+/filterSets/[^/]+$",
"required": true,
"type": "string"
},
"pageSize": {
"description": "Requested page size. The server may return fewer results than requested. If 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. Typically, this is the value of ListBidResponseErrorsResponse.nextPageToken returned from the previous call to the bidResponseErrors.list method.",
"location": "query",
"type": "string"
}
},
"path": "v2beta1/{+filterSetName}/bidResponseErrors",
"response": {
"$ref": "ListBidResponseErrorsResponse"
},
"scopes": [
"https://www.googleapis.com/auth/adexchange.buyer"
]
}
}
},
"bidResponsesWithoutBids": {
"methods": {
"list": {
"description": "List all reasons for which bid responses were considered to have no applicable bids, with the number of bid responses affected for each reason.",
"flatPath": "v2beta1/bidders/{biddersId}/filterSets/{filterSetsId}/bidResponsesWithoutBids",
"httpMethod": "GET",
"id": "adexchangebuyer2.bidders.filterSets.bidResponsesWithoutBids.list",
"parameterOrder": [
"filterSetName"
],
"parameters": {
"filterSetName": {
"description": "Name of the filter set that should be applied to the requested metrics. For example: - For a bidder-level filter set for bidder 123: `bidders/123/filterSets/abc` - For an account-level filter set for the buyer account representing bidder 123: `bidders/123/accounts/123/filterSets/abc` - For an account-level filter set for the child seat buyer account 456 whose bidder is 123: `bidders/123/accounts/456/filterSets/abc`",
"location": "path",
"pattern": "^bidders/[^/]+/filterSets/[^/]+$",
"required": true,
"type": "string"
},
"pageSize": {
"description": "Requested page size. The server may return fewer results than requested. If 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. Typically, this is the value of ListBidResponsesWithoutBidsResponse.nextPageToken returned from the previous call to the bidResponsesWithoutBids.list method.",
"location": "query",
"type": "string"
}
},
"path": "v2beta1/{+filterSetName}/bidResponsesWithoutBids",
"response": {
"$ref": "ListBidResponsesWithoutBidsResponse"
},
"scopes": [
"https://www.googleapis.com/auth/adexchange.buyer"
]
}
}
},
"filteredBidRequests": {
"methods": {
"list": {
"description": "List all reasons that caused a bid request not to be sent for an impression, with the number of bid requests not sent for each reason.",
"flatPath": "v2beta1/bidders/{biddersId}/filterSets/{filterSetsId}/filteredBidRequests",
"httpMethod": "GET",
"id": "adexchangebuyer2.bidders.filterSets.filteredBidRequests.list",
"parameterOrder": [
"filterSetName"
],
"parameters": {
"filterSetName": {
"description": "Name of the filter set that should be applied to the requested metrics. For example: - For a bidder-level filter set for bidder 123: `bidders/123/filterSets/abc` - For an account-level filter set for the buyer account representing bidder 123: `bidders/123/accounts/123/filterSets/abc` - For an account-level filter set for the child seat buyer account 456 whose bidder is 123: `bidders/123/accounts/456/filterSets/abc`",
"location": "path",
"pattern": "^bidders/[^/]+/filterSets/[^/]+$",
"required": true,
"type": "string"
},
"pageSize": {
"description": "Requested page size. The server may return fewer results than requested. If 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. Typically, this is the value of ListFilteredBidRequestsResponse.nextPageToken returned from the previous call to the filteredBidRequests.list method.",
"location": "query",
"type": "string"
}
},
"path": "v2beta1/{+filterSetName}/filteredBidRequests",
"response": {
"$ref": "ListFilteredBidRequestsResponse"
},
"scopes": [
"https://www.googleapis.com/auth/adexchange.buyer"
]
}
}
},
"filteredBids": {
"methods": {
"list": {
"description": "List all reasons for which bids were filtered, with the number of bids filtered for each reason.",
"flatPath": "v2beta1/bidders/{biddersId}/filterSets/{filterSetsId}/filteredBids",
"httpMethod": "GET",
"id": "adexchangebuyer2.bidders.filterSets.filteredBids.list",
"parameterOrder": [
"filterSetName"
],
"parameters": {
"filterSetName": {
"description": "Name of the filter set that should be applied to the requested metrics. For example: - For a bidder-level filter set for bidder 123: `bidders/123/filterSets/abc` - For an account-level filter set for the buyer account representing bidder 123: `bidders/123/accounts/123/filterSets/abc` - For an account-level filter set for the child seat buyer account 456 whose bidder is 123: `bidders/123/accounts/456/filterSets/abc`",
"location": "path",
"pattern": "^bidders/[^/]+/filterSets/[^/]+$",
"required": true,
"type": "string"
},
"pageSize": {
"description": "Requested page size. The server may return fewer results than requested. If 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. Typically, this is the value of ListFilteredBidsResponse.nextPageToken returned from the previous call to the filteredBids.list method.",
"location": "query",
"type": "string"
}
},
"path": "v2beta1/{+filterSetName}/filteredBids",
"response": {
"$ref": "ListFilteredBidsResponse"
},
"scopes": [
"https://www.googleapis.com/auth/adexchange.buyer"
]
}
},
"resources": {
"creatives": {
"methods": {
"list": {
"description": "List all creatives associated with a specific reason for which bids were filtered, with the number of bids filtered for each creative.",
"flatPath": "v2beta1/bidders/{biddersId}/filterSets/{filterSetsId}/filteredBids/{creativeStatusId}/creatives",
"httpMethod": "GET",
"id": "adexchangebuyer2.bidders.filterSets.filteredBids.creatives.list",
"parameterOrder": [
"filterSetName",
"creativeStatusId"
],
"parameters": {
"creativeStatusId": {
"description": "The ID of the creative status for which to retrieve a breakdown by creative. See [creative-status-codes](https://developers.google.com/authorized-buyers/rtb/downloads/creative-status-codes).",
"format": "int32",
"location": "path",
"required": true,
"type": "integer"
},
"filterSetName": {
"description": "Name of the filter set that should be applied to the requested metrics. For example: - For a bidder-level filter set for bidder 123: `bidders/123/filterSets/abc` - For an account-level filter set for the buyer account representing bidder 123: `bidders/123/accounts/123/filterSets/abc` - For an account-level filter set for the child seat buyer account 456 whose bidder is 123: `bidders/123/accounts/456/filterSets/abc`",
"location": "path",
"pattern": "^bidders/[^/]+/filterSets/[^/]+$",
"required": true,
"type": "string"
},
"pageSize": {
"description": "Requested page size. The server may return fewer results than requested. If 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. Typically, this is the value of ListCreativeStatusBreakdownByCreativeResponse.nextPageToken returned from the previous call to the filteredBids.creatives.list method.",
"location": "query",
"type": "string"
}
},
"path": "v2beta1/{+filterSetName}/filteredBids/{creativeStatusId}/creatives",
"response": {
"$ref": "ListCreativeStatusBreakdownByCreativeResponse"
},
"scopes": [
"https://www.googleapis.com/auth/adexchange.buyer"
]
}
}
},
"details": {
"methods": {
"list": {
"description": "List all details associated with a specific reason for which bids were filtered, with the number of bids filtered for each detail.",
"flatPath": "v2beta1/bidders/{biddersId}/filterSets/{filterSetsId}/filteredBids/{creativeStatusId}/details",
"httpMethod": "GET",
"id": "adexchangebuyer2.bidders.filterSets.filteredBids.details.list",
"parameterOrder": [
"filterSetName",
"creativeStatusId"
],
"parameters": {
"creativeStatusId": {
"description": "The ID of the creative status for which to retrieve a breakdown by detail. See [creative-status-codes](https://developers.google.com/authorized-buyers/rtb/downloads/creative-status-codes). Details are only available for statuses 10, 14, 15, 17, 18, 19, 86, and 87.",
"format": "int32",
"location": "path",
"required": true,
"type": "integer"
},
"filterSetName": {
"description": "Name of the filter set that should be applied to the requested metrics. For example: - For a bidder-level filter set for bidder 123: `bidders/123/filterSets/abc` - For an account-level filter set for the buyer account representing bidder 123: `bidders/123/accounts/123/filterSets/abc` - For an account-level filter set for the child seat buyer account 456 whose bidder is 123: `bidders/123/accounts/456/filterSets/abc`",
"location": "path",
"pattern": "^bidders/[^/]+/filterSets/[^/]+$",
"required": true,
"type": "string"
},
"pageSize": {
"description": "Requested page size. The server may return fewer results than requested. If 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. Typically, this is the value of ListCreativeStatusBreakdownByDetailResponse.nextPageToken returned from the previous call to the filteredBids.details.list method.",
"location": "query",
"type": "string"
}
},
"path": "v2beta1/{+filterSetName}/filteredBids/{creativeStatusId}/details",
"response": {
"$ref": "ListCreativeStatusBreakdownByDetailResponse"
},
"scopes": [
"https://www.googleapis.com/auth/adexchange.buyer"
]
}
}
}
}
},
"impressionMetrics": {
"methods": {
"list": {
"description": "Lists all metrics that are measured in terms of number of impressions.",
"flatPath": "v2beta1/bidders/{biddersId}/filterSets/{filterSetsId}/impressionMetrics",
"httpMethod": "GET",
"id": "adexchangebuyer2.bidders.filterSets.impressionMetrics.list",
"parameterOrder": [
"filterSetName"
],
"parameters": {
"filterSetName": {
"description": "Name of the filter set that should be applied to the requested metrics. For example: - For a bidder-level filter set for bidder 123: `bidders/123/filterSets/abc` - For an account-level filter set for the buyer account representing bidder 123: `bidders/123/accounts/123/filterSets/abc` - For an account-level filter set for the child seat buyer account 456 whose bidder is 123: `bidders/123/accounts/456/filterSets/abc`",
"location": "path",
"pattern": "^bidders/[^/]+/filterSets/[^/]+$",
"required": true,
"type": "string"
},
"pageSize": {
"description": "Requested page size. The server may return fewer results than requested. If 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. Typically, this is the value of ListImpressionMetricsResponse.nextPageToken returned from the previous call to the impressionMetrics.list method.",
"location": "query",
"type": "string"
}
},
"path": "v2beta1/{+filterSetName}/impressionMetrics",
"response": {
"$ref": "ListImpressionMetricsResponse"
},
"scopes": [
"https://www.googleapis.com/auth/adexchange.buyer"
]
}
}
},
"losingBids": {
"methods": {
"list": {
"description": "List all reasons for which bids lost in the auction, with the number of bids that lost for each reason.",
"flatPath": "v2beta1/bidders/{biddersId}/filterSets/{filterSetsId}/losingBids",
"httpMethod": "GET",
"id": "adexchangebuyer2.bidders.filterSets.losingBids.list",
"parameterOrder": [
"filterSetName"
],
"parameters": {
"filterSetName": {
"description": "Name of the filter set that should be applied to the requested metrics. For example: - For a bidder-level filter set for bidder 123: `bidders/123/filterSets/abc` - For an account-level filter set for the buyer account representing bidder 123: `bidders/123/accounts/123/filterSets/abc` - For an account-level filter set for the child seat buyer account 456 whose bidder is 123: `bidders/123/accounts/456/filterSets/abc`",
"location": "path",
"pattern": "^bidders/[^/]+/filterSets/[^/]+$",
"required": true,
"type": "string"
},
"pageSize": {
"description": "Requested page size. The server may return fewer results than requested. If 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. Typically, this is the value of ListLosingBidsResponse.nextPageToken returned from the previous call to the losingBids.list method.",
"location": "query",
"type": "string"
}
},
"path": "v2beta1/{+filterSetName}/losingBids",
"response": {
"$ref": "ListLosingBidsResponse"
},
"scopes": [
"https://www.googleapis.com/auth/adexchange.buyer"
]
}
}
},
"nonBillableWinningBids": {
"methods": {
"list": {
"description": "List all reasons for which winning bids were not billable, with the number of bids not billed for each reason.",
"flatPath": "v2beta1/bidders/{biddersId}/filterSets/{filterSetsId}/nonBillableWinningBids",
"httpMethod": "GET",
"id": "adexchangebuyer2.bidders.filterSets.nonBillableWinningBids.list",
"parameterOrder": [
"filterSetName"
],
"parameters": {
"filterSetName": {
"description": "Name of the filter set that should be applied to the requested metrics. For example: - For a bidder-level filter set for bidder 123: `bidders/123/filterSets/abc` - For an account-level filter set for the buyer account representing bidder 123: `bidders/123/accounts/123/filterSets/abc` - For an account-level filter set for the child seat buyer account 456 whose bidder is 123: `bidders/123/accounts/456/filterSets/abc`",
"location": "path",
"pattern": "^bidders/[^/]+/filterSets/[^/]+$",
"required": true,
"type": "string"
},
"pageSize": {
"description": "Requested page size. The server may return fewer results than requested. If 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. Typically, this is the value of ListNonBillableWinningBidsResponse.nextPageToken returned from the previous call to the nonBillableWinningBids.list method.",
"location": "query",
"type": "string"
}
},
"path": "v2beta1/{+filterSetName}/nonBillableWinningBids",
"response": {
"$ref": "ListNonBillableWinningBidsResponse"
},
"scopes": [
"https://www.googleapis.com/auth/adexchange.buyer"
]
}
}
}
}
}
}
}
},
"revision": "20200822",
"rootUrl": "https://adexchangebuyer.googleapis.com/",
"schemas": {
"AbsoluteDateRange": {
"description": "An absolute date range, specified by its start date and end date. The supported range of dates begins 30 days before today and ends today. Validity checked upon filter set creation. If a filter set with an absolute date range is run at a later date more than 30 days after start_date, it will fail.",
"id": "AbsoluteDateRange",
"properties": {
"endDate": {
"$ref": "Date",
"description": "The end date of the range (inclusive). Must be within the 30 days leading up to current date, and must be equal to or after start_date."
},
"startDate": {
"$ref": "Date",
"description": "The start date of the range (inclusive). Must be within the 30 days leading up to current date, and must be equal to or before end_date."
}
},
"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. This 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 change of outside environment."
],
"type": "string"
},
"width": {
"description": "The width of the ad slot in pixels. This field will be present only when size type is `PIXEL`.",
"format": "int64",
"type": "string"
}
},
"type": "object"
},
"AdTechnologyProviders": {
"description": "Detected ad technology provider information.",
"id": "AdTechnologyProviders",
"properties": {
"detectedProviderIds": {
"description": "The detected ad technology provider IDs for this creative. See https://storage.googleapis.com/adx-rtb-dictionaries/providers.csv for mapping of provider ID to provided name, a privacy policy URL, and a list of domains which can be attributed to the provider. If the creative contains provider IDs that are outside of those listed in the `BidRequest.adslot.consented_providers_settings.consented_providers` field on the (Google bid protocol)[https://developers.google.com/authorized-buyers/rtb/downloads/realtime-bidding-proto] and the `BidRequest.user.ext.consented_providers_settings.consented_providers` field on the (OpenRTB protocol)[https://developers.google.com/authorized-buyers/rtb/downloads/openrtb-adx-proto], and a bid is submitted with that creative for an impression that will serve to an EEA user, the bid will be filtered before the auction.",
"items": {
"format": "int64",
"type": "string"
},
"type": "array"
},
"hasUnidentifiedProvider": {
"description": "Whether the creative contains an unidentified ad technology provider. If true for a given creative, any bid submitted with that creative for an impression that will serve to an EEA user will be filtered before the auction.",
"type": "boolean"
}
},
"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": "Output only. The app type the restriction applies to for mobile device.",
"id": "AppContext",
"properties": {
"appTypes": {
"description": "The app types this restriction applies to.",
"items": {