| Index: discovery/googleapis_beta/adexchangebuyer2__v2beta1.json
|
| diff --git a/discovery/googleapis_beta/adexchangebuyer2__v2beta1.json b/discovery/googleapis_beta/adexchangebuyer2__v2beta1.json
|
| index 7ef884ee548b33dc3ee8d7739468601fee8daf0a..8dd8bd775bbd47b8fe5b03f677caf52067b7b968 100644
|
| --- a/discovery/googleapis_beta/adexchangebuyer2__v2beta1.json
|
| +++ b/discovery/googleapis_beta/adexchangebuyer2__v2beta1.json
|
| @@ -25,45 +25,13 @@
|
| "ownerDomain": "google.com",
|
| "ownerName": "Google",
|
| "parameters": {
|
| - "pp": {
|
| - "default": "true",
|
| - "description": "Pretty-print response.",
|
| - "location": "query",
|
| - "type": "boolean"
|
| - },
|
| - "bearer_token": {
|
| - "description": "OAuth bearer token.",
|
| - "location": "query",
|
| - "type": "string"
|
| - },
|
| - "oauth_token": {
|
| - "description": "OAuth 2.0 token for the current user.",
|
| - "location": "query",
|
| - "type": "string"
|
| - },
|
| - "upload_protocol": {
|
| - "description": "Upload protocol for media (e.g. \"raw\", \"multipart\").",
|
| - "location": "query",
|
| - "type": "string"
|
| - },
|
| - "prettyPrint": {
|
| - "default": "true",
|
| - "description": "Returns response with indentations and line breaks.",
|
| - "location": "query",
|
| - "type": "boolean"
|
| - },
|
| - "fields": {
|
| - "description": "Selector specifying which fields to include in a partial response.",
|
| - "location": "query",
|
| - "type": "string"
|
| - },
|
| "uploadType": {
|
| "description": "Legacy upload protocol for media (e.g. \"media\", \"multipart\").",
|
| "location": "query",
|
| "type": "string"
|
| },
|
| - "callback": {
|
| - "description": "JSONP",
|
| + "fields": {
|
| + "description": "Selector specifying which fields to include in a partial response.",
|
| "location": "query",
|
| "type": "string"
|
| },
|
| @@ -80,6 +48,11 @@
|
| "location": "query",
|
| "type": "string"
|
| },
|
| + "callback": {
|
| + "description": "JSONP",
|
| + "location": "query",
|
| + "type": "string"
|
| + },
|
| "alt": {
|
| "default": "json",
|
| "description": "Data format for response.",
|
| @@ -96,13 +69,13 @@
|
| "location": "query",
|
| "type": "string"
|
| },
|
| - "access_token": {
|
| - "description": "OAuth access token.",
|
| + "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"
|
| },
|
| - "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.",
|
| + "access_token": {
|
| + "description": "OAuth access token.",
|
| "location": "query",
|
| "type": "string"
|
| },
|
| @@ -110,140 +83,165 @@
|
| "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"
|
| + },
|
| + "pp": {
|
| + "default": "true",
|
| + "description": "Pretty-print response.",
|
| + "location": "query",
|
| + "type": "boolean"
|
| + },
|
| + "bearer_token": {
|
| + "description": "OAuth bearer token.",
|
| + "location": "query",
|
| + "type": "string"
|
| + },
|
| + "oauth_token": {
|
| + "description": "OAuth 2.0 token for the current user.",
|
| + "location": "query",
|
| + "type": "string"
|
| + },
|
| + "upload_protocol": {
|
| + "description": "Upload protocol for media (e.g. \"raw\", \"multipart\").",
|
| + "location": "query",
|
| + "type": "string"
|
| + },
|
| + "prettyPrint": {
|
| + "default": "true",
|
| + "description": "Returns response with indentations and line breaks.",
|
| + "location": "query",
|
| + "type": "boolean"
|
| }
|
| },
|
| "protocol": "rest",
|
| "resources": {
|
| "accounts": {
|
| "resources": {
|
| - "filterSets": {
|
| + "clients": {
|
| "methods": {
|
| - "get": {
|
| - "description": "Retrieves the requested filter set for the account with the given account\nID.",
|
| - "httpMethod": "GET",
|
| - "id": "adexchangebuyer2.accounts.filterSets.get",
|
| + "update": {
|
| + "description": "Updates an existing client buyer.",
|
| + "httpMethod": "PUT",
|
| + "id": "adexchangebuyer2.accounts.clients.update",
|
| "parameterOrder": [
|
| "accountId",
|
| - "filterSetId"
|
| + "clientAccountId"
|
| ],
|
| "parameters": {
|
| - "filterSetId": {
|
| - "description": "The ID of the filter set to get.",
|
| + "accountId": {
|
| + "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"
|
| },
|
| - "accountId": {
|
| - "description": "Account ID of the buyer.",
|
| + "clientAccountId": {
|
| + "description": "Unique numerical account ID of the client to update. (required)",
|
| "format": "int64",
|
| "location": "path",
|
| "required": true,
|
| "type": "string"
|
| }
|
| },
|
| - "path": "v2beta1/accounts/{accountId}/filterSets/{filterSetId}",
|
| + "path": "v2beta1/accounts/{accountId}/clients/{clientAccountId}",
|
| + "request": {
|
| + "$ref": "Client"
|
| + },
|
| "response": {
|
| - "$ref": "FilterSet"
|
| + "$ref": "Client"
|
| },
|
| "scopes": [
|
| "https://www.googleapis.com/auth/adexchange.buyer"
|
| ]
|
| },
|
| - "list": {
|
| - "description": "Lists all filter sets for the account with the given account ID.",
|
| - "httpMethod": "GET",
|
| - "id": "adexchangebuyer2.accounts.filterSets.list",
|
| + "create": {
|
| + "description": "Creates a new client buyer.",
|
| + "httpMethod": "POST",
|
| + "id": "adexchangebuyer2.accounts.clients.create",
|
| "parameterOrder": [
|
| "accountId"
|
| ],
|
| "parameters": {
|
| - "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.",
|
| - "location": "query",
|
| - "type": "string"
|
| - },
|
| "accountId": {
|
| - "description": "Account ID of the buyer.",
|
| + "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)",
|
| "format": "int64",
|
| "location": "path",
|
| "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"
|
| }
|
| },
|
| - "path": "v2beta1/accounts/{accountId}/filterSets",
|
| + "path": "v2beta1/accounts/{accountId}/clients",
|
| + "request": {
|
| + "$ref": "Client"
|
| + },
|
| "response": {
|
| - "$ref": "ListFilterSetsResponse"
|
| + "$ref": "Client"
|
| },
|
| "scopes": [
|
| "https://www.googleapis.com/auth/adexchange.buyer"
|
| ]
|
| },
|
| - "create": {
|
| - "description": "Creates the specified filter set for the account with the given account ID.",
|
| - "httpMethod": "POST",
|
| - "id": "adexchangebuyer2.accounts.filterSets.create",
|
| + "list": {
|
| + "description": "Lists all the clients for the current sponsor buyer.",
|
| + "httpMethod": "GET",
|
| + "id": "adexchangebuyer2.accounts.clients.list",
|
| "parameterOrder": [
|
| "accountId"
|
| ],
|
| "parameters": {
|
| + "pageToken": {
|
| + "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 method.",
|
| + "location": "query",
|
| + "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"
|
| + },
|
| "accountId": {
|
| - "description": "Account ID of the buyer.",
|
| + "description": "Unique numerical account ID of the sponsor buyer to list the clients for.",
|
| "format": "int64",
|
| "location": "path",
|
| "required": true,
|
| "type": "string"
|
| - },
|
| - "isTransient": {
|
| - "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"
|
| }
|
| },
|
| - "path": "v2beta1/accounts/{accountId}/filterSets",
|
| - "request": {
|
| - "$ref": "FilterSet"
|
| - },
|
| + "path": "v2beta1/accounts/{accountId}/clients",
|
| "response": {
|
| - "$ref": "FilterSet"
|
| + "$ref": "ListClientsResponse"
|
| },
|
| "scopes": [
|
| "https://www.googleapis.com/auth/adexchange.buyer"
|
| ]
|
| },
|
| - "delete": {
|
| - "description": "Deletes the requested filter set from the account with the given account\nID.",
|
| - "httpMethod": "DELETE",
|
| - "id": "adexchangebuyer2.accounts.filterSets.delete",
|
| + "get": {
|
| + "description": "Gets a client buyer with a given client account ID.",
|
| + "httpMethod": "GET",
|
| + "id": "adexchangebuyer2.accounts.clients.get",
|
| "parameterOrder": [
|
| "accountId",
|
| - "filterSetId"
|
| + "clientAccountId"
|
| ],
|
| "parameters": {
|
| "accountId": {
|
| - "description": "Account ID of the buyer.",
|
| + "description": "Numerical account ID of the client's sponsor buyer. (required)",
|
| "format": "int64",
|
| "location": "path",
|
| "required": true,
|
| "type": "string"
|
| },
|
| - "filterSetId": {
|
| - "description": "The ID of the filter set to delete.",
|
| + "clientAccountId": {
|
| + "description": "Numerical account ID of the client buyer to retrieve. (required)",
|
| "format": "int64",
|
| "location": "path",
|
| "required": true,
|
| "type": "string"
|
| }
|
| },
|
| - "path": "v2beta1/accounts/{accountId}/filterSets/{filterSetId}",
|
| + "path": "v2beta1/accounts/{accountId}/clients/{clientAccountId}",
|
| "response": {
|
| - "$ref": "Empty"
|
| + "$ref": "Client"
|
| },
|
| "scopes": [
|
| "https://www.googleapis.com/auth/adexchange.buyer"
|
| @@ -251,316 +249,120 @@
|
| }
|
| },
|
| "resources": {
|
| - "filteredBids": {
|
| + "invitations": {
|
| "methods": {
|
| "list": {
|
| - "description": "List all reasons for which bids were filtered, with the number of bids\nfiltered for each reason.",
|
| + "description": "Lists all the client users invitations for a client\nwith a given account ID.",
|
| "httpMethod": "GET",
|
| - "id": "adexchangebuyer2.accounts.filterSets.filteredBids.list",
|
| + "id": "adexchangebuyer2.accounts.clients.invitations.list",
|
| "parameterOrder": [
|
| "accountId",
|
| - "filterSetId"
|
| + "clientAccountId"
|
| ],
|
| "parameters": {
|
| - "accountId": {
|
| - "description": "Account ID of the buyer.",
|
| - "format": "int64",
|
| - "location": "path",
|
| - "required": true,
|
| + "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.",
|
| + "location": "query",
|
| "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": "Requested page size. Server may return fewer clients than requested.\nIf unspecified, server will pick an appropriate default.",
|
| "format": "int32",
|
| "location": "query",
|
| "type": "integer"
|
| },
|
| - "filterSetId": {
|
| - "description": "The ID of the filter set to apply.",
|
| + "accountId": {
|
| + "description": "Numerical account ID of the client's sponsor buyer. (required)",
|
| "format": "int64",
|
| "location": "path",
|
| "required": true,
|
| "type": "string"
|
| },
|
| - "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\naccounts.filterSets.filteredBids.list\nmethod.",
|
| - "location": "query",
|
| + "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"
|
| }
|
| },
|
| - "path": "v2beta1/accounts/{accountId}/filterSets/{filterSetId}/filteredBids",
|
| + "path": "v2beta1/accounts/{accountId}/clients/{clientAccountId}/invitations",
|
| "response": {
|
| - "$ref": "ListFilteredBidsResponse"
|
| + "$ref": "ListClientUserInvitationsResponse"
|
| },
|
| "scopes": [
|
| "https://www.googleapis.com/auth/adexchange.buyer"
|
| ]
|
| - }
|
| - },
|
| - "resources": {
|
| - "details": {
|
| - "methods": {
|
| - "list": {
|
| - "description": "List all details associated with a specific reason for which bids were\nfiltered, with the number of bids filtered for each detail.",
|
| - "httpMethod": "GET",
|
| - "id": "adexchangebuyer2.accounts.filterSets.filteredBids.details.list",
|
| - "parameterOrder": [
|
| - "accountId",
|
| - "filterSetId",
|
| - "creativeStatusId"
|
| - ],
|
| - "parameters": {
|
| - "creativeStatusId": {
|
| - "description": "The ID of the creative status for which to retrieve a breakdown by detail.\nSee\n[creative-status-codes](https://developers.google.com/ad-exchange/rtb/downloads/creative-status-codes).",
|
| - "format": "int32",
|
| - "location": "path",
|
| - "required": true,
|
| - "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\naccounts.filterSets.filteredBids.details.list\nmethod.",
|
| - "location": "query",
|
| - "type": "string"
|
| - },
|
| - "accountId": {
|
| - "description": "Account ID of the buyer.",
|
| - "format": "int64",
|
| - "location": "path",
|
| - "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"
|
| - },
|
| - "filterSetId": {
|
| - "description": "The ID of the filter set to apply.",
|
| - "format": "int64",
|
| - "location": "path",
|
| - "required": true,
|
| - "type": "string"
|
| - }
|
| - },
|
| - "path": "v2beta1/accounts/{accountId}/filterSets/{filterSetId}/filteredBids/{creativeStatusId}/details",
|
| - "response": {
|
| - "$ref": "ListCreativeStatusBreakdownByDetailResponse"
|
| - },
|
| - "scopes": [
|
| - "https://www.googleapis.com/auth/adexchange.buyer"
|
| - ]
|
| - }
|
| - }
|
| },
|
| - "creatives": {
|
| - "methods": {
|
| - "list": {
|
| - "description": "List all creatives associated with a specific reason for which bids were\nfiltered, with the number of bids filtered for each creative.",
|
| - "httpMethod": "GET",
|
| - "id": "adexchangebuyer2.accounts.filterSets.filteredBids.creatives.list",
|
| - "parameterOrder": [
|
| - "accountId",
|
| - "filterSetId",
|
| - "creativeStatusId"
|
| - ],
|
| - "parameters": {
|
| - "creativeStatusId": {
|
| - "description": "The ID of the creative status for which to retrieve a breakdown by\ncreative.\nSee\n[creative-status-codes](https://developers.google.com/ad-exchange/rtb/downloads/creative-status-codes).",
|
| - "format": "int32",
|
| - "location": "path",
|
| - "required": true,
|
| - "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\naccounts.filterSets.filteredBids.creatives.list\nmethod.",
|
| - "location": "query",
|
| - "type": "string"
|
| - },
|
| - "accountId": {
|
| - "description": "Account ID of the buyer.",
|
| - "format": "int64",
|
| - "location": "path",
|
| - "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"
|
| - },
|
| - "filterSetId": {
|
| - "description": "The ID of the filter set to apply.",
|
| - "format": "int64",
|
| - "location": "path",
|
| - "required": true,
|
| - "type": "string"
|
| - }
|
| - },
|
| - "path": "v2beta1/accounts/{accountId}/filterSets/{filterSetId}/filteredBids/{creativeStatusId}/creatives",
|
| - "response": {
|
| - "$ref": "ListCreativeStatusBreakdownByCreativeResponse"
|
| - },
|
| - "scopes": [
|
| - "https://www.googleapis.com/auth/adexchange.buyer"
|
| - ]
|
| - }
|
| - },
|
| - "resources": {
|
| - "details": {
|
| - "methods": {
|
| - "list": {
|
| - "description": "List all details associated with a specific reason for which bids were\nfiltered and a specific creative that was filtered for that reason, with\nthe number of bids filtered for each detail.",
|
| - "httpMethod": "GET",
|
| - "id": "adexchangebuyer2.accounts.filterSets.filteredBids.creatives.details.list",
|
| - "parameterOrder": [
|
| - "accountId",
|
| - "filterSetId",
|
| - "creativeStatusId",
|
| - "creativeId"
|
| - ],
|
| - "parameters": {
|
| - "pageToken": {
|
| - "description": "A token identifying a page of results the server should return.\nTypically, this is the value of\nListCreativeStatusAndCreativeBreakdownByDetailResponse.nextPageToken\nreturned from the previous call to the\naccounts.filterSets.filteredBids.creatives.details.list\nmethod.",
|
| - "location": "query",
|
| - "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"
|
| - },
|
| - "creativeId": {
|
| - "description": "The creative ID for which to retrieve a breakdown by detail.",
|
| - "location": "path",
|
| - "required": true,
|
| - "type": "string"
|
| - },
|
| - "creativeStatusId": {
|
| - "description": "The ID of the creative status for which to retrieve a breakdown by detail.\nSee\n[creative-status-codes](https://developers.google.com/ad-exchange/rtb/downloads/creative-status-codes).",
|
| - "format": "int32",
|
| - "location": "path",
|
| - "required": true,
|
| - "type": "integer"
|
| - },
|
| - "accountId": {
|
| - "description": "Account ID of the buyer.",
|
| - "format": "int64",
|
| - "location": "path",
|
| - "required": true,
|
| - "type": "string"
|
| - },
|
| - "filterSetId": {
|
| - "description": "The ID of the filter set to apply.",
|
| - "format": "int64",
|
| - "location": "path",
|
| - "required": true,
|
| - "type": "string"
|
| - }
|
| - },
|
| - "path": "v2beta1/accounts/{accountId}/filterSets/{filterSetId}/filteredBids/{creativeStatusId}/creatives/{creativeId}/details",
|
| - "response": {
|
| - "$ref": "ListCreativeStatusAndCreativeBreakdownByDetailResponse"
|
| - },
|
| - "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\nof bids not billed for each reason.",
|
| + "get": {
|
| + "description": "Retrieves an existing client user invitation.",
|
| "httpMethod": "GET",
|
| - "id": "adexchangebuyer2.accounts.filterSets.nonBillableWinningBids.list",
|
| + "id": "adexchangebuyer2.accounts.clients.invitations.get",
|
| "parameterOrder": [
|
| "accountId",
|
| - "filterSetId"
|
| + "clientAccountId",
|
| + "invitationId"
|
| ],
|
| "parameters": {
|
| - "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\naccounts.filterSets.nonBillableWinningBids.list\nmethod.",
|
| - "location": "query",
|
| - "type": "string"
|
| - },
|
| "accountId": {
|
| - "description": "Account ID of the buyer.",
|
| + "description": "Numerical account ID of the client's sponsor buyer. (required)",
|
| "format": "int64",
|
| "location": "path",
|
| "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"
|
| + "clientAccountId": {
|
| + "description": "Numerical account ID of the client buyer that the user invitation\nto be retrieved is associated with. (required)",
|
| + "format": "int64",
|
| + "location": "path",
|
| + "required": true,
|
| + "type": "string"
|
| },
|
| - "filterSetId": {
|
| - "description": "The ID of the filter set to apply.",
|
| + "invitationId": {
|
| + "description": "Numerical identifier of the user invitation to retrieve. (required)",
|
| "format": "int64",
|
| "location": "path",
|
| "required": true,
|
| "type": "string"
|
| }
|
| },
|
| - "path": "v2beta1/accounts/{accountId}/filterSets/{filterSetId}/nonBillableWinningBids",
|
| + "path": "v2beta1/accounts/{accountId}/clients/{clientAccountId}/invitations/{invitationId}",
|
| "response": {
|
| - "$ref": "ListNonBillableWinningBidsResponse"
|
| + "$ref": "ClientUserInvitation"
|
| },
|
| "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\nbids that lost for each reason.",
|
| - "httpMethod": "GET",
|
| - "id": "adexchangebuyer2.accounts.filterSets.losingBids.list",
|
| + },
|
| + "create": {
|
| + "description": "Creates and sends out an email invitation to access\nan Ad Exchange client buyer account.",
|
| + "httpMethod": "POST",
|
| + "id": "adexchangebuyer2.accounts.clients.invitations.create",
|
| "parameterOrder": [
|
| "accountId",
|
| - "filterSetId"
|
| + "clientAccountId"
|
| ],
|
| "parameters": {
|
| - "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\naccounts.filterSets.losingBids.list\nmethod.",
|
| - "location": "query",
|
| - "type": "string"
|
| - },
|
| "accountId": {
|
| - "description": "Account ID of the buyer.",
|
| + "description": "Numerical account ID of the client's sponsor buyer. (required)",
|
| "format": "int64",
|
| "location": "path",
|
| "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"
|
| - },
|
| - "filterSetId": {
|
| - "description": "The ID of the filter set to apply.",
|
| + "clientAccountId": {
|
| + "description": "Numerical account ID of the client buyer that the user\nshould be associated with. (required)",
|
| "format": "int64",
|
| "location": "path",
|
| "required": true,
|
| "type": "string"
|
| }
|
| },
|
| - "path": "v2beta1/accounts/{accountId}/filterSets/{filterSetId}/losingBids",
|
| + "path": "v2beta1/accounts/{accountId}/clients/{clientAccountId}/invitations",
|
| + "request": {
|
| + "$ref": "ClientUserInvitation"
|
| + },
|
| "response": {
|
| - "$ref": "ListLosingBidsResponse"
|
| + "$ref": "ClientUserInvitation"
|
| },
|
| "scopes": [
|
| "https://www.googleapis.com/auth/adexchange.buyer"
|
| @@ -568,234 +370,128 @@
|
| }
|
| }
|
| },
|
| - "impressionMetrics": {
|
| + "users": {
|
| "methods": {
|
| - "list": {
|
| - "description": "Lists all metrics that are measured in terms of number of impressions.",
|
| + "get": {
|
| + "description": "Retrieves an existing client user.",
|
| "httpMethod": "GET",
|
| - "id": "adexchangebuyer2.accounts.filterSets.impressionMetrics.list",
|
| + "id": "adexchangebuyer2.accounts.clients.users.get",
|
| "parameterOrder": [
|
| "accountId",
|
| - "filterSetId"
|
| + "clientAccountId",
|
| + "userId"
|
| ],
|
| "parameters": {
|
| - "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\naccounts.filterSets.impressionMetrics.list\nmethod.",
|
| - "location": "query",
|
| + "userId": {
|
| + "description": "Numerical identifier of the user to retrieve. (required)",
|
| + "format": "int64",
|
| + "location": "path",
|
| + "required": true,
|
| "type": "string"
|
| },
|
| "accountId": {
|
| - "description": "Account ID of the buyer.",
|
| + "description": "Numerical account ID of the client's sponsor buyer. (required)",
|
| "format": "int64",
|
| "location": "path",
|
| "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"
|
| - },
|
| - "filterSetId": {
|
| - "description": "The ID of the filter set to apply.",
|
| + "clientAccountId": {
|
| + "description": "Numerical account ID of the client buyer\nthat the user to be retrieved is associated with. (required)",
|
| "format": "int64",
|
| "location": "path",
|
| "required": true,
|
| "type": "string"
|
| }
|
| },
|
| - "path": "v2beta1/accounts/{accountId}/filterSets/{filterSetId}/impressionMetrics",
|
| + "path": "v2beta1/accounts/{accountId}/clients/{clientAccountId}/users/{userId}",
|
| "response": {
|
| - "$ref": "ListImpressionMetricsResponse"
|
| + "$ref": "ClientUser"
|
| },
|
| "scopes": [
|
| "https://www.googleapis.com/auth/adexchange.buyer"
|
| ]
|
| - }
|
| - }
|
| - },
|
| - "bidMetrics": {
|
| - "methods": {
|
| + },
|
| "list": {
|
| - "description": "Lists all metrics that are measured in terms of number of bids.",
|
| + "description": "Lists all the known client users for a specified\nsponsor buyer account ID.",
|
| "httpMethod": "GET",
|
| - "id": "adexchangebuyer2.accounts.filterSets.bidMetrics.list",
|
| + "id": "adexchangebuyer2.accounts.clients.users.list",
|
| "parameterOrder": [
|
| "accountId",
|
| - "filterSetId"
|
| + "clientAccountId"
|
| ],
|
| "parameters": {
|
| "pageToken": {
|
| - "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\naccounts.filterSets.bidMetrics.list\nmethod.",
|
| + "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.",
|
| "location": "query",
|
| "type": "string"
|
| },
|
| - "accountId": {
|
| - "description": "Account ID of the buyer.",
|
| - "format": "int64",
|
| - "location": "path",
|
| - "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": "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"
|
| },
|
| - "filterSetId": {
|
| - "description": "The ID of the filter set to apply.",
|
| + "accountId": {
|
| + "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"
|
| }
|
| },
|
| - "path": "v2beta1/accounts/{accountId}/filterSets/{filterSetId}/bidMetrics",
|
| + "path": "v2beta1/accounts/{accountId}/clients/{clientAccountId}/users",
|
| "response": {
|
| - "$ref": "ListBidMetricsResponse"
|
| + "$ref": "ListClientUsersResponse"
|
| },
|
| "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\nresponses affected for each reason.",
|
| - "httpMethod": "GET",
|
| - "id": "adexchangebuyer2.accounts.filterSets.bidResponseErrors.list",
|
| + },
|
| + "update": {
|
| + "description": "Updates an existing client user.\nOnly the user status can be changed on update.",
|
| + "httpMethod": "PUT",
|
| + "id": "adexchangebuyer2.accounts.clients.users.update",
|
| "parameterOrder": [
|
| "accountId",
|
| - "filterSetId"
|
| + "clientAccountId",
|
| + "userId"
|
| ],
|
| "parameters": {
|
| - "filterSetId": {
|
| - "description": "The ID of the filter set to apply.",
|
| + "userId": {
|
| + "description": "Numerical identifier of the user to retrieve. (required)",
|
| "format": "int64",
|
| "location": "path",
|
| "required": true,
|
| "type": "string"
|
| },
|
| - "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\naccounts.filterSets.bidResponseErrors.list\nmethod.",
|
| - "location": "query",
|
| - "type": "string"
|
| - },
|
| "accountId": {
|
| - "description": "Account ID of the buyer.",
|
| + "description": "Numerical account ID of the client's sponsor buyer. (required)",
|
| "format": "int64",
|
| "location": "path",
|
| "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"
|
| - }
|
| - },
|
| - "path": "v2beta1/accounts/{accountId}/filterSets/{filterSetId}/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\napplicable bids, with the number of bid responses affected for each reason.",
|
| - "httpMethod": "GET",
|
| - "id": "adexchangebuyer2.accounts.filterSets.bidResponsesWithoutBids.list",
|
| - "parameterOrder": [
|
| - "accountId",
|
| - "filterSetId"
|
| - ],
|
| - "parameters": {
|
| - "filterSetId": {
|
| - "description": "The ID of the filter set to apply.",
|
| - "format": "int64",
|
| - "location": "path",
|
| - "required": true,
|
| - "type": "string"
|
| - },
|
| - "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\naccounts.filterSets.bidResponsesWithoutBids.list\nmethod.",
|
| - "location": "query",
|
| - "type": "string"
|
| - },
|
| - "accountId": {
|
| - "description": "Account ID of the buyer.",
|
| + "clientAccountId": {
|
| + "description": "Numerical account ID of the client buyer that the user to be retrieved\nis associated with. (required)",
|
| "format": "int64",
|
| "location": "path",
|
| "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"
|
| }
|
| },
|
| - "path": "v2beta1/accounts/{accountId}/filterSets/{filterSetId}/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\nimpression, with the number of bid requests not sent for each reason.",
|
| - "httpMethod": "GET",
|
| - "id": "adexchangebuyer2.accounts.filterSets.filteredBidRequests.list",
|
| - "parameterOrder": [
|
| - "accountId",
|
| - "filterSetId"
|
| - ],
|
| - "parameters": {
|
| - "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\naccounts.filterSets.filteredBidRequests.list\nmethod.",
|
| - "location": "query",
|
| - "type": "string"
|
| - },
|
| - "accountId": {
|
| - "description": "Account ID of the buyer.",
|
| - "format": "int64",
|
| - "location": "path",
|
| - "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"
|
| - },
|
| - "filterSetId": {
|
| - "description": "The ID of the filter set to apply.",
|
| - "format": "int64",
|
| - "location": "path",
|
| - "required": true,
|
| - "type": "string"
|
| - }
|
| + "path": "v2beta1/accounts/{accountId}/clients/{clientAccountId}/users/{userId}",
|
| + "request": {
|
| + "$ref": "ClientUser"
|
| },
|
| - "path": "v2beta1/accounts/{accountId}/filterSets/{filterSetId}/filteredBidRequests",
|
| "response": {
|
| - "$ref": "ListFilteredBidRequestsResponse"
|
| + "$ref": "ClientUser"
|
| },
|
| "scopes": [
|
| "https://www.googleapis.com/auth/adexchange.buyer"
|
| @@ -805,382 +501,322 @@
|
| }
|
| }
|
| },
|
| - "clients": {
|
| + "creatives": {
|
| "methods": {
|
| "get": {
|
| - "description": "Gets a client buyer with a given client account ID.",
|
| + "description": "Gets a creative.",
|
| "httpMethod": "GET",
|
| - "id": "adexchangebuyer2.accounts.clients.get",
|
| + "id": "adexchangebuyer2.accounts.creatives.get",
|
| "parameterOrder": [
|
| "accountId",
|
| - "clientAccountId"
|
| + "creativeId"
|
| ],
|
| "parameters": {
|
| "accountId": {
|
| - "description": "Numerical account ID of the client's sponsor buyer. (required)",
|
| - "format": "int64",
|
| + "description": "The account the creative belongs to.",
|
| "location": "path",
|
| "required": true,
|
| "type": "string"
|
| },
|
| - "clientAccountId": {
|
| - "description": "Numerical account ID of the client buyer to retrieve. (required)",
|
| - "format": "int64",
|
| + "creativeId": {
|
| + "description": "The ID of the creative to retrieve.",
|
| "location": "path",
|
| "required": true,
|
| "type": "string"
|
| }
|
| },
|
| - "path": "v2beta1/accounts/{accountId}/clients/{clientAccountId}",
|
| + "path": "v2beta1/accounts/{accountId}/creatives/{creativeId}",
|
| "response": {
|
| - "$ref": "Client"
|
| + "$ref": "Creative"
|
| },
|
| "scopes": [
|
| "https://www.googleapis.com/auth/adexchange.buyer"
|
| ]
|
| },
|
| - "list": {
|
| - "description": "Lists all the clients for the current sponsor buyer.",
|
| - "httpMethod": "GET",
|
| - "id": "adexchangebuyer2.accounts.clients.list",
|
| + "watch": {
|
| + "description": "Watches a creative. Will result in push notifications being sent to the\ntopic when the creative changes status.",
|
| + "httpMethod": "POST",
|
| + "id": "adexchangebuyer2.accounts.creatives.watch",
|
| "parameterOrder": [
|
| - "accountId"
|
| + "accountId",
|
| + "creativeId"
|
| ],
|
| "parameters": {
|
| "accountId": {
|
| - "description": "Unique numerical account ID of the sponsor buyer to list the clients for.",
|
| - "format": "int64",
|
| + "description": "The account of the creative to watch.",
|
| "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\nListClientsResponse.nextPageToken\nreturned from the previous call to the\naccounts.clients.list method.",
|
| - "location": "query",
|
| + "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.",
|
| + "location": "path",
|
| + "required": true,
|
| "type": "string"
|
| }
|
| },
|
| - "path": "v2beta1/accounts/{accountId}/clients",
|
| + "path": "v2beta1/accounts/{accountId}/creatives/{creativeId}:watch",
|
| + "request": {
|
| + "$ref": "WatchCreativeRequest"
|
| + },
|
| "response": {
|
| - "$ref": "ListClientsResponse"
|
| + "$ref": "Empty"
|
| },
|
| "scopes": [
|
| "https://www.googleapis.com/auth/adexchange.buyer"
|
| ]
|
| },
|
| "update": {
|
| - "description": "Updates an existing client buyer.",
|
| + "description": "Updates a creative.",
|
| "httpMethod": "PUT",
|
| - "id": "adexchangebuyer2.accounts.clients.update",
|
| + "id": "adexchangebuyer2.accounts.creatives.update",
|
| "parameterOrder": [
|
| "accountId",
|
| - "clientAccountId"
|
| + "creativeId"
|
| ],
|
| "parameters": {
|
| "accountId": {
|
| - "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",
|
| + "description": "The account that this creative belongs to.\nCan be used to filter the response of the\ncreatives.list\nmethod.",
|
| "location": "path",
|
| "required": true,
|
| "type": "string"
|
| },
|
| - "clientAccountId": {
|
| - "description": "Unique numerical account ID of the client to update. (required)",
|
| - "format": "int64",
|
| + "creativeId": {
|
| + "description": "The buyer-defined creative ID of this creative.\nCan be used to filter the response of the\ncreatives.list\nmethod.",
|
| "location": "path",
|
| "required": true,
|
| "type": "string"
|
| }
|
| },
|
| - "path": "v2beta1/accounts/{accountId}/clients/{clientAccountId}",
|
| + "path": "v2beta1/accounts/{accountId}/creatives/{creativeId}",
|
| "request": {
|
| - "$ref": "Client"
|
| + "$ref": "Creative"
|
| },
|
| "response": {
|
| - "$ref": "Client"
|
| + "$ref": "Creative"
|
| + },
|
| + "scopes": [
|
| + "https://www.googleapis.com/auth/adexchange.buyer"
|
| + ]
|
| + },
|
| + "list": {
|
| + "description": "Lists creatives.",
|
| + "httpMethod": "GET",
|
| + "id": "adexchangebuyer2.accounts.creatives.list",
|
| + "parameterOrder": [
|
| + "accountId"
|
| + ],
|
| + "parameters": {
|
| + "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"
|
| + },
|
| + "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"
|
| + },
|
| + "accountId": {
|
| + "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"
|
| + },
|
| + "query": {
|
| + "description": "An optional query string to filter creatives. If no filter is specified,\nall active creatives will be returned.\nSupported queries are:\n<ul>\n<li>accountId=<i>account_id_string</i>\n<li>creativeId=<i>creative_id_string</i>\n<li>dealsStatus: {approved, conditionally_approved, disapproved,\n not_checked}\n<li>openAuctionStatus: {approved, conditionally_approved, disapproved,\n not_checked}\n<li>attribute: {a numeric attribute from the list of attributes}\n<li>disapprovalReason: {a reason from DisapprovalReason\n</ul>\nExample: '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"
|
| ]
|
| },
|
| "create": {
|
| - "description": "Creates a new client buyer.",
|
| + "description": "Creates a creative.",
|
| "httpMethod": "POST",
|
| - "id": "adexchangebuyer2.accounts.clients.create",
|
| + "id": "adexchangebuyer2.accounts.creatives.create",
|
| "parameterOrder": [
|
| "accountId"
|
| ],
|
| "parameters": {
|
| + "duplicateIdMode": {
|
| + "description": "Indicates if multiple creatives can share an ID or not. Default is\nNO_DUPLICATES (one ID per creative).",
|
| + "enum": [
|
| + "NO_DUPLICATES",
|
| + "FORCE_ENABLE_DUPLICATE_IDS"
|
| + ],
|
| + "location": "query",
|
| + "type": "string"
|
| + },
|
| "accountId": {
|
| - "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)",
|
| - "format": "int64",
|
| + "description": "The account that this creative belongs to.\nCan be used to filter the response of the\ncreatives.list\nmethod.",
|
| "location": "path",
|
| "required": true,
|
| "type": "string"
|
| }
|
| },
|
| - "path": "v2beta1/accounts/{accountId}/clients",
|
| + "path": "v2beta1/accounts/{accountId}/creatives",
|
| "request": {
|
| - "$ref": "Client"
|
| + "$ref": "Creative"
|
| },
|
| "response": {
|
| - "$ref": "Client"
|
| + "$ref": "Creative"
|
| },
|
| "scopes": [
|
| "https://www.googleapis.com/auth/adexchange.buyer"
|
| ]
|
| - }
|
| - },
|
| - "resources": {
|
| - "invitations": {
|
| - "methods": {
|
| - "create": {
|
| - "description": "Creates and sends out an email invitation to access\nan Ad Exchange client buyer account.",
|
| - "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\nshould 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"
|
| - ]
|
| + },
|
| + "stopWatching": {
|
| + "description": "Stops watching a creative. Will stop push notifications being sent to the\ntopics when the creative changes status.",
|
| + "httpMethod": "POST",
|
| + "id": "adexchangebuyer2.accounts.creatives.stopWatching",
|
| + "parameterOrder": [
|
| + "accountId",
|
| + "creativeId"
|
| + ],
|
| + "parameters": {
|
| + "creativeId": {
|
| + "description": "The creative ID of the creative to stop notifications for.\nSpecify \"-\" to specify stopping account level notifications.",
|
| + "location": "path",
|
| + "required": true,
|
| + "type": "string"
|
| },
|
| - "get": {
|
| - "description": "Retrieves an existing client user invitation.",
|
| - "httpMethod": "GET",
|
| - "id": "adexchangebuyer2.accounts.clients.invitations.get",
|
| + "accountId": {
|
| + "description": "The account of the creative to stop notifications for.",
|
| + "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"
|
| + ]
|
| + }
|
| + },
|
| + "resources": {
|
| + "dealAssociations": {
|
| + "methods": {
|
| + "remove": {
|
| + "description": "Remove the association between a deal and a creative.",
|
| + "httpMethod": "POST",
|
| + "id": "adexchangebuyer2.accounts.creatives.dealAssociations.remove",
|
| "parameterOrder": [
|
| "accountId",
|
| - "clientAccountId",
|
| - "invitationId"
|
| + "creativeId"
|
| ],
|
| "parameters": {
|
| - "invitationId": {
|
| - "description": "Numerical identifier of the user invitation to retrieve. (required)",
|
| - "format": "int64",
|
| - "location": "path",
|
| - "required": true,
|
| - "type": "string"
|
| - },
|
| "accountId": {
|
| - "description": "Numerical account ID of the client's sponsor buyer. (required)",
|
| - "format": "int64",
|
| + "description": "The account the creative belongs to.",
|
| "location": "path",
|
| "required": true,
|
| "type": "string"
|
| },
|
| - "clientAccountId": {
|
| - "description": "Numerical account ID of the client buyer that the user invitation\nto be retrieved is associated with. (required)",
|
| - "format": "int64",
|
| + "creativeId": {
|
| + "description": "The ID of the creative associated with the deal.",
|
| "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\nwith a given account ID.",
|
| - "httpMethod": "GET",
|
| - "id": "adexchangebuyer2.accounts.clients.invitations.list",
|
| - "parameterOrder": [
|
| - "accountId",
|
| - "clientAccountId"
|
| - ],
|
| - "parameters": {
|
| - "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.",
|
| - "location": "query",
|
| - "type": "string"
|
| - },
|
| - "accountId": {
|
| - "description": "Numerical account ID of the client's sponsor buyer. (required)",
|
| - "format": "int64",
|
| - "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"
|
| - },
|
| - "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"
|
| - }
|
| + "path": "v2beta1/accounts/{accountId}/creatives/{creativeId}/dealAssociations:remove",
|
| + "request": {
|
| + "$ref": "RemoveDealAssociationRequest"
|
| },
|
| - "path": "v2beta1/accounts/{accountId}/clients/{clientAccountId}/invitations",
|
| "response": {
|
| - "$ref": "ListClientUserInvitationsResponse"
|
| + "$ref": "Empty"
|
| },
|
| "scopes": [
|
| "https://www.googleapis.com/auth/adexchange.buyer"
|
| ]
|
| - }
|
| - }
|
| - },
|
| - "users": {
|
| - "methods": {
|
| - "update": {
|
| - "description": "Updates an existing client user.\nOnly the user status can be changed on update.",
|
| - "httpMethod": "PUT",
|
| - "id": "adexchangebuyer2.accounts.clients.users.update",
|
| + },
|
| + "add": {
|
| + "description": "Associate an existing deal with a creative.",
|
| + "httpMethod": "POST",
|
| + "id": "adexchangebuyer2.accounts.creatives.dealAssociations.add",
|
| "parameterOrder": [
|
| "accountId",
|
| - "clientAccountId",
|
| - "userId"
|
| + "creativeId"
|
| ],
|
| "parameters": {
|
| - "userId": {
|
| - "description": "Numerical identifier of the user to retrieve. (required)",
|
| - "format": "int64",
|
| - "location": "path",
|
| - "required": true,
|
| - "type": "string"
|
| - },
|
| "accountId": {
|
| - "description": "Numerical account ID of the client's sponsor buyer. (required)",
|
| - "format": "int64",
|
| + "description": "The account the creative belongs to.",
|
| "location": "path",
|
| "required": true,
|
| "type": "string"
|
| },
|
| - "clientAccountId": {
|
| - "description": "Numerical account ID of the client buyer that the user to be retrieved\nis associated with. (required)",
|
| - "format": "int64",
|
| + "creativeId": {
|
| + "description": "The ID of the creative associated with the deal.",
|
| "location": "path",
|
| "required": true,
|
| "type": "string"
|
| }
|
| },
|
| - "path": "v2beta1/accounts/{accountId}/clients/{clientAccountId}/users/{userId}",
|
| + "path": "v2beta1/accounts/{accountId}/creatives/{creativeId}/dealAssociations:add",
|
| "request": {
|
| - "$ref": "ClientUser"
|
| + "$ref": "AddDealAssociationRequest"
|
| },
|
| "response": {
|
| - "$ref": "ClientUser"
|
| + "$ref": "Empty"
|
| },
|
| "scopes": [
|
| "https://www.googleapis.com/auth/adexchange.buyer"
|
| ]
|
| },
|
| "list": {
|
| - "description": "Lists all the known client users for a specified\nsponsor buyer account ID.",
|
| + "description": "List all creative-deal associations.",
|
| "httpMethod": "GET",
|
| - "id": "adexchangebuyer2.accounts.clients.users.list",
|
| + "id": "adexchangebuyer2.accounts.creatives.dealAssociations.list",
|
| "parameterOrder": [
|
| "accountId",
|
| - "clientAccountId"
|
| + "creativeId"
|
| ],
|
| "parameters": {
|
| - "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.",
|
| - "location": "query",
|
| - "type": "string"
|
| - },
|
| - "accountId": {
|
| - "description": "Numerical account ID of the sponsor buyer of the client to list users for.\n(required)",
|
| - "format": "int64",
|
| + "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"
|
| },
|
| + "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"
|
| + },
|
| "pageSize": {
|
| - "description": "Requested page size. The server may return fewer clients than requested.\nIf unspecified, the server will pick an appropriate default.",
|
| + "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"
|
| },
|
| - "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"
|
| - }
|
| - },
|
| - "path": "v2beta1/accounts/{accountId}/clients/{clientAccountId}/users",
|
| - "response": {
|
| - "$ref": "ListClientUsersResponse"
|
| - },
|
| - "scopes": [
|
| - "https://www.googleapis.com/auth/adexchange.buyer"
|
| - ]
|
| - },
|
| - "get": {
|
| - "description": "Retrieves an existing client user.",
|
| - "httpMethod": "GET",
|
| - "id": "adexchangebuyer2.accounts.clients.users.get",
|
| - "parameterOrder": [
|
| - "accountId",
|
| - "clientAccountId",
|
| - "userId"
|
| - ],
|
| - "parameters": {
|
| - "userId": {
|
| - "description": "Numerical identifier of the user to retrieve. (required)",
|
| - "format": "int64",
|
| - "location": "path",
|
| - "required": true,
|
| - "type": "string"
|
| - },
|
| "accountId": {
|
| - "description": "Numerical account ID of the client's sponsor buyer. (required)",
|
| - "format": "int64",
|
| + "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"
|
| },
|
| - "clientAccountId": {
|
| - "description": "Numerical account ID of the client buyer\nthat the user to be retrieved is associated with. (required)",
|
| - "format": "int64",
|
| - "location": "path",
|
| - "required": true,
|
| + "query": {
|
| + "description": "An optional query string to filter deal associations. If no filter is\nspecified, all associations will be returned.\nSupported queries are:\n<ul>\n<li>accountId=<i>account_id_string</i>\n<li>creativeId=<i>creative_id_string</i>\n<li>dealsId=<i>deals_id_string</i>\n<li>dealsStatus:{approved, conditionally_approved, disapproved,\n not_checked}\n<li>openAuctionStatus:{approved, conditionally_approved, disapproved,\n not_checked}\n</ul>\nExample: 'dealsId=12345 AND dealsStatus:disapproved'",
|
| + "location": "query",
|
| "type": "string"
|
| }
|
| },
|
| - "path": "v2beta1/accounts/{accountId}/clients/{clientAccountId}/users/{userId}",
|
| + "path": "v2beta1/accounts/{accountId}/creatives/{creativeId}/dealAssociations",
|
| "response": {
|
| - "$ref": "ClientUser"
|
| + "$ref": "ListDealAssociationsResponse"
|
| },
|
| "scopes": [
|
| "https://www.googleapis.com/auth/adexchange.buyer"
|
| @@ -1190,69 +826,33 @@
|
| }
|
| }
|
| },
|
| - "creatives": {
|
| + "filterSets": {
|
| "methods": {
|
| - "create": {
|
| - "description": "Creates a creative.",
|
| - "httpMethod": "POST",
|
| - "id": "adexchangebuyer2.accounts.creatives.create",
|
| + "delete": {
|
| + "description": "Deletes the requested filter set from the account with the given account\nID.",
|
| + "httpMethod": "DELETE",
|
| + "id": "adexchangebuyer2.accounts.filterSets.delete",
|
| "parameterOrder": [
|
| - "accountId"
|
| - ],
|
| - "parameters": {
|
| - "duplicateIdMode": {
|
| - "description": "Indicates if multiple creatives can share an ID or not. Default is\nNO_DUPLICATES (one ID per creative).",
|
| - "enum": [
|
| - "NO_DUPLICATES",
|
| - "FORCE_ENABLE_DUPLICATE_IDS"
|
| - ],
|
| - "location": "query",
|
| - "type": "string"
|
| - },
|
| - "accountId": {
|
| - "description": "The account that this creative belongs to.\nCan be used to filter the response of the\ncreatives.list\nmethod.",
|
| - "location": "path",
|
| - "required": true,
|
| - "type": "string"
|
| - }
|
| - },
|
| - "path": "v2beta1/accounts/{accountId}/creatives",
|
| - "request": {
|
| - "$ref": "Creative"
|
| - },
|
| - "response": {
|
| - "$ref": "Creative"
|
| - },
|
| - "scopes": [
|
| - "https://www.googleapis.com/auth/adexchange.buyer"
|
| - ]
|
| - },
|
| - "stopWatching": {
|
| - "description": "Stops watching a creative. Will stop push notifications being sent to the\ntopics when the creative changes status.",
|
| - "httpMethod": "POST",
|
| - "id": "adexchangebuyer2.accounts.creatives.stopWatching",
|
| - "parameterOrder": [
|
| - "accountId",
|
| - "creativeId"
|
| + "accountId",
|
| + "filterSetId"
|
| ],
|
| "parameters": {
|
| "accountId": {
|
| - "description": "The account of the creative to stop notifications for.",
|
| + "description": "Account ID of the buyer.",
|
| + "format": "int64",
|
| "location": "path",
|
| "required": true,
|
| "type": "string"
|
| },
|
| - "creativeId": {
|
| - "description": "The creative ID of the creative to stop notifications for.\nSpecify \"-\" to specify stopping account level notifications.",
|
| + "filterSetId": {
|
| + "description": "The ID of the filter set to delete.",
|
| + "format": "int64",
|
| "location": "path",
|
| "required": true,
|
| "type": "string"
|
| }
|
| },
|
| - "path": "v2beta1/accounts/{accountId}/creatives/{creativeId}:stopWatching",
|
| - "request": {
|
| - "$ref": "StopWatchingCreativeRequest"
|
| - },
|
| + "path": "v2beta1/accounts/{accountId}/filterSets/{filterSetId}",
|
| "response": {
|
| "$ref": "Empty"
|
| },
|
| @@ -1260,136 +860,100 @@
|
| "https://www.googleapis.com/auth/adexchange.buyer"
|
| ]
|
| },
|
| - "get": {
|
| - "description": "Gets a creative.",
|
| + "list": {
|
| + "description": "Lists all filter sets for the account with the given account ID.",
|
| "httpMethod": "GET",
|
| - "id": "adexchangebuyer2.accounts.creatives.get",
|
| + "id": "adexchangebuyer2.accounts.filterSets.list",
|
| "parameterOrder": [
|
| - "accountId",
|
| - "creativeId"
|
| + "accountId"
|
| ],
|
| "parameters": {
|
| - "accountId": {
|
| - "description": "The account the creative belongs to.",
|
| - "location": "path",
|
| - "required": true,
|
| + "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.",
|
| + "location": "query",
|
| "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"
|
| - ]
|
| - },
|
| - "watch": {
|
| - "description": "Watches a creative. Will result in push notifications being sent to the\ntopic when the creative changes status.",
|
| - "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"
|
| + "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"
|
| },
|
| - "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.",
|
| + "accountId": {
|
| + "description": "Account ID of the buyer.",
|
| + "format": "int64",
|
| "location": "path",
|
| "required": true,
|
| "type": "string"
|
| }
|
| },
|
| - "path": "v2beta1/accounts/{accountId}/creatives/{creativeId}:watch",
|
| - "request": {
|
| - "$ref": "WatchCreativeRequest"
|
| - },
|
| + "path": "v2beta1/accounts/{accountId}/filterSets",
|
| "response": {
|
| - "$ref": "Empty"
|
| + "$ref": "ListFilterSetsResponse"
|
| },
|
| "scopes": [
|
| "https://www.googleapis.com/auth/adexchange.buyer"
|
| ]
|
| },
|
| - "update": {
|
| - "description": "Updates a creative.",
|
| - "httpMethod": "PUT",
|
| - "id": "adexchangebuyer2.accounts.creatives.update",
|
| + "get": {
|
| + "description": "Retrieves the requested filter set for the account with the given account\nID.",
|
| + "httpMethod": "GET",
|
| + "id": "adexchangebuyer2.accounts.filterSets.get",
|
| "parameterOrder": [
|
| "accountId",
|
| - "creativeId"
|
| + "filterSetId"
|
| ],
|
| "parameters": {
|
| - "creativeId": {
|
| - "description": "The buyer-defined creative ID of this creative.\nCan be used to filter the response of the\ncreatives.list\nmethod.",
|
| + "filterSetId": {
|
| + "description": "The ID of the filter set to get.",
|
| + "format": "int64",
|
| "location": "path",
|
| "required": true,
|
| "type": "string"
|
| },
|
| "accountId": {
|
| - "description": "The account that this creative belongs to.\nCan be used to filter the response of the\ncreatives.list\nmethod.",
|
| + "description": "Account ID of the buyer.",
|
| + "format": "int64",
|
| "location": "path",
|
| "required": true,
|
| "type": "string"
|
| }
|
| },
|
| - "path": "v2beta1/accounts/{accountId}/creatives/{creativeId}",
|
| - "request": {
|
| - "$ref": "Creative"
|
| - },
|
| + "path": "v2beta1/accounts/{accountId}/filterSets/{filterSetId}",
|
| "response": {
|
| - "$ref": "Creative"
|
| + "$ref": "FilterSet"
|
| },
|
| "scopes": [
|
| "https://www.googleapis.com/auth/adexchange.buyer"
|
| ]
|
| },
|
| - "list": {
|
| - "description": "Lists creatives.",
|
| - "httpMethod": "GET",
|
| - "id": "adexchangebuyer2.accounts.creatives.list",
|
| + "create": {
|
| + "description": "Creates the specified filter set for the account with the given account ID.",
|
| + "httpMethod": "POST",
|
| + "id": "adexchangebuyer2.accounts.filterSets.create",
|
| "parameterOrder": [
|
| "accountId"
|
| ],
|
| "parameters": {
|
| - "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.",
|
| + "isTransient": {
|
| + "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": "string"
|
| + "type": "boolean"
|
| },
|
| "accountId": {
|
| - "description": "The account to list the creatives from.\nSpecify \"-\" to list all creatives the current user has access to.",
|
| + "description": "Account ID of the buyer.",
|
| + "format": "int64",
|
| "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"
|
| - },
|
| - "query": {
|
| - "description": "An optional query string to filter creatives. If no filter is specified,\nall active creatives will be returned.\nSupported queries are:\n<ul>\n<li>accountId=<i>account_id_string</i>\n<li>creativeId=<i>creative_id_string</i>\n<li>dealsStatus: {approved, conditionally_approved, disapproved,\n not_checked}\n<li>openAuctionStatus: {approved, conditionally_approved, disapproved,\n not_checked}\n<li>attribute: {a numeric attribute from the list of attributes}\n<li>disapprovalReason: {a reason from DisapprovalReason\n</ul>\nExample: 'accountId=12345 AND (dealsStatus:disapproved AND disapprovalReason:unacceptable_content) OR attribute:47'",
|
| - "location": "query",
|
| - "type": "string"
|
| }
|
| },
|
| - "path": "v2beta1/accounts/{accountId}/creatives",
|
| + "path": "v2beta1/accounts/{accountId}/filterSets",
|
| + "request": {
|
| + "$ref": "FilterSet"
|
| + },
|
| "response": {
|
| - "$ref": "ListCreativesResponse"
|
| + "$ref": "FilterSet"
|
| },
|
| "scopes": [
|
| "https://www.googleapis.com/auth/adexchange.buyer"
|
| @@ -1397,115 +961,487 @@
|
| }
|
| },
|
| "resources": {
|
| - "dealAssociations": {
|
| + "filteredBidRequests": {
|
| "methods": {
|
| - "add": {
|
| - "description": "Associate an existing deal with a creative.",
|
| - "httpMethod": "POST",
|
| - "id": "adexchangebuyer2.accounts.creatives.dealAssociations.add",
|
| + "list": {
|
| + "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.",
|
| + "httpMethod": "GET",
|
| + "id": "adexchangebuyer2.accounts.filterSets.filteredBidRequests.list",
|
| "parameterOrder": [
|
| "accountId",
|
| - "creativeId"
|
| + "filterSetId"
|
| ],
|
| "parameters": {
|
| - "accountId": {
|
| - "description": "The account the creative belongs to.",
|
| + "filterSetId": {
|
| + "description": "The ID of the filter set to apply.",
|
| + "format": "int64",
|
| "location": "path",
|
| "required": true,
|
| "type": "string"
|
| },
|
| - "creativeId": {
|
| - "description": "The ID of the creative associated with the deal.",
|
| + "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\naccounts.filterSets.filteredBidRequests.list\nmethod.",
|
| + "location": "query",
|
| + "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"
|
| + },
|
| + "accountId": {
|
| + "description": "Account ID of the buyer.",
|
| + "format": "int64",
|
| "location": "path",
|
| "required": true,
|
| "type": "string"
|
| }
|
| },
|
| - "path": "v2beta1/accounts/{accountId}/creatives/{creativeId}/dealAssociations:add",
|
| - "request": {
|
| - "$ref": "AddDealAssociationRequest"
|
| - },
|
| + "path": "v2beta1/accounts/{accountId}/filterSets/{filterSetId}/filteredBidRequests",
|
| "response": {
|
| - "$ref": "Empty"
|
| + "$ref": "ListFilteredBidRequestsResponse"
|
| },
|
| "scopes": [
|
| "https://www.googleapis.com/auth/adexchange.buyer"
|
| ]
|
| - },
|
| - "remove": {
|
| - "description": "Remove the association between a deal and a creative.",
|
| - "httpMethod": "POST",
|
| - "id": "adexchangebuyer2.accounts.creatives.dealAssociations.remove",
|
| + }
|
| + }
|
| + },
|
| + "nonBillableWinningBids": {
|
| + "methods": {
|
| + "list": {
|
| + "description": "List all reasons for which winning bids were not billable, with the number\nof bids not billed for each reason.",
|
| + "httpMethod": "GET",
|
| + "id": "adexchangebuyer2.accounts.filterSets.nonBillableWinningBids.list",
|
| "parameterOrder": [
|
| "accountId",
|
| - "creativeId"
|
| + "filterSetId"
|
| ],
|
| "parameters": {
|
| + "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\naccounts.filterSets.nonBillableWinningBids.list\nmethod.",
|
| + "location": "query",
|
| + "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"
|
| + },
|
| "accountId": {
|
| - "description": "The account the creative belongs to.",
|
| + "description": "Account ID of the buyer.",
|
| + "format": "int64",
|
| "location": "path",
|
| "required": true,
|
| "type": "string"
|
| },
|
| - "creativeId": {
|
| - "description": "The ID of the creative associated with the deal.",
|
| + "filterSetId": {
|
| + "description": "The ID of the filter set to apply.",
|
| + "format": "int64",
|
| "location": "path",
|
| "required": true,
|
| "type": "string"
|
| }
|
| },
|
| - "path": "v2beta1/accounts/{accountId}/creatives/{creativeId}/dealAssociations:remove",
|
| - "request": {
|
| - "$ref": "RemoveDealAssociationRequest"
|
| - },
|
| + "path": "v2beta1/accounts/{accountId}/filterSets/{filterSetId}/nonBillableWinningBids",
|
| "response": {
|
| - "$ref": "Empty"
|
| + "$ref": "ListNonBillableWinningBidsResponse"
|
| },
|
| "scopes": [
|
| "https://www.googleapis.com/auth/adexchange.buyer"
|
| ]
|
| - },
|
| + }
|
| + }
|
| + },
|
| + "filteredBids": {
|
| + "methods": {
|
| "list": {
|
| - "description": "List all creative-deal associations.",
|
| + "description": "List all reasons for which bids were filtered, with the number of bids\nfiltered for each reason.",
|
| "httpMethod": "GET",
|
| - "id": "adexchangebuyer2.accounts.creatives.dealAssociations.list",
|
| + "id": "adexchangebuyer2.accounts.filterSets.filteredBids.list",
|
| "parameterOrder": [
|
| "accountId",
|
| - "creativeId"
|
| + "filterSetId"
|
| ],
|
| "parameters": {
|
| - "query": {
|
| - "description": "An optional query string to filter deal associations. If no filter is\nspecified, all associations will be returned.\nSupported queries are:\n<ul>\n<li>accountId=<i>account_id_string</i>\n<li>creativeId=<i>creative_id_string</i>\n<li>dealsId=<i>deals_id_string</i>\n<li>dealsStatus:{approved, conditionally_approved, disapproved,\n not_checked}\n<li>openAuctionStatus:{approved, conditionally_approved, disapproved,\n not_checked}\n</ul>\nExample: 'dealsId=12345 AND dealsStatus:disapproved'",
|
| + "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\naccounts.filterSets.filteredBids.list\nmethod.",
|
| "location": "query",
|
| "type": "string"
|
| },
|
| - "creativeId": {
|
| - "description": "The creative ID to list the associations from.\nSpecify \"-\" to list all creatives under the above account.",
|
| + "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"
|
| + },
|
| + "accountId": {
|
| + "description": "Account ID of the buyer.",
|
| + "format": "int64",
|
| "location": "path",
|
| "required": true,
|
| "type": "string"
|
| },
|
| + "filterSetId": {
|
| + "description": "The ID of the filter set to apply.",
|
| + "format": "int64",
|
| + "location": "path",
|
| + "required": true,
|
| + "type": "string"
|
| + }
|
| + },
|
| + "path": "v2beta1/accounts/{accountId}/filterSets/{filterSetId}/filteredBids",
|
| + "response": {
|
| + "$ref": "ListFilteredBidsResponse"
|
| + },
|
| + "scopes": [
|
| + "https://www.googleapis.com/auth/adexchange.buyer"
|
| + ]
|
| + }
|
| + },
|
| + "resources": {
|
| + "details": {
|
| + "methods": {
|
| + "list": {
|
| + "description": "List all details associated with a specific reason for which bids were\nfiltered, with the number of bids filtered for each detail.",
|
| + "httpMethod": "GET",
|
| + "id": "adexchangebuyer2.accounts.filterSets.filteredBids.details.list",
|
| + "parameterOrder": [
|
| + "accountId",
|
| + "filterSetId",
|
| + "creativeStatusId"
|
| + ],
|
| + "parameters": {
|
| + "filterSetId": {
|
| + "description": "The ID of the filter set to apply.",
|
| + "format": "int64",
|
| + "location": "path",
|
| + "required": true,
|
| + "type": "string"
|
| + },
|
| + "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\naccounts.filterSets.filteredBids.details.list\nmethod.",
|
| + "location": "query",
|
| + "type": "string"
|
| + },
|
| + "creativeStatusId": {
|
| + "description": "The ID of the creative status for which to retrieve a breakdown by detail.\nSee\n[creative-status-codes](https://developers.google.com/ad-exchange/rtb/downloads/creative-status-codes).\nDetails are only available for statuses 14, 15, 17, 18, 19, 86, and 87.",
|
| + "format": "int32",
|
| + "location": "path",
|
| + "required": true,
|
| + "type": "integer"
|
| + },
|
| + "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"
|
| + },
|
| + "accountId": {
|
| + "description": "Account ID of the buyer.",
|
| + "format": "int64",
|
| + "location": "path",
|
| + "required": true,
|
| + "type": "string"
|
| + }
|
| + },
|
| + "path": "v2beta1/accounts/{accountId}/filterSets/{filterSetId}/filteredBids/{creativeStatusId}/details",
|
| + "response": {
|
| + "$ref": "ListCreativeStatusBreakdownByDetailResponse"
|
| + },
|
| + "scopes": [
|
| + "https://www.googleapis.com/auth/adexchange.buyer"
|
| + ]
|
| + }
|
| + }
|
| + },
|
| + "creatives": {
|
| + "methods": {
|
| + "list": {
|
| + "description": "List all creatives associated with a specific reason for which bids were\nfiltered, with the number of bids filtered for each creative.",
|
| + "httpMethod": "GET",
|
| + "id": "adexchangebuyer2.accounts.filterSets.filteredBids.creatives.list",
|
| + "parameterOrder": [
|
| + "accountId",
|
| + "filterSetId",
|
| + "creativeStatusId"
|
| + ],
|
| + "parameters": {
|
| + "filterSetId": {
|
| + "description": "The ID of the filter set to apply.",
|
| + "format": "int64",
|
| + "location": "path",
|
| + "required": true,
|
| + "type": "string"
|
| + },
|
| + "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\naccounts.filterSets.filteredBids.creatives.list\nmethod.",
|
| + "location": "query",
|
| + "type": "string"
|
| + },
|
| + "creativeStatusId": {
|
| + "description": "The ID of the creative status for which to retrieve a breakdown by\ncreative.\nSee\n[creative-status-codes](https://developers.google.com/ad-exchange/rtb/downloads/creative-status-codes).",
|
| + "format": "int32",
|
| + "location": "path",
|
| + "required": true,
|
| + "type": "integer"
|
| + },
|
| + "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"
|
| + },
|
| + "accountId": {
|
| + "description": "Account ID of the buyer.",
|
| + "format": "int64",
|
| + "location": "path",
|
| + "required": true,
|
| + "type": "string"
|
| + }
|
| + },
|
| + "path": "v2beta1/accounts/{accountId}/filterSets/{filterSetId}/filteredBids/{creativeStatusId}/creatives",
|
| + "response": {
|
| + "$ref": "ListCreativeStatusBreakdownByCreativeResponse"
|
| + },
|
| + "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\nbids that lost for each reason.",
|
| + "httpMethod": "GET",
|
| + "id": "adexchangebuyer2.accounts.filterSets.losingBids.list",
|
| + "parameterOrder": [
|
| + "accountId",
|
| + "filterSetId"
|
| + ],
|
| + "parameters": {
|
| "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.",
|
| + "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\naccounts.filterSets.losingBids.list\nmethod.",
|
| "location": "query",
|
| "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"
|
| + },
|
| "accountId": {
|
| - "description": "The account to list the associations from.\nSpecify \"-\" to list all creatives the current user has access to.",
|
| + "description": "Account ID of the buyer.",
|
| + "format": "int64",
|
| "location": "path",
|
| "required": true,
|
| "type": "string"
|
| },
|
| + "filterSetId": {
|
| + "description": "The ID of the filter set to apply.",
|
| + "format": "int64",
|
| + "location": "path",
|
| + "required": true,
|
| + "type": "string"
|
| + }
|
| + },
|
| + "path": "v2beta1/accounts/{accountId}/filterSets/{filterSetId}/losingBids",
|
| + "response": {
|
| + "$ref": "ListLosingBidsResponse"
|
| + },
|
| + "scopes": [
|
| + "https://www.googleapis.com/auth/adexchange.buyer"
|
| + ]
|
| + }
|
| + }
|
| + },
|
| + "impressionMetrics": {
|
| + "methods": {
|
| + "list": {
|
| + "description": "Lists all metrics that are measured in terms of number of impressions.",
|
| + "httpMethod": "GET",
|
| + "id": "adexchangebuyer2.accounts.filterSets.impressionMetrics.list",
|
| + "parameterOrder": [
|
| + "accountId",
|
| + "filterSetId"
|
| + ],
|
| + "parameters": {
|
| + "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\naccounts.filterSets.impressionMetrics.list\nmethod.",
|
| + "location": "query",
|
| + "type": "string"
|
| + },
|
| "pageSize": {
|
| - "description": "Requested page size. Server may return fewer associations than requested.\nIf unspecified, server will pick an appropriate default.",
|
| + "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"
|
| + },
|
| + "accountId": {
|
| + "description": "Account ID of the buyer.",
|
| + "format": "int64",
|
| + "location": "path",
|
| + "required": true,
|
| + "type": "string"
|
| + },
|
| + "filterSetId": {
|
| + "description": "The ID of the filter set to apply.",
|
| + "format": "int64",
|
| + "location": "path",
|
| + "required": true,
|
| + "type": "string"
|
| }
|
| },
|
| - "path": "v2beta1/accounts/{accountId}/creatives/{creativeId}/dealAssociations",
|
| + "path": "v2beta1/accounts/{accountId}/filterSets/{filterSetId}/impressionMetrics",
|
| + "response": {
|
| + "$ref": "ListImpressionMetricsResponse"
|
| + },
|
| + "scopes": [
|
| + "https://www.googleapis.com/auth/adexchange.buyer"
|
| + ]
|
| + }
|
| + }
|
| + },
|
| + "bidMetrics": {
|
| + "methods": {
|
| + "list": {
|
| + "description": "Lists all metrics that are measured in terms of number of bids.",
|
| + "httpMethod": "GET",
|
| + "id": "adexchangebuyer2.accounts.filterSets.bidMetrics.list",
|
| + "parameterOrder": [
|
| + "accountId",
|
| + "filterSetId"
|
| + ],
|
| + "parameters": {
|
| + "pageToken": {
|
| + "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\naccounts.filterSets.bidMetrics.list\nmethod.",
|
| + "location": "query",
|
| + "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"
|
| + },
|
| + "accountId": {
|
| + "description": "Account ID of the buyer.",
|
| + "format": "int64",
|
| + "location": "path",
|
| + "required": true,
|
| + "type": "string"
|
| + },
|
| + "filterSetId": {
|
| + "description": "The ID of the filter set to apply.",
|
| + "format": "int64",
|
| + "location": "path",
|
| + "required": true,
|
| + "type": "string"
|
| + }
|
| + },
|
| + "path": "v2beta1/accounts/{accountId}/filterSets/{filterSetId}/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\nresponses affected for each reason.",
|
| + "httpMethod": "GET",
|
| + "id": "adexchangebuyer2.accounts.filterSets.bidResponseErrors.list",
|
| + "parameterOrder": [
|
| + "accountId",
|
| + "filterSetId"
|
| + ],
|
| + "parameters": {
|
| + "filterSetId": {
|
| + "description": "The ID of the filter set to apply.",
|
| + "format": "int64",
|
| + "location": "path",
|
| + "required": true,
|
| + "type": "string"
|
| + },
|
| + "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\naccounts.filterSets.bidResponseErrors.list\nmethod.",
|
| + "location": "query",
|
| + "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"
|
| + },
|
| + "accountId": {
|
| + "description": "Account ID of the buyer.",
|
| + "format": "int64",
|
| + "location": "path",
|
| + "required": true,
|
| + "type": "string"
|
| + }
|
| + },
|
| + "path": "v2beta1/accounts/{accountId}/filterSets/{filterSetId}/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\napplicable bids, with the number of bid responses affected for each reason.",
|
| + "httpMethod": "GET",
|
| + "id": "adexchangebuyer2.accounts.filterSets.bidResponsesWithoutBids.list",
|
| + "parameterOrder": [
|
| + "accountId",
|
| + "filterSetId"
|
| + ],
|
| + "parameters": {
|
| + "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\naccounts.filterSets.bidResponsesWithoutBids.list\nmethod.",
|
| + "location": "query",
|
| + "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"
|
| + },
|
| + "accountId": {
|
| + "description": "Account ID of the buyer.",
|
| + "format": "int64",
|
| + "location": "path",
|
| + "required": true,
|
| + "type": "string"
|
| + },
|
| + "filterSetId": {
|
| + "description": "The ID of the filter set to apply.",
|
| + "format": "int64",
|
| + "location": "path",
|
| + "required": true,
|
| + "type": "string"
|
| + }
|
| + },
|
| + "path": "v2beta1/accounts/{accountId}/filterSets/{filterSetId}/bidResponsesWithoutBids",
|
| "response": {
|
| - "$ref": "ListDealAssociationsResponse"
|
| + "$ref": "ListBidResponsesWithoutBidsResponse"
|
| },
|
| "scopes": [
|
| "https://www.googleapis.com/auth/adexchange.buyer"
|
| @@ -1518,9 +1454,20 @@
|
| }
|
| }
|
| },
|
| - "revision": "20170623",
|
| + "revision": "20170720",
|
| "rootUrl": "https://adexchangebuyer.googleapis.com/",
|
| "schemas": {
|
| + "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"
|
| + },
|
| "WatchCreativeRequest": {
|
| "description": "A request for watching changes to creative Status.",
|
| "id": "WatchCreativeRequest",
|
| @@ -1553,6 +1500,10 @@
|
| "description": "The number of filtered bids with the specified dimension values that have the\nspecified creative.",
|
| "id": "FilteredBidCreativeRow",
|
| "properties": {
|
| + "rowDimensions": {
|
| + "$ref": "RowDimensions",
|
| + "description": "The values of all dimensions associated with metric values in this row."
|
| + },
|
| "bidCount": {
|
| "$ref": "MetricValue",
|
| "description": "The number of bids with the specified creative."
|
| @@ -1560,10 +1511,6 @@
|
| "creativeId": {
|
| "description": "The ID of the creative.",
|
| "type": "string"
|
| - },
|
| - "rowDimensions": {
|
| - "$ref": "RowDimensions",
|
| - "description": "The values of all dimensions associated with metric values in this row."
|
| }
|
| },
|
| "type": "object"
|
| @@ -1589,6 +1536,14 @@
|
| "description": "Native content for a creative.",
|
| "id": "NativeContent",
|
| "properties": {
|
| + "headline": {
|
| + "description": "A short title for the ad.",
|
| + "type": "string"
|
| + },
|
| + "appIcon": {
|
| + "$ref": "Image",
|
| + "description": "The app icon, for app download ads."
|
| + },
|
| "callToAction": {
|
| "description": "A label for the button that the user is supposed to click.",
|
| "type": "string"
|
| @@ -1618,14 +1573,14 @@
|
| "description": "The price of the promoted app including currency info.",
|
| "type": "string"
|
| },
|
| - "image": {
|
| - "$ref": "Image",
|
| - "description": "A large image."
|
| - },
|
| "clickTrackingUrl": {
|
| "description": "The URL to use for click tracking.",
|
| "type": "string"
|
| },
|
| + "image": {
|
| + "$ref": "Image",
|
| + "description": "A large image."
|
| + },
|
| "advertiserName": {
|
| "description": "The name of the advertiser or sponsor, to be displayed in the ad creative.",
|
| "type": "string"
|
| @@ -1633,14 +1588,6 @@
|
| "storeUrl": {
|
| "description": "The URL to the app store to purchase/download the promoted app.",
|
| "type": "string"
|
| - },
|
| - "headline": {
|
| - "description": "A short title for the ad.",
|
| - "type": "string"
|
| - },
|
| - "appIcon": {
|
| - "$ref": "Image",
|
| - "description": "The app icon, for app download ads."
|
| }
|
| },
|
| "type": "object"
|
| @@ -1666,16 +1613,16 @@
|
| "description": "Response message for listing all reasons that bid responses were considered\nto have no applicable bids.",
|
| "id": "ListBidResponsesWithoutBidsResponse",
|
| "properties": {
|
| + "nextPageToken": {
|
| + "description": "A token to retrieve the next page of results.\nPass this value in the\nListBidResponsesWithoutBidsRequest.pageToken\nfield in the subsequent call to the\naccounts.filterSets.bidResponsesWithoutBids.list\nmethod to retrieve the next page of results.",
|
| + "type": "string"
|
| + },
|
| "bidResponseWithoutBidsStatusRows": {
|
| "description": "List of rows, with counts of bid responses without bids aggregated by\nstatus.",
|
| "items": {
|
| "$ref": "BidResponseWithoutBidsStatusRow"
|
| },
|
| "type": "array"
|
| - },
|
| - "nextPageToken": {
|
| - "description": "A token to retrieve the next page of results.\nPass this value in the\nListBidResponsesWithoutBidsRequest.pageToken\nfield in the subsequent call to the\naccounts.filterSets.bidResponsesWithoutBids.list\nmethod to retrieve the next page of results.",
|
| - "type": "string"
|
| }
|
| },
|
| "type": "object"
|
| @@ -1721,11 +1668,6 @@
|
| "description": "An image resource. You may provide a larger image than was requested,\nso long as the aspect ratio is preserved.",
|
| "id": "Image",
|
| "properties": {
|
| - "height": {
|
| - "description": "Image height in pixels.",
|
| - "format": "int32",
|
| - "type": "integer"
|
| - },
|
| "width": {
|
| "description": "Image width in pixels.",
|
| "format": "int32",
|
| @@ -1734,6 +1676,11 @@
|
| "url": {
|
| "description": "The URL of the image.",
|
| "type": "string"
|
| + },
|
| + "height": {
|
| + "description": "Image height in pixels.",
|
| + "format": "int32",
|
| + "type": "integer"
|
| }
|
| },
|
| "type": "object"
|
| @@ -1760,6 +1707,10 @@
|
| "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": {
|
| + "rowDimensions": {
|
| + "$ref": "RowDimensions",
|
| + "description": "The values of all dimensions associated with metric values in this row."
|
| + },
|
| "impressionCount": {
|
| "$ref": "MetricValue",
|
| "description": "The number of impressions for which there was a bid response with the\nspecified status."
|
| @@ -1779,10 +1730,6 @@
|
| "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"
|
| - },
|
| - "rowDimensions": {
|
| - "$ref": "RowDimensions",
|
| - "description": "The values of all dimensions associated with metric values in this row."
|
| }
|
| },
|
| "type": "object"
|
| @@ -1808,19 +1755,38 @@
|
| },
|
| "type": "object"
|
| },
|
| - "ListClientUserInvitationsResponse": {
|
| - "id": "ListClientUserInvitationsResponse",
|
| + "ListCreativeStatusBreakdownByDetailResponse": {
|
| + "description": "Response message for listing all details associated with a given filtered bid\nreason.",
|
| + "id": "ListCreativeStatusBreakdownByDetailResponse",
|
| "properties": {
|
| "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\nListCreativeStatusBreakdownByDetailRequest.pageToken\nfield in the subsequent call to the\naccounts.filterSets.filteredBids.details.list\nmethod to retrieve the next page of results.",
|
| "type": "string"
|
| },
|
| - "invitations": {
|
| - "description": "The returned list of client users.",
|
| + "filteredBidDetailRows": {
|
| + "description": "List of rows, with counts of bids with a given creative status aggregated\nby detail.",
|
| "items": {
|
| - "$ref": "ClientUserInvitation"
|
| + "$ref": "FilteredBidDetailRow"
|
| },
|
| "type": "array"
|
| + },
|
| + "detailType": {
|
| + "description": "The type of detail that the detail IDs represent.",
|
| + "enum": [
|
| + "DETAIL_TYPE_UNSPECIFIED",
|
| + "CREATIVE_ATTRIBUTE",
|
| + "VENDOR",
|
| + "SENSITIVE_CATEGORY",
|
| + "PRODUCT_CATEGORY"
|
| + ],
|
| + "enumDescriptions": [
|
| + "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/ad-exchange/rtb/downloads/publisher-excludable-creative-attributes).",
|
| + "Indicates that the detail ID refers to a vendor; see\n[vendors](https://developers.google.com/ad-exchange/rtb/downloads/vendors).",
|
| + "Indicates that the detail ID refers to a sensitive category; see\n[ad-sensitive-categories](https://developers.google.com/ad-exchange/rtb/downloads/ad-sensitive-categories).",
|
| + "Indicates that the detail ID refers to a product category; see\n[ad-product-categories](https://developers.google.com/ad-exchange/rtb/downloads/ad-product-categories)."
|
| + ],
|
| + "type": "string"
|
| }
|
| },
|
| "type": "object"
|
| @@ -1842,38 +1808,19 @@
|
| },
|
| "type": "object"
|
| },
|
| - "ListCreativeStatusBreakdownByDetailResponse": {
|
| - "description": "Response message for listing all details associated with a given filtered bid\nreason.",
|
| - "id": "ListCreativeStatusBreakdownByDetailResponse",
|
| + "ListClientUserInvitationsResponse": {
|
| + "id": "ListClientUserInvitationsResponse",
|
| "properties": {
|
| - "filteredBidDetailRows": {
|
| - "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\naccounts.filterSets.filteredBids.details.list\nmethod to retrieve the next page of results.",
|
| + "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.",
|
| "type": "string"
|
| },
|
| - "detailType": {
|
| - "description": "The type of detail that the detail IDs represent.",
|
| - "enum": [
|
| - "TYPE_UNSPECIFIED",
|
| - "CREATIVE_ATTRIBUTE",
|
| - "VENDOR",
|
| - "SENSITIVE_CATEGORY",
|
| - "PRODUCT_CATEGORY"
|
| - ],
|
| - "enumDescriptions": [
|
| - "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/ad-exchange/rtb/downloads/publisher-excludable-creative-attributes).",
|
| - "Indicates that the detail ID refers to a vendor; see\n[vendors](https://developers.google.com/ad-exchange/rtb/downloads/vendors).",
|
| - "Indicates that the detail ID refers to a sensitive category; see\n[ad-sensitive-categories](https://developers.google.com/ad-exchange/rtb/downloads/ad-sensitive-categories).",
|
| - "Indicates that the detail ID refers to a product category; see\n[ad-product-categories](https://developers.google.com/ad-exchange/rtb/downloads/ad-product-categories)."
|
| - ],
|
| - "type": "string"
|
| + "invitations": {
|
| + "description": "The returned list of client users.",
|
| + "items": {
|
| + "$ref": "ClientUserInvitation"
|
| + },
|
| + "type": "array"
|
| }
|
| },
|
| "type": "object"
|
| @@ -1938,11 +1885,6 @@
|
| "description": "A client user is created under a client buyer and has restricted access to\nthe Ad Exchange Marketplace and certain other sections\nof the Ad Exchange Buyer UI based on the role\ngranted 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"
|
| - },
|
| "status": {
|
| "description": "The status of the client user.",
|
| "enum": [
|
| @@ -1959,13 +1901,18 @@
|
| ],
|
| "type": "string"
|
| },
|
| + "email": {
|
| + "description": "User's email address. The value of this field\nis ignored in an update operation.",
|
| + "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"
|
| },
|
| - "email": {
|
| - "description": "User's email address. The value of this field\nis ignored in an update operation.",
|
| + "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"
|
| }
|
| },
|
| @@ -1990,32 +1937,10 @@
|
| },
|
| "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.",
|
| - "items": {
|
| - "$ref": "Reason"
|
| - },
|
| - "type": "array"
|
| - }
|
| - },
|
| - "type": "object"
|
| - },
|
| "Creative": {
|
| "description": "A creative and its classification data.",
|
| "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"
|
| - },
|
| "native": {
|
| "$ref": "NativeContent",
|
| "description": "A native creative."
|
| @@ -2149,17 +2074,17 @@
|
| "description": "The name of the company being advertised in the creative.",
|
| "type": "string"
|
| },
|
| - "detectedAdvertiserIds": {
|
| - "description": "@OutputOnly Detected advertiser IDs, if any.",
|
| + "detectedDomains": {
|
| + "description": "@OutputOnly\nThe detected domains for this creative.",
|
| "items": {
|
| - "format": "int64",
|
| "type": "string"
|
| },
|
| "type": "array"
|
| },
|
| - "detectedDomains": {
|
| - "description": "@OutputOnly\nThe detected domains for this creative.",
|
| + "detectedAdvertiserIds": {
|
| + "description": "@OutputOnly Detected advertiser IDs, if any.",
|
| "items": {
|
| + "format": "int64",
|
| "type": "string"
|
| },
|
| "type": "array"
|
| @@ -2242,6 +2167,28 @@
|
| "creativeId": {
|
| "description": "The buyer-defined creative ID of this creative.\nCan be used to filter the response of the\ncreatives.list\nmethod.",
|
| "type": "string"
|
| + },
|
| + "accountId": {
|
| + "description": "The account that this creative belongs to.\nCan be used to filter the response of the\ncreatives.list\nmethod.",
|
| + "type": "string"
|
| + }
|
| + },
|
| + "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": {
|
| + "reasons": {
|
| + "description": "The set of filtering reasons for this date.",
|
| + "items": {
|
| + "$ref": "Reason"
|
| + },
|
| + "type": "array"
|
| + },
|
| + "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."
|
| }
|
| },
|
| "type": "object"
|
| @@ -2261,16 +2208,16 @@
|
| "description": "Response message for listing all creatives associated with a given filtered\nbid reason.",
|
| "id": "ListCreativeStatusBreakdownByCreativeResponse",
|
| "properties": {
|
| + "nextPageToken": {
|
| + "description": "A token to retrieve the next page of results.\nPass this value in the\nListCreativeStatusBreakdownByCreativeRequest.pageToken\nfield in the subsequent call to the\naccounts.filterSets.filteredBids.creatives.list\nmethod to retrieve the next page of results.",
|
| + "type": "string"
|
| + },
|
| "filteredBidCreativeRows": {
|
| "description": "List of rows, with counts of bids with a given creative status aggregated\nby creative.",
|
| "items": {
|
| "$ref": "FilteredBidCreativeRow"
|
| },
|
| "type": "array"
|
| - },
|
| - "nextPageToken": {
|
| - "description": "A token to retrieve the next page of results.\nPass this value in the\nListCreativeStatusBreakdownByCreativeRequest.pageToken\nfield in the subsequent call to the\naccounts.filterSets.filteredBids.creatives.list\nmethod to retrieve the next page of results.",
|
| - "type": "string"
|
| }
|
| },
|
| "type": "object"
|
| @@ -2279,6 +2226,26 @@
|
| "description": "A client resource represents a client buyer—an agency,\na brand, or an advertiser customer of the sponsor buyer.\nUsers associated with the client buyer have restricted access to\nthe Ad Exchange Marketplace and certain other sections\nof the Ad Exchange Buyer UI based on the role\ngranted to the client buyer.\nAll fields are required unless otherwise specified.",
|
| "id": "Client",
|
| "properties": {
|
| + "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"
|
| + },
|
| + "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"
|
| + },
|
| "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": [
|
| @@ -2326,26 +2293,6 @@
|
| "A client that is currently active."
|
| ],
|
| "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"
|
| - },
|
| - "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"
|
| }
|
| },
|
| "type": "object"
|
| @@ -2354,6 +2301,13 @@
|
| "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": {
|
| @@ -2392,13 +2346,6 @@
|
| "The ad contains video content."
|
| ],
|
| "type": "string"
|
| - },
|
| - "contexts": {
|
| - "description": "The contexts for the correction.",
|
| - "items": {
|
| - "$ref": "ServingContext"
|
| - },
|
| - "type": "array"
|
| }
|
| },
|
| "type": "object"
|
| @@ -2420,15 +2367,15 @@
|
| "format": "int64",
|
| "type": "string"
|
| },
|
| - "absoluteDateRange": {
|
| - "$ref": "AbsoluteDateRange",
|
| - "description": "An absolute date range, defined by a start date and an end date.\nInterpreted relative to Pacific time zone."
|
| - },
|
| "buyerAccountId": {
|
| "description": "The ID of the buyer account on which to filter; optional.",
|
| "format": "int64",
|
| "type": "string"
|
| },
|
| + "absoluteDateRange": {
|
| + "$ref": "AbsoluteDateRange",
|
| + "description": "An absolute date range, defined by a start date and an end date.\nInterpreted relative to Pacific time zone."
|
| + },
|
| "environment": {
|
| "description": "The environment on which to filter; optional.",
|
| "enum": [
|
| @@ -2443,11 +2390,6 @@
|
| ],
|
| "type": "string"
|
| },
|
| - "dealId": {
|
| - "description": "The ID of the deal on which to filter; optional.",
|
| - "format": "int64",
|
| - "type": "string"
|
| - },
|
| "format": {
|
| "description": "The format on which to filter; optional.",
|
| "enum": [
|
| @@ -2462,10 +2404,15 @@
|
| ],
|
| "type": "string"
|
| },
|
| + "dealId": {
|
| + "description": "The ID of the deal on which to filter; optional.",
|
| + "format": "int64",
|
| + "type": "string"
|
| + },
|
| "timeSeriesGranularity": {
|
| "description": "The granularity of time intervals if a time series breakdown is desired;\noptional.",
|
| "enum": [
|
| - "INTERVAL_UNSPECIFIED",
|
| + "TIME_SERIES_GRANULARITY_UNSPECIFIED",
|
| "HOURLY",
|
| "DAILY"
|
| ],
|
| @@ -2489,10 +2436,6 @@
|
| "description": "The ID of the creative on which to filter; optional.",
|
| "type": "string"
|
| },
|
| - "relativeDateRange": {
|
| - "$ref": "RelativeDateRange",
|
| - "description": "A relative date range, defined by an offset from today and a duration.\nInterpreted relative to Pacific time zone."
|
| - },
|
| "platforms": {
|
| "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).",
|
| "enumDescriptions": [
|
| @@ -2511,6 +2454,10 @@
|
| "type": "string"
|
| },
|
| "type": "array"
|
| + },
|
| + "relativeDateRange": {
|
| + "$ref": "RelativeDateRange",
|
| + "description": "A relative date range, defined by an offset from today and a duration.\nInterpreted relative to Pacific time zone."
|
| }
|
| },
|
| "type": "object"
|
| @@ -2537,6 +2484,10 @@
|
| "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": {
|
| + "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."
|
| @@ -2545,10 +2496,6 @@
|
| "description": "The ID of the callout status.\nSee [callout-status-codes](https://developers.google.com/ad-exchange/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."
|
| }
|
| },
|
| "type": "object"
|
| @@ -2773,6 +2720,13 @@
|
| "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.",
|
| + "items": {
|
| + "$ref": "ServingContext"
|
| + },
|
| + "type": "array"
|
| + },
|
| "status": {
|
| "description": "The status of the creative in this context (for example, it has been\nexplicitly disapproved or is pending review).",
|
| "enum": [
|
| @@ -2793,13 +2747,6 @@
|
| "$ref": "Disapproval"
|
| },
|
| "type": "array"
|
| - },
|
| - "contexts": {
|
| - "description": "The contexts for the restriction.",
|
| - "items": {
|
| - "$ref": "ServingContext"
|
| - },
|
| - "type": "array"
|
| }
|
| },
|
| "type": "object"
|
| @@ -2808,13 +2755,13 @@
|
| "description": "Represents a whole calendar date, e.g. date of birth. The time of day and\ntime zone are either specified elsewhere or are not significant. The date\nis relative to the Proleptic Gregorian Calendar. The day may be 0 to\nrepresent a year and month where the day is not significant, e.g. credit card\nexpiration date. The year may be 0 to represent a month and day independent\nof year, e.g. anniversary date. Related types are google.type.TimeOfDay\nand `google.protobuf.Timestamp`.",
|
| "id": "Date",
|
| "properties": {
|
| - "year": {
|
| - "description": "Year of date. Must be from 1 to 9999, or 0 if specifying a date without\na year.",
|
| + "day": {
|
| + "description": "Day of month. Must be from 1 to 31 and valid for the year and month, or 0\nif specifying a year/month where the day is not significant.",
|
| "format": "int32",
|
| "type": "integer"
|
| },
|
| - "day": {
|
| - "description": "Day of month. Must be from 1 to 31 and valid for the year and month, or 0\nif specifying a year/month where the day is not significant.",
|
| + "year": {
|
| + "description": "Year of date. Must be from 1 to 9999, or 0 if specifying a date without\na year.",
|
| "format": "int32",
|
| "type": "integer"
|
| },
|
| @@ -2843,42 +2790,6 @@
|
| "properties": {},
|
| "type": "object"
|
| },
|
| - "ListCreativeStatusAndCreativeBreakdownByDetailResponse": {
|
| - "description": "Response message for listing all details associated with a given filtered bid\nreason and a given creative.",
|
| - "id": "ListCreativeStatusAndCreativeBreakdownByDetailResponse",
|
| - "properties": {
|
| - "detailType": {
|
| - "description": "The type of detail that the detail IDs represent.",
|
| - "enum": [
|
| - "TYPE_UNSPECIFIED",
|
| - "CREATIVE_ATTRIBUTE",
|
| - "VENDOR",
|
| - "SENSITIVE_CATEGORY",
|
| - "PRODUCT_CATEGORY"
|
| - ],
|
| - "enumDescriptions": [
|
| - "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/ad-exchange/rtb/downloads/publisher-excludable-creative-attributes).",
|
| - "Indicates that the detail ID refers to a vendor; see\n[vendors](https://developers.google.com/ad-exchange/rtb/downloads/vendors).",
|
| - "Indicates that the detail ID refers to a sensitive category; see\n[ad-sensitive-categories](https://developers.google.com/ad-exchange/rtb/downloads/ad-sensitive-categories).",
|
| - "Indicates that the detail ID refers to a product category; see\n[ad-product-categories](https://developers.google.com/ad-exchange/rtb/downloads/ad-product-categories)."
|
| - ],
|
| - "type": "string"
|
| - },
|
| - "filteredBidDetailRows": {
|
| - "description": "List of rows, with counts of bids with a given creative status and\ncreative, aggregated by detail.",
|
| - "items": {
|
| - "$ref": "FilteredBidDetailRow"
|
| - },
|
| - "type": "array"
|
| - },
|
| - "nextPageToken": {
|
| - "description": "A token to retrieve the next page of results.\nPass this value in the\nListCreativeStatusAndCreativeBreakdownByDetailRequest.pageToken\nfield in the subsequent call to the\naccounts.filterSets.filteredBids.creatives.details.list\nmethod to retrieve the next page of results.",
|
| - "type": "string"
|
| - }
|
| - },
|
| - "type": "object"
|
| - },
|
| "AppContext": {
|
| "description": "@OutputOnly The app type the restriction applies to for mobile device.",
|
| "id": "AppContext",
|
| @@ -2941,22 +2852,19 @@
|
| },
|
| "type": "object"
|
| },
|
| - "HtmlContent": {
|
| - "description": "HTML content for a creative.",
|
| - "id": "HtmlContent",
|
| + "ListFilteredBidRequestsResponse": {
|
| + "description": "Response message for listing all reasons that bid requests were filtered and\nnot sent to the buyer.",
|
| + "id": "ListFilteredBidRequestsResponse",
|
| "properties": {
|
| - "height": {
|
| - "description": "The height of the HTML snippet in pixels.",
|
| - "format": "int32",
|
| - "type": "integer"
|
| - },
|
| - "width": {
|
| - "description": "The width of the HTML snippet in pixels.",
|
| - "format": "int32",
|
| - "type": "integer"
|
| + "calloutStatusRows": {
|
| + "description": "List of rows, with counts of filtered bid requests aggregated by callout\nstatus.",
|
| + "items": {
|
| + "$ref": "CalloutStatusRow"
|
| + },
|
| + "type": "array"
|
| },
|
| - "snippet": {
|
| - "description": "The HTML snippet that displays the ad when inserted in the web page.",
|
| + "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\naccounts.filterSets.filteredBidRequests.list\nmethod to retrieve the next page of results.",
|
| "type": "string"
|
| }
|
| },
|
| @@ -2966,34 +2874,37 @@
|
| "description": "A response for listing creatives.",
|
| "id": "ListCreativesResponse",
|
| "properties": {
|
| + "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"
|
| + },
|
| "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"
|
| },
|
| - "ListFilteredBidRequestsResponse": {
|
| - "description": "Response message for listing all reasons that bid requests were filtered and\nnot sent to the buyer.",
|
| - "id": "ListFilteredBidRequestsResponse",
|
| + "HtmlContent": {
|
| + "description": "HTML content for a creative.",
|
| + "id": "HtmlContent",
|
| "properties": {
|
| - "calloutStatusRows": {
|
| - "description": "List of rows, with counts of filtered bid requests aggregated by callout\nstatus.",
|
| - "items": {
|
| - "$ref": "CalloutStatusRow"
|
| - },
|
| - "type": "array"
|
| + "width": {
|
| + "description": "The width of the HTML snippet in pixels.",
|
| + "format": "int32",
|
| + "type": "integer"
|
| },
|
| - "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\naccounts.filterSets.filteredBidRequests.list\nmethod to retrieve the next page of results.",
|
| + "snippet": {
|
| + "description": "The HTML snippet that displays the ad when inserted in the web page.",
|
| "type": "string"
|
| + },
|
| + "height": {
|
| + "description": "The height of the HTML snippet in pixels.",
|
| + "format": "int32",
|
| + "type": "integer"
|
| }
|
| },
|
| "type": "object"
|
| @@ -3002,16 +2913,16 @@
|
| "description": "Response message for listing the metrics that are measured in number of bids.",
|
| "id": "ListBidMetricsResponse",
|
| "properties": {
|
| + "nextPageToken": {
|
| + "description": "A token to retrieve the next page of results.\nPass this value in the\nListBidMetricsRequest.pageToken\nfield in the subsequent call to the\naccounts.filterSets.bidMetrics.list\nmethod to retrieve the next page of results.",
|
| + "type": "string"
|
| + },
|
| "bidMetricsRows": {
|
| "description": "List of rows, each containing a set of bid metrics.",
|
| "items": {
|
| "$ref": "BidMetricsRow"
|
| },
|
| "type": "array"
|
| - },
|
| - "nextPageToken": {
|
| - "description": "A token to retrieve the next page of results.\nPass this value in the\nListBidMetricsRequest.pageToken\nfield in the subsequent call to the\naccounts.filterSets.bidMetrics.list\nmethod to retrieve the next page of results.",
|
| - "type": "string"
|
| }
|
| },
|
| "type": "object"
|
| @@ -3020,15 +2931,15 @@
|
| "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.",
|
| "format": "int32",
|
| "type": "integer"
|
| + },
|
| + "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"
|
| }
|
| },
|
| "type": "object"
|
| @@ -3048,16 +2959,16 @@
|
| "description": "Response message for listing all reasons that bids lost in the auction.",
|
| "id": "ListLosingBidsResponse",
|
| "properties": {
|
| + "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\naccounts.filterSets.losingBids.list\nmethod to retrieve the next page of results.",
|
| + "type": "string"
|
| + },
|
| "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\naccounts.filterSets.losingBids.list\nmethod to retrieve the next page of results.",
|
| - "type": "string"
|
| }
|
| },
|
| "type": "object"
|
| @@ -3092,14 +3003,14 @@
|
| "$ref": "MetricValue",
|
| "description": "The number of impressions available to the buyer on Ad Exchange.\nIn some cases this value may be unavailable."
|
| },
|
| - "inventoryMatches": {
|
| - "$ref": "MetricValue",
|
| - "description": "The number of impressions that match the buyer's inventory pretargeting."
|
| - },
|
| "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."
|
| @@ -3155,6 +3066,18 @@
|
| "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": {
|
| + "measurableImpressions": {
|
| + "$ref": "MetricValue",
|
| + "description": "The number of bids for which the corresponding impression was measurable\nfor viewability (as defined by Active View)."
|
| + },
|
| + "bids": {
|
| + "$ref": "MetricValue",
|
| + "description": "The number of bids that Ad Exchange received from the buyer."
|
| + },
|
| + "billedImpressions": {
|
| + "$ref": "MetricValue",
|
| + "description": "The number of bids for which the buyer was billed."
|
| + },
|
| "bidsInAuction": {
|
| "$ref": "MetricValue",
|
| "description": "The number of bids that were permitted to compete in the auction."
|
| @@ -3163,25 +3086,13 @@
|
| "$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)."
|
| - },
|
| "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)."
|
| - },
|
| - "bids": {
|
| - "$ref": "MetricValue",
|
| - "description": "The number of bids that Ad Exchange received from the buyer."
|
| - },
|
| - "billedImpressions": {
|
| + "viewableImpressions": {
|
| "$ref": "MetricValue",
|
| - "description": "The number of bids for which the buyer was billed."
|
| + "description": "The number of bids for which the corresponding impression was viewable (as\ndefined by Active View)."
|
| }
|
| },
|
| "type": "object"
|
| @@ -3190,16 +3101,16 @@
|
| "description": "Response message for listing all reasons that bid responses resulted in an\nerror.",
|
| "id": "ListBidResponseErrorsResponse",
|
| "properties": {
|
| + "nextPageToken": {
|
| + "description": "A token to retrieve the next page of results.\nPass this value in the\nListBidResponseErrorsRequest.pageToken\nfield in the subsequent call to the\naccounts.filterSets.bidResponseErrors.list\nmethod to retrieve the next page of results.",
|
| + "type": "string"
|
| + },
|
| "calloutStatusRows": {
|
| "description": "List of rows, with counts of bid responses aggregated by callout status.",
|
| "items": {
|
| "$ref": "CalloutStatusRow"
|
| },
|
| "type": "array"
|
| - },
|
| - "nextPageToken": {
|
| - "description": "A token to retrieve the next page of results.\nPass this value in the\nListBidResponseErrorsRequest.pageToken\nfield in the subsequent call to the\naccounts.filterSets.bidResponseErrors.list\nmethod to retrieve the next page of results.",
|
| - "type": "string"
|
| }
|
| },
|
| "type": "object"
|
| @@ -3240,6 +3151,10 @@
|
| "description": "The number of winning bids with the specified dimension values for which the\nbuyer was not billed, as described by the specified status.",
|
| "id": "NonBillableWinningBidStatusRow",
|
| "properties": {
|
| + "rowDimensions": {
|
| + "$ref": "RowDimensions",
|
| + "description": "The values of all dimensions associated with metric values in this row."
|
| + },
|
| "bidCount": {
|
| "$ref": "MetricValue",
|
| "description": "The number of bids with the specified status."
|
| @@ -3257,10 +3172,6 @@
|
| "The buyer was not billed because the impression won by the bid was\ndetermined to be invalid."
|
| ],
|
| "type": "string"
|
| - },
|
| - "rowDimensions": {
|
| - "$ref": "RowDimensions",
|
| - "description": "The values of all dimensions associated with metric values in this row."
|
| }
|
| },
|
| "type": "object"
|
| @@ -3269,18 +3180,18 @@
|
| "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."
|
| + "rowDimensions": {
|
| + "$ref": "RowDimensions",
|
| + "description": "The values of all dimensions associated with metric values in this row."
|
| },
|
| "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."
|
| + "bidCount": {
|
| + "$ref": "MetricValue",
|
| + "description": "The number of bids with the specified detail."
|
| }
|
| },
|
| "type": "object"
|
| @@ -3299,17 +3210,6 @@
|
| }
|
| },
|
| "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"
|
| }
|
| },
|
| "servicePath": "",
|
|
|
Chromium Code Reviews
Issue 2987103002:
Api-Roll 52: 2017-07-31 (Closed)
