| OLD | NEW |
| 1 { | 1 { |
| 2 "auth": { | 2 "auth": { |
| 3 "oauth2": { | 3 "oauth2": { |
| 4 "scopes": { | 4 "scopes": { |
| 5 "https://www.googleapis.com/auth/adexchange.buyer": { | 5 "https://www.googleapis.com/auth/adexchange.buyer": { |
| 6 "description": "Manage your Ad Exchange buyer account config
uration" | 6 "description": "Manage your Ad Exchange buyer account config
uration" |
| 7 } | 7 } |
| 8 } | 8 } |
| 9 } | 9 } |
| 10 }, | 10 }, |
| 11 "basePath": "", | 11 "basePath": "", |
| 12 "baseUrl": "https://adexchangebuyer.googleapis.com/", | 12 "baseUrl": "https://adexchangebuyer.googleapis.com/", |
| 13 "batchPath": "batch", | 13 "batchPath": "batch", |
| 14 "canonicalName": "AdExchangeBuyerII", | 14 "canonicalName": "AdExchangeBuyerII", |
| 15 "description": "Accesses the latest features for managing Ad Exchange accoun
ts and Real-Time Bidding configurations.", | 15 "description": "Accesses the latest features for managing Ad Exchange accoun
ts and Real-Time Bidding configurations and auction metrics.", |
| 16 "discoveryVersion": "v1", | 16 "discoveryVersion": "v1", |
| 17 "documentationLink": "https://developers.google.com/ad-exchange/buyer-rest/g
uides/client-access/", | 17 "documentationLink": "https://developers.google.com/ad-exchange/buyer-rest/g
uides/client-access/", |
| 18 "icons": { | 18 "icons": { |
| 19 "x16": "http://www.google.com/images/icons/product/search-16.gif", | 19 "x16": "http://www.google.com/images/icons/product/search-16.gif", |
| 20 "x32": "http://www.google.com/images/icons/product/search-32.gif" | 20 "x32": "http://www.google.com/images/icons/product/search-32.gif" |
| 21 }, | 21 }, |
| 22 "id": "adexchangebuyer2:v2beta1", | 22 "id": "adexchangebuyer2:v2beta1", |
| 23 "kind": "discovery#restDescription", | 23 "kind": "discovery#restDescription", |
| 24 "name": "adexchangebuyer2", | 24 "name": "adexchangebuyer2", |
| 25 "ownerDomain": "google.com", | 25 "ownerDomain": "google.com", |
| (...skipping 83 matching lines...) Expand 10 before | Expand all | Expand 10 after Loading... |
| 109 "upload_protocol": { | 109 "upload_protocol": { |
| 110 "description": "Upload protocol for media (e.g. \"raw\", \"multipart
\").", | 110 "description": "Upload protocol for media (e.g. \"raw\", \"multipart
\").", |
| 111 "location": "query", | 111 "location": "query", |
| 112 "type": "string" | 112 "type": "string" |
| 113 } | 113 } |
| 114 }, | 114 }, |
| 115 "protocol": "rest", | 115 "protocol": "rest", |
| 116 "resources": { | 116 "resources": { |
| 117 "accounts": { | 117 "accounts": { |
| 118 "resources": { | 118 "resources": { |
| 119 "clients": { | 119 "filterSets": { |
| 120 "methods": { | 120 "methods": { |
| 121 "update": { | 121 "getBidMetrics": { |
| 122 "description": "Updates an existing client buyer.", | 122 "description": "Gets all metrics that are measured i
n terms of number of bids.", |
| 123 "httpMethod": "PUT", | 123 "httpMethod": "GET", |
| 124 "id": "adexchangebuyer2.accounts.clients.update", | 124 "id": "adexchangebuyer2.accounts.filterSets.getBidMe
trics", |
| 125 "parameterOrder": [ | 125 "parameterOrder": [ |
| 126 "accountId", | 126 "accountId", |
| 127 "clientAccountId" | 127 "filterSetId" |
| 128 ], | 128 ], |
| 129 "parameters": { | 129 "parameters": { |
| 130 "clientAccountId": { | 130 "filterSetId": { |
| 131 "description": "Unique numerical account ID
of the client to update. (required)", | 131 "description": "The ID of the filter set to
apply.", |
| 132 "format": "int64", | 132 "format": "int32", |
| 133 "location": "path", | 133 "location": "path", |
| 134 "required": true, | 134 "required": true, |
| 135 "type": "string" | 135 "type": "integer" |
| 136 }, | 136 }, |
| 137 "accountId": { | 137 "accountId": { |
| 138 "description": "Unique numerical account ID
for the buyer of which the client buyer\nis a customer; the sponsor buyer to upd
ate a client for. (required)", | 138 "description": "Account ID of the buyer.", |
| 139 "format": "int64", | 139 "format": "int64", |
| 140 "location": "path", | 140 "location": "path", |
| 141 "required": true, | 141 "required": true, |
| 142 "type": "string" | 142 "type": "string" |
| 143 } | 143 } |
| 144 }, | 144 }, |
| 145 "path": "v2beta1/accounts/{accountId}/clients/{clien
tAccountId}", | 145 "path": "v2beta1/accounts/{accountId}/filterSets/{fi
lterSetId}/bidMetrics", |
| 146 "request": { | 146 "response": { |
| 147 "$ref": "Client" | 147 "$ref": "BidMetrics" |
| 148 }, | 148 }, |
| 149 "scopes": [ |
| 150 "https://www.googleapis.com/auth/adexchange.buye
r" |
| 151 ] |
| 152 }, |
| 153 "list": { |
| 154 "description": "Lists all filter sets for the accoun
t with the given account ID.", |
| 155 "httpMethod": "GET", |
| 156 "id": "adexchangebuyer2.accounts.filterSets.list", |
| 157 "parameterOrder": [ |
| 158 "accountId" |
| 159 ], |
| 160 "parameters": { |
| 161 "pageSize": { |
| 162 "description": "Requested page size. The ser
ver may return fewer than requested.\nIf unspecified, the server will pick an ap
propriate default.", |
| 163 "format": "int32", |
| 164 "location": "query", |
| 165 "type": "integer" |
| 166 }, |
| 167 "accountId": { |
| 168 "description": "Account ID of the buyer.", |
| 169 "format": "int64", |
| 170 "location": "path", |
| 171 "required": true, |
| 172 "type": "string" |
| 173 }, |
| 174 "pageToken": { |
| 175 "description": "A token identifying a page o
f results the server should return.\nTypically, this is the value of\nListFilter
SetsResponse.nextPageToken\nreturned from the previous call to the\naccounts.rtb
Breakout.filterSets.list method.", |
| 176 "location": "query", |
| 177 "type": "string" |
| 178 } |
| 179 }, |
| 180 "path": "v2beta1/accounts/{accountId}/filterSets", |
| 149 "response": { | 181 "response": { |
| 150 "$ref": "Client" | 182 "$ref": "ListFilterSetsResponse" |
| 151 }, | 183 }, |
| 152 "scopes": [ | 184 "scopes": [ |
| 153 "https://www.googleapis.com/auth/adexchange.buye
r" | 185 "https://www.googleapis.com/auth/adexchange.buye
r" |
| 154 ] | 186 ] |
| 155 }, | 187 }, |
| 156 "get": { | 188 "get": { |
| 157 "description": "Gets a client buyer with a given cli
ent account ID.", | 189 "description": "Retrieves the requested filter set f
or the account with the given account\nID.", |
| 158 "httpMethod": "GET", | 190 "httpMethod": "GET", |
| 159 "id": "adexchangebuyer2.accounts.clients.get", | 191 "id": "adexchangebuyer2.accounts.filterSets.get", |
| 160 "parameterOrder": [ | 192 "parameterOrder": [ |
| 161 "accountId", | 193 "accountId", |
| 162 "clientAccountId" | 194 "filterSetId" |
| 163 ], | 195 ], |
| 164 "parameters": { | 196 "parameters": { |
| 165 "clientAccountId": { | 197 "filterSetId": { |
| 166 "description": "Numerical account ID of the
client buyer to retrieve. (required)", | 198 "description": "The ID of the filter set to
get.", |
| 167 "format": "int64", | 199 "format": "int32", |
| 168 "location": "path", | 200 "location": "path", |
| 169 "required": true, | 201 "required": true, |
| 170 "type": "string" | 202 "type": "integer" |
| 171 }, | 203 }, |
| 172 "accountId": { | 204 "accountId": { |
| 173 "description": "Numerical account ID of the
client's sponsor buyer. (required)", | 205 "description": "Account ID of the buyer.", |
| 174 "format": "int64", | 206 "format": "int64", |
| 175 "location": "path", | 207 "location": "path", |
| 176 "required": true, | 208 "required": true, |
| 177 "type": "string" | 209 "type": "string" |
| 178 } | 210 } |
| 179 }, | 211 }, |
| 180 "path": "v2beta1/accounts/{accountId}/clients/{clien
tAccountId}", | 212 "path": "v2beta1/accounts/{accountId}/filterSets/{fi
lterSetId}", |
| 181 "response": { | 213 "response": { |
| 182 "$ref": "Client" | 214 "$ref": "FilterSet" |
| 183 }, | 215 }, |
| 184 "scopes": [ | 216 "scopes": [ |
| 185 "https://www.googleapis.com/auth/adexchange.buye
r" | 217 "https://www.googleapis.com/auth/adexchange.buye
r" |
| 186 ] | 218 ] |
| 187 }, | 219 }, |
| 188 "create": { | 220 "create": { |
| 189 "description": "Creates a new client buyer.", | 221 "description": "Creates the specified filter set for
the account with the given account ID.", |
| 190 "httpMethod": "POST", | 222 "httpMethod": "POST", |
| 191 "id": "adexchangebuyer2.accounts.clients.create", | 223 "id": "adexchangebuyer2.accounts.filterSets.create", |
| 192 "parameterOrder": [ | 224 "parameterOrder": [ |
| 193 "accountId" | 225 "accountId" |
| 194 ], | 226 ], |
| 195 "parameters": { | 227 "parameters": { |
| 228 "isTransient": { |
| 229 "description": "Whether the filter set is tr
ansient, or should be persisted indefinitely.\nBy default, filter sets are not t
ransient.\nIf transient, it will be available for at least 1 hour after creation
.", |
| 230 "location": "query", |
| 231 "type": "boolean" |
| 232 }, |
| 196 "accountId": { | 233 "accountId": { |
| 197 "description": "Unique numerical account ID
for the buyer of which the client buyer\nis a customer; the sponsor buyer to cre
ate a client for. (required)", | 234 "description": "Account ID of the buyer.", |
| 198 "format": "int64", | 235 "format": "int64", |
| 199 "location": "path", | 236 "location": "path", |
| 200 "required": true, | 237 "required": true, |
| 201 "type": "string" | 238 "type": "string" |
| 202 } | 239 } |
| 203 }, | 240 }, |
| 204 "path": "v2beta1/accounts/{accountId}/clients", | 241 "path": "v2beta1/accounts/{accountId}/filterSets", |
| 205 "request": { | 242 "request": { |
| 206 "$ref": "Client" | 243 "$ref": "FilterSet" |
| 207 }, | 244 }, |
| 208 "response": { | 245 "response": { |
| 209 "$ref": "Client" | 246 "$ref": "FilterSet" |
| 210 }, | 247 }, |
| 211 "scopes": [ | 248 "scopes": [ |
| 212 "https://www.googleapis.com/auth/adexchange.buye
r" | 249 "https://www.googleapis.com/auth/adexchange.buye
r" |
| 213 ] | 250 ] |
| 214 }, | 251 }, |
| 215 "list": { | 252 "getImpressionMetrics": { |
| 216 "description": "Lists all the clients for the curren
t sponsor buyer.", | 253 "description": "Gets all metrics that are measured i
n terms of number of impressions.", |
| 217 "httpMethod": "GET", | 254 "httpMethod": "GET", |
| 218 "id": "adexchangebuyer2.accounts.clients.list", | 255 "id": "adexchangebuyer2.accounts.filterSets.getImpre
ssionMetrics", |
| 219 "parameterOrder": [ | 256 "parameterOrder": [ |
| 220 "accountId" | 257 "accountId", |
| 258 "filterSetId" |
| 221 ], | 259 ], |
| 222 "parameters": { | 260 "parameters": { |
| 223 "pageSize": { | 261 "filterSetId": { |
| 224 "description": "Requested page size. The ser
ver may return fewer clients than requested.\nIf unspecified, the server will pi
ck an appropriate default.", | 262 "description": "The ID of the filter set to
apply.", |
| 225 "format": "int32", | 263 "format": "int32", |
| 226 "location": "query", | 264 "location": "path", |
| 265 "required": true, |
| 227 "type": "integer" | 266 "type": "integer" |
| 228 }, | 267 }, |
| 229 "accountId": { | 268 "accountId": { |
| 230 "description": "Unique numerical account ID
of the sponsor buyer to list the clients for.", | 269 "description": "Account ID of the buyer.", |
| 231 "format": "int64", | 270 "format": "int64", |
| 232 "location": "path", | 271 "location": "path", |
| 233 "required": true, | 272 "required": true, |
| 234 "type": "string" | 273 "type": "string" |
| 274 } |
| 275 }, |
| 276 "path": "v2beta1/accounts/{accountId}/filterSets/{fi
lterSetId}/impressionMetrics", |
| 277 "response": { |
| 278 "$ref": "ImpressionMetrics" |
| 279 }, |
| 280 "scopes": [ |
| 281 "https://www.googleapis.com/auth/adexchange.buye
r" |
| 282 ] |
| 283 }, |
| 284 "delete": { |
| 285 "description": "Deletes the requested filter set fro
m the account with the given account\nID.", |
| 286 "httpMethod": "DELETE", |
| 287 "id": "adexchangebuyer2.accounts.filterSets.delete", |
| 288 "parameterOrder": [ |
| 289 "accountId", |
| 290 "filterSetId" |
| 291 ], |
| 292 "parameters": { |
| 293 "filterSetId": { |
| 294 "description": "The ID of the filter set to
delete.", |
| 295 "format": "int32", |
| 296 "location": "path", |
| 297 "required": true, |
| 298 "type": "integer" |
| 235 }, | 299 }, |
| 236 "pageToken": { | 300 "accountId": { |
| 237 "description": "A token identifying a page o
f results the server should return.\nTypically, this is the value of\nListClient
sResponse.nextPageToken\nreturned from the previous call to the\naccounts.client
s.list method.", | 301 "description": "Account ID of the buyer.", |
| 238 "location": "query", | 302 "format": "int64", |
| 303 "location": "path", |
| 304 "required": true, |
| 239 "type": "string" | 305 "type": "string" |
| 240 } | 306 } |
| 241 }, | 307 }, |
| 242 "path": "v2beta1/accounts/{accountId}/clients", | 308 "path": "v2beta1/accounts/{accountId}/filterSets/{fi
lterSetId}", |
| 243 "response": { | 309 "response": { |
| 244 "$ref": "ListClientsResponse" | 310 "$ref": "Empty" |
| 245 }, | 311 }, |
| 246 "scopes": [ | 312 "scopes": [ |
| 247 "https://www.googleapis.com/auth/adexchange.buye
r" | 313 "https://www.googleapis.com/auth/adexchange.buye
r" |
| 248 ] | 314 ] |
| 249 } | 315 } |
| 250 }, | 316 }, |
| 251 "resources": { | 317 "resources": { |
| 252 "users": { | 318 "responsesWithoutBids": { |
| 253 "methods": { | 319 "methods": { |
| 254 "update": { | 320 "list": { |
| 255 "description": "Updates an existing client u
ser.\nOnly the user status can be changed on update.", | 321 "description": "List all reasons for which b
id responses were considered to have no\napplicable bids, with the number of bid
responses affected for each reason.", |
| 256 "httpMethod": "PUT", | 322 "httpMethod": "GET", |
| 257 "id": "adexchangebuyer2.accounts.clients.use
rs.update", | 323 "id": "adexchangebuyer2.accounts.filterSets.
responsesWithoutBids.list", |
| 258 "parameterOrder": [ | 324 "parameterOrder": [ |
| 259 "accountId", | 325 "accountId", |
| 260 "clientAccountId", | 326 "filterSetId" |
| 261 "userId" | |
| 262 ], | 327 ], |
| 263 "parameters": { | 328 "parameters": { |
| 264 "clientAccountId": { | 329 "filterSetId": { |
| 265 "description": "Numerical account ID
of the client buyer that the user to be retrieved\nis associated with. (require
d)", | 330 "description": "The ID of the filter
set to apply.", |
| 266 "format": "int64", | 331 "format": "int32", |
| 267 "location": "path", | 332 "location": "path", |
| 268 "required": true, | 333 "required": true, |
| 269 "type": "string" | 334 "type": "integer" |
| 270 }, | |
| 271 "userId": { | |
| 272 "description": "Numerical identifier
of the user to retrieve. (required)", | |
| 273 "format": "int64", | |
| 274 "location": "path", | |
| 275 "required": true, | |
| 276 "type": "string" | |
| 277 }, | 335 }, |
| 278 "accountId": { | 336 "accountId": { |
| 279 "description": "Numerical account ID
of the client's sponsor buyer. (required)", | 337 "description": "Account ID of the bu
yer.", |
| 280 "format": "int64", | 338 "format": "int64", |
| 281 "location": "path", | 339 "location": "path", |
| 282 "required": true, | 340 "required": true, |
| 283 "type": "string" | 341 "type": "string" |
| 284 } | 342 } |
| 285 }, | 343 }, |
| 286 "path": "v2beta1/accounts/{accountId}/client
s/{clientAccountId}/users/{userId}", | 344 "path": "v2beta1/accounts/{accountId}/filter
Sets/{filterSetId}/responsesWithoutBids", |
| 287 "request": { | |
| 288 "$ref": "ClientUser" | |
| 289 }, | |
| 290 "response": { | 345 "response": { |
| 291 "$ref": "ClientUser" | 346 "$ref": "ListResponsesWithoutBidsRespons
e" |
| 292 }, | 347 }, |
| 293 "scopes": [ | 348 "scopes": [ |
| 294 "https://www.googleapis.com/auth/adexcha
nge.buyer" | 349 "https://www.googleapis.com/auth/adexcha
nge.buyer" |
| 295 ] | 350 ] |
| 296 }, | 351 } |
| 297 "get": { | 352 } |
| 298 "description": "Retrieves an existing client
user.", | 353 }, |
| 354 "responseErrors": { |
| 355 "methods": { |
| 356 "list": { |
| 357 "description": "List all errors that occurre
d in bid responses, with the number of bid\nresponses affected for each reason."
, |
| 299 "httpMethod": "GET", | 358 "httpMethod": "GET", |
| 300 "id": "adexchangebuyer2.accounts.clients.use
rs.get", | 359 "id": "adexchangebuyer2.accounts.filterSets.
responseErrors.list", |
| 301 "parameterOrder": [ | 360 "parameterOrder": [ |
| 302 "accountId", | 361 "accountId", |
| 303 "clientAccountId", | 362 "filterSetId" |
| 304 "userId" | |
| 305 ], | 363 ], |
| 306 "parameters": { | 364 "parameters": { |
| 307 "clientAccountId": { | 365 "filterSetId": { |
| 308 "description": "Numerical account ID
of the client buyer\nthat the user to be retrieved is associated with. (require
d)", | 366 "description": "The ID of the filter
set to apply.", |
| 309 "format": "int64", | 367 "format": "int32", |
| 310 "location": "path", | 368 "location": "path", |
| 311 "required": true, | 369 "required": true, |
| 312 "type": "string" | 370 "type": "integer" |
| 313 }, | |
| 314 "userId": { | |
| 315 "description": "Numerical identifier
of the user to retrieve. (required)", | |
| 316 "format": "int64", | |
| 317 "location": "path", | |
| 318 "required": true, | |
| 319 "type": "string" | |
| 320 }, | 371 }, |
| 321 "accountId": { | 372 "accountId": { |
| 322 "description": "Numerical account ID
of the client's sponsor buyer. (required)", | 373 "description": "Account ID of the bu
yer.", |
| 323 "format": "int64", | 374 "format": "int64", |
| 324 "location": "path", | 375 "location": "path", |
| 325 "required": true, | 376 "required": true, |
| 326 "type": "string" | 377 "type": "string" |
| 327 } | 378 } |
| 328 }, | 379 }, |
| 329 "path": "v2beta1/accounts/{accountId}/client
s/{clientAccountId}/users/{userId}", | 380 "path": "v2beta1/accounts/{accountId}/filter
Sets/{filterSetId}/responseErrors", |
| 330 "response": { | 381 "response": { |
| 331 "$ref": "ClientUser" | 382 "$ref": "ListResponseErrorsResponse" |
| 332 }, | 383 }, |
| 333 "scopes": [ | 384 "scopes": [ |
| 334 "https://www.googleapis.com/auth/adexcha
nge.buyer" | 385 "https://www.googleapis.com/auth/adexcha
nge.buyer" |
| 335 ] | 386 ] |
| 336 }, | 387 } |
| 388 } |
| 389 }, |
| 390 "losingBids": { |
| 391 "methods": { |
| 337 "list": { | 392 "list": { |
| 338 "description": "Lists all the known client u
sers for a specified\nsponsor buyer account ID.", | 393 "description": "List all reasons for which b
ids lost in the auction, with the number of\nbids that lost for each reason.", |
| 339 "httpMethod": "GET", | 394 "httpMethod": "GET", |
| 340 "id": "adexchangebuyer2.accounts.clients.use
rs.list", | 395 "id": "adexchangebuyer2.accounts.filterSets.
losingBids.list", |
| 341 "parameterOrder": [ | 396 "parameterOrder": [ |
| 342 "accountId", | 397 "accountId", |
| 343 "clientAccountId" | 398 "filterSetId" |
| 344 ], | 399 ], |
| 345 "parameters": { | 400 "parameters": { |
| 346 "clientAccountId": { | 401 "filterSetId": { |
| 347 "description": "The account ID of th
e client buyer to list users for. (required)\nYou must specify either a string r
epresentation of a\nnumerical account identifier or the `-` character\nto list a
ll the client users for all the clients\nof a given sponsor buyer.", | 402 "description": "The ID of the filter
set to apply.", |
| 403 "format": "int32", |
| 348 "location": "path", | 404 "location": "path", |
| 349 "required": true, | 405 "required": true, |
| 350 "type": "string" | |
| 351 }, | |
| 352 "pageSize": { | |
| 353 "description": "Requested page size.
The server may return fewer clients than requested.\nIf unspecified, the server
will pick an appropriate default.", | |
| 354 "format": "int32", | |
| 355 "location": "query", | |
| 356 "type": "integer" | 406 "type": "integer" |
| 357 }, | 407 }, |
| 358 "accountId": { | 408 "accountId": { |
| 359 "description": "Numerical account ID
of the sponsor buyer of the client to list users for.\n(required)", | 409 "description": "Account ID of the bu
yer.", |
| 360 "format": "int64", | 410 "format": "int64", |
| 361 "location": "path", | 411 "location": "path", |
| 362 "required": true, | 412 "required": true, |
| 363 "type": "string" | 413 "type": "string" |
| 364 }, | |
| 365 "pageToken": { | |
| 366 "description": "A token identifying
a page of results the server should return.\nTypically, this is the value of\nLi
stClientUsersResponse.nextPageToken\nreturned from the previous call to the\nacc
ounts.clients.users.list method.", | |
| 367 "location": "query", | |
| 368 "type": "string" | |
| 369 } | 414 } |
| 370 }, | 415 }, |
| 371 "path": "v2beta1/accounts/{accountId}/client
s/{clientAccountId}/users", | 416 "path": "v2beta1/accounts/{accountId}/filter
Sets/{filterSetId}/losingBids", |
| 372 "response": { | 417 "response": { |
| 373 "$ref": "ListClientUsersResponse" | 418 "$ref": "ListLosingBidsResponse" |
| 374 }, | 419 }, |
| 375 "scopes": [ | 420 "scopes": [ |
| 376 "https://www.googleapis.com/auth/adexcha
nge.buyer" | 421 "https://www.googleapis.com/auth/adexcha
nge.buyer" |
| 377 ] | 422 ] |
| 378 } | 423 } |
| 379 } | 424 } |
| 380 }, | 425 }, |
| 381 "invitations": { | 426 "filteredBids": { |
| 382 "methods": { | 427 "methods": { |
| 383 "create": { | 428 "list": { |
| 384 "description": "Creates and sends out an ema
il invitation to access\nan Ad Exchange client buyer account.", | 429 "description": "List all reasons for which b
ids were filtered, with the number of bids\nfiltered for each reason.", |
| 385 "httpMethod": "POST", | 430 "httpMethod": "GET", |
| 386 "id": "adexchangebuyer2.accounts.clients.inv
itations.create", | 431 "id": "adexchangebuyer2.accounts.filterSets.
filteredBids.list", |
| 387 "parameterOrder": [ | 432 "parameterOrder": [ |
| 388 "accountId", | 433 "accountId", |
| 389 "clientAccountId" | 434 "filterSetId" |
| 390 ], | 435 ], |
| 391 "parameters": { | 436 "parameters": { |
| 392 "clientAccountId": { | 437 "filterSetId": { |
| 393 "description": "Numerical account ID
of the client buyer that the user\nshould be associated with. (required)", | 438 "description": "The ID of the filter
set to apply.", |
| 394 "format": "int64", | 439 "format": "int32", |
| 395 "location": "path", | 440 "location": "path", |
| 396 "required": true, | 441 "required": true, |
| 397 "type": "string" | 442 "type": "integer" |
| 398 }, | 443 }, |
| 399 "accountId": { | 444 "accountId": { |
| 400 "description": "Numerical account ID
of the client's sponsor buyer. (required)", | 445 "description": "Account ID of the bu
yer.", |
| 401 "format": "int64", | 446 "format": "int64", |
| 402 "location": "path", | 447 "location": "path", |
| 403 "required": true, | 448 "required": true, |
| 404 "type": "string" | 449 "type": "string" |
| 405 } | 450 } |
| 406 }, | 451 }, |
| 407 "path": "v2beta1/accounts/{accountId}/client
s/{clientAccountId}/invitations", | 452 "path": "v2beta1/accounts/{accountId}/filter
Sets/{filterSetId}/filteredBids", |
| 408 "request": { | |
| 409 "$ref": "ClientUserInvitation" | |
| 410 }, | |
| 411 "response": { | 453 "response": { |
| 412 "$ref": "ClientUserInvitation" | 454 "$ref": "ListFilteredBidsResponse" |
| 413 }, | 455 }, |
| 414 "scopes": [ | 456 "scopes": [ |
| 415 "https://www.googleapis.com/auth/adexcha
nge.buyer" | 457 "https://www.googleapis.com/auth/adexcha
nge.buyer" |
| 416 ] | 458 ] |
| 459 } |
| 460 }, |
| 461 "resources": { |
| 462 "creatives": { |
| 463 "methods": { |
| 464 "list": { |
| 465 "description": "List all creatives a
ssociated with a specific reason for which bids were\nfiltered, with the number
of bids filtered for each creative.", |
| 466 "httpMethod": "GET", |
| 467 "id": "adexchangebuyer2.accounts.fil
terSets.filteredBids.creatives.list", |
| 468 "parameterOrder": [ |
| 469 "accountId", |
| 470 "filterSetId", |
| 471 "creativeStatusId" |
| 472 ], |
| 473 "parameters": { |
| 474 "filterSetId": { |
| 475 "description": "The ID of th
e filter set to apply.", |
| 476 "format": "int32", |
| 477 "location": "path", |
| 478 "required": true, |
| 479 "type": "integer" |
| 480 }, |
| 481 "creativeStatusId": { |
| 482 "description": "The ID of th
e creative status for which to retrieve a breakdown by\ncreative.\nSee creative-
status-codes.", |
| 483 "format": "int32", |
| 484 "location": "path", |
| 485 "required": true, |
| 486 "type": "integer" |
| 487 }, |
| 488 "pageSize": { |
| 489 "description": "Requested pa
ge size. The server may return fewer than requested.\nIf unspecified, the server
will pick an appropriate default.", |
| 490 "format": "int32", |
| 491 "location": "query", |
| 492 "type": "integer" |
| 493 }, |
| 494 "accountId": { |
| 495 "description": "Account ID o
f the buyer.", |
| 496 "format": "int64", |
| 497 "location": "path", |
| 498 "required": true, |
| 499 "type": "string" |
| 500 }, |
| 501 "pageToken": { |
| 502 "description": "A token iden
tifying a page of results the server should return.\nTypically, this is the valu
e of\nListCreativeStatusBreakdownByCreativeResponse.nextPageToken\nreturned from
the previous call to the\naccounts.filterSets.filteredBids.creatives.list metho
d.", |
| 503 "location": "query", |
| 504 "type": "string" |
| 505 } |
| 506 }, |
| 507 "path": "v2beta1/accounts/{accountId
}/filterSets/{filterSetId}/filteredBids/{creativeStatusId}/creatives", |
| 508 "response": { |
| 509 "$ref": "ListCreativeStatusBreak
downByCreativeResponse" |
| 510 }, |
| 511 "scopes": [ |
| 512 "https://www.googleapis.com/auth
/adexchange.buyer" |
| 513 ] |
| 514 } |
| 515 }, |
| 516 "resources": { |
| 517 "details": { |
| 518 "methods": { |
| 519 "list": { |
| 520 "description": "List all det
ails associated with a specific reason for which bids were\nfiltered and a speci
fic creative that was filtered for that reason, with\nthe number of bids filtere
d for each detail.", |
| 521 "httpMethod": "GET", |
| 522 "id": "adexchangebuyer2.acco
unts.filterSets.filteredBids.creatives.details.list", |
| 523 "parameterOrder": [ |
| 524 "accountId", |
| 525 "filterSetId", |
| 526 "creativeStatusId", |
| 527 "creativeId" |
| 528 ], |
| 529 "parameters": { |
| 530 "filterSetId": { |
| 531 "description": "The
ID of the filter set to apply.", |
| 532 "format": "int32", |
| 533 "location": "path", |
| 534 "required": true, |
| 535 "type": "integer" |
| 536 }, |
| 537 "creativeStatusId": { |
| 538 "description": "The
ID of the creative status for which to retrieve a breakdown by detail.\nSee crea
tive-status-codes.", |
| 539 "format": "int32", |
| 540 "location": "path", |
| 541 "required": true, |
| 542 "type": "integer" |
| 543 }, |
| 544 "creativeId": { |
| 545 "description": "The
creative ID for which to retrieve a breakdown by detail.", |
| 546 "location": "path", |
| 547 "required": true, |
| 548 "type": "string" |
| 549 }, |
| 550 "accountId": { |
| 551 "description": "Acco
unt ID of the buyer.", |
| 552 "format": "int64", |
| 553 "location": "path", |
| 554 "required": true, |
| 555 "type": "string" |
| 556 } |
| 557 }, |
| 558 "path": "v2beta1/accounts/{a
ccountId}/filterSets/{filterSetId}/filteredBids/{creativeStatusId}/creatives/{cr
eativeId}/details", |
| 559 "response": { |
| 560 "$ref": "ListCreativeSta
tusAndCreativeBreakdownByDetailResponse" |
| 561 }, |
| 562 "scopes": [ |
| 563 "https://www.googleapis.
com/auth/adexchange.buyer" |
| 564 ] |
| 565 } |
| 566 } |
| 567 } |
| 568 } |
| 417 }, | 569 }, |
| 418 "get": { | 570 "details": { |
| 419 "description": "Retrieves an existing client
user invitation.", | 571 "methods": { |
| 572 "list": { |
| 573 "description": "List all details ass
ociated with a specific reason for which bids were\nfiltered, with the number of
bids filtered for each detail.", |
| 574 "httpMethod": "GET", |
| 575 "id": "adexchangebuyer2.accounts.fil
terSets.filteredBids.details.list", |
| 576 "parameterOrder": [ |
| 577 "accountId", |
| 578 "filterSetId", |
| 579 "creativeStatusId" |
| 580 ], |
| 581 "parameters": { |
| 582 "filterSetId": { |
| 583 "description": "The ID of th
e filter set to apply.", |
| 584 "format": "int32", |
| 585 "location": "path", |
| 586 "required": true, |
| 587 "type": "integer" |
| 588 }, |
| 589 "creativeStatusId": { |
| 590 "description": "The ID of th
e creative status for which to retrieve a breakdown by detail.\nSee creative-sta
tus-codes.", |
| 591 "format": "int32", |
| 592 "location": "path", |
| 593 "required": true, |
| 594 "type": "integer" |
| 595 }, |
| 596 "accountId": { |
| 597 "description": "Account ID o
f the buyer.", |
| 598 "format": "int64", |
| 599 "location": "path", |
| 600 "required": true, |
| 601 "type": "string" |
| 602 } |
| 603 }, |
| 604 "path": "v2beta1/accounts/{accountId
}/filterSets/{filterSetId}/filteredBids/{creativeStatusId}/details", |
| 605 "response": { |
| 606 "$ref": "ListCreativeStatusBreak
downByDetailResponse" |
| 607 }, |
| 608 "scopes": [ |
| 609 "https://www.googleapis.com/auth
/adexchange.buyer" |
| 610 ] |
| 611 } |
| 612 } |
| 613 } |
| 614 } |
| 615 }, |
| 616 "filteredImpressions": { |
| 617 "methods": { |
| 618 "list": { |
| 619 "description": "List all reasons that caused
an impression to be filtered (i.e. not\nconsidered as an inventory match), with
the number of impressions that were\nfiltered for each reason.", |
| 420 "httpMethod": "GET", | 620 "httpMethod": "GET", |
| 421 "id": "adexchangebuyer2.accounts.clients.inv
itations.get", | 621 "id": "adexchangebuyer2.accounts.filterSets.
filteredImpressions.list", |
| 422 "parameterOrder": [ | 622 "parameterOrder": [ |
| 423 "accountId", | 623 "accountId", |
| 424 "clientAccountId", | 624 "filterSetId" |
| 425 "invitationId" | |
| 426 ], | 625 ], |
| 427 "parameters": { | 626 "parameters": { |
| 428 "clientAccountId": { | 627 "filterSetId": { |
| 429 "description": "Numerical account ID
of the client buyer that the user invitation\nto be retrieved is associated wit
h. (required)", | 628 "description": "The ID of the filter
set to apply.", |
| 430 "format": "int64", | 629 "format": "int32", |
| 431 "location": "path", | 630 "location": "path", |
| 432 "required": true, | 631 "required": true, |
| 433 "type": "string" | 632 "type": "integer" |
| 434 }, | |
| 435 "invitationId": { | |
| 436 "description": "Numerical identifier
of the user invitation to retrieve. (required)", | |
| 437 "format": "int64", | |
| 438 "location": "path", | |
| 439 "required": true, | |
| 440 "type": "string" | |
| 441 }, | 633 }, |
| 442 "accountId": { | 634 "accountId": { |
| 443 "description": "Numerical account ID
of the client's sponsor buyer. (required)", | 635 "description": "Account ID of the bu
yer.", |
| 444 "format": "int64", | 636 "format": "int64", |
| 445 "location": "path", | 637 "location": "path", |
| 446 "required": true, | 638 "required": true, |
| 447 "type": "string" | 639 "type": "string" |
| 448 } | 640 } |
| 449 }, | 641 }, |
| 450 "path": "v2beta1/accounts/{accountId}/client
s/{clientAccountId}/invitations/{invitationId}", | 642 "path": "v2beta1/accounts/{accountId}/filter
Sets/{filterSetId}/filteredImpressions", |
| 451 "response": { | 643 "response": { |
| 452 "$ref": "ClientUserInvitation" | 644 "$ref": "ListFilteredImpressionsResponse
" |
| 453 }, | 645 }, |
| 454 "scopes": [ | 646 "scopes": [ |
| 455 "https://www.googleapis.com/auth/adexcha
nge.buyer" | 647 "https://www.googleapis.com/auth/adexcha
nge.buyer" |
| 456 ] | 648 ] |
| 457 }, | 649 } |
| 650 } |
| 651 }, |
| 652 "filteredRequests": { |
| 653 "methods": { |
| 458 "list": { | 654 "list": { |
| 459 "description": "Lists all the client users i
nvitations for a client\nwith a given account ID.", | 655 "description": "List all reasons that caused
a bid request not to be sent for an\nimpression, with the number of bid request
s not sent for each reason.", |
| 460 "httpMethod": "GET", | 656 "httpMethod": "GET", |
| 461 "id": "adexchangebuyer2.accounts.clients.inv
itations.list", | 657 "id": "adexchangebuyer2.accounts.filterSets.
filteredRequests.list", |
| 462 "parameterOrder": [ | 658 "parameterOrder": [ |
| 463 "accountId", | 659 "accountId", |
| 464 "clientAccountId" | 660 "filterSetId" |
| 465 ], | 661 ], |
| 466 "parameters": { | 662 "parameters": { |
| 467 "clientAccountId": { | 663 "filterSetId": { |
| 468 "description": "Numerical account ID
of the client buyer to list invitations for.\n(required)\nYou must either speci
fy a string representation of a\nnumerical account identifier or the `-` charact
er\nto list all the invitations for all the clients\nof a given sponsor buyer.", | 664 "description": "The ID of the filter
set to apply.", |
| 469 "location": "path", | |
| 470 "required": true, | |
| 471 "type": "string" | |
| 472 }, | |
| 473 "pageSize": { | |
| 474 "description": "Requested page size.
Server may return fewer clients than requested.\nIf unspecified, server will pi
ck an appropriate default.", | |
| 475 "format": "int32", | 665 "format": "int32", |
| 476 "location": "query", | 666 "location": "path", |
| 667 "required": true, |
| 477 "type": "integer" | 668 "type": "integer" |
| 478 }, | 669 }, |
| 479 "accountId": { | 670 "accountId": { |
| 480 "description": "Numerical account ID
of the client's sponsor buyer. (required)", | 671 "description": "Account ID of the bu
yer.", |
| 481 "format": "int64", | 672 "format": "int64", |
| 482 "location": "path", | 673 "location": "path", |
| 483 "required": true, | 674 "required": true, |
| 484 "type": "string" | 675 "type": "string" |
| 485 }, | 676 } |
| 486 "pageToken": { | 677 }, |
| 487 "description": "A token identifying
a page of results the server should return.\nTypically, this is the value of\nLi
stClientUserInvitationsResponse.nextPageToken\nreturned from the previous call t
o the\nclients.invitations.list\nmethod.", | 678 "path": "v2beta1/accounts/{accountId}/filter
Sets/{filterSetId}/filteredRequests", |
| 488 "location": "query", | |
| 489 "type": "string" | |
| 490 } | |
| 491 }, | |
| 492 "path": "v2beta1/accounts/{accountId}/client
s/{clientAccountId}/invitations", | |
| 493 "response": { | 679 "response": { |
| 494 "$ref": "ListClientUserInvitationsRespon
se" | 680 "$ref": "ListFilteredRequestsResponse" |
| 495 }, | 681 }, |
| 496 "scopes": [ | 682 "scopes": [ |
| 497 "https://www.googleapis.com/auth/adexcha
nge.buyer" | 683 "https://www.googleapis.com/auth/adexcha
nge.buyer" |
| 498 ] | 684 ] |
| 499 } | 685 } |
| 500 } | 686 } |
| 501 } | 687 } |
| 502 } | 688 } |
| 689 }, |
| 690 "clients": { |
| 691 "methods": { |
| 692 "update": { |
| 693 "description": "Updates an existing client buyer.", |
| 694 "httpMethod": "PUT", |
| 695 "id": "adexchangebuyer2.accounts.clients.update", |
| 696 "parameterOrder": [ |
| 697 "accountId", |
| 698 "clientAccountId" |
| 699 ], |
| 700 "parameters": { |
| 701 "clientAccountId": { |
| 702 "description": "Unique numerical account ID
of the client to update. (required)", |
| 703 "format": "int64", |
| 704 "location": "path", |
| 705 "required": true, |
| 706 "type": "string" |
| 707 }, |
| 708 "accountId": { |
| 709 "description": "Unique numerical account ID
for the buyer of which the client buyer\nis a customer; the sponsor buyer to upd
ate a client for. (required)", |
| 710 "format": "int64", |
| 711 "location": "path", |
| 712 "required": true, |
| 713 "type": "string" |
| 714 } |
| 715 }, |
| 716 "path": "v2beta1/accounts/{accountId}/clients/{clien
tAccountId}", |
| 717 "request": { |
| 718 "$ref": "Client" |
| 719 }, |
| 720 "response": { |
| 721 "$ref": "Client" |
| 722 }, |
| 723 "scopes": [ |
| 724 "https://www.googleapis.com/auth/adexchange.buye
r" |
| 725 ] |
| 726 }, |
| 727 "get": { |
| 728 "description": "Gets a client buyer with a given cli
ent account ID.", |
| 729 "httpMethod": "GET", |
| 730 "id": "adexchangebuyer2.accounts.clients.get", |
| 731 "parameterOrder": [ |
| 732 "accountId", |
| 733 "clientAccountId" |
| 734 ], |
| 735 "parameters": { |
| 736 "clientAccountId": { |
| 737 "description": "Numerical account ID of the
client buyer to retrieve. (required)", |
| 738 "format": "int64", |
| 739 "location": "path", |
| 740 "required": true, |
| 741 "type": "string" |
| 742 }, |
| 743 "accountId": { |
| 744 "description": "Numerical account ID of the
client's sponsor buyer. (required)", |
| 745 "format": "int64", |
| 746 "location": "path", |
| 747 "required": true, |
| 748 "type": "string" |
| 749 } |
| 750 }, |
| 751 "path": "v2beta1/accounts/{accountId}/clients/{clien
tAccountId}", |
| 752 "response": { |
| 753 "$ref": "Client" |
| 754 }, |
| 755 "scopes": [ |
| 756 "https://www.googleapis.com/auth/adexchange.buye
r" |
| 757 ] |
| 758 }, |
| 759 "create": { |
| 760 "description": "Creates a new client buyer.", |
| 761 "httpMethod": "POST", |
| 762 "id": "adexchangebuyer2.accounts.clients.create", |
| 763 "parameterOrder": [ |
| 764 "accountId" |
| 765 ], |
| 766 "parameters": { |
| 767 "accountId": { |
| 768 "description": "Unique numerical account ID
for the buyer of which the client buyer\nis a customer; the sponsor buyer to cre
ate a client for. (required)", |
| 769 "format": "int64", |
| 770 "location": "path", |
| 771 "required": true, |
| 772 "type": "string" |
| 773 } |
| 774 }, |
| 775 "path": "v2beta1/accounts/{accountId}/clients", |
| 776 "request": { |
| 777 "$ref": "Client" |
| 778 }, |
| 779 "response": { |
| 780 "$ref": "Client" |
| 781 }, |
| 782 "scopes": [ |
| 783 "https://www.googleapis.com/auth/adexchange.buye
r" |
| 784 ] |
| 785 }, |
| 786 "list": { |
| 787 "description": "Lists all the clients for the curren
t sponsor buyer.", |
| 788 "httpMethod": "GET", |
| 789 "id": "adexchangebuyer2.accounts.clients.list", |
| 790 "parameterOrder": [ |
| 791 "accountId" |
| 792 ], |
| 793 "parameters": { |
| 794 "pageSize": { |
| 795 "description": "Requested page size. The ser
ver may return fewer clients than requested.\nIf unspecified, the server will pi
ck an appropriate default.", |
| 796 "format": "int32", |
| 797 "location": "query", |
| 798 "type": "integer" |
| 799 }, |
| 800 "accountId": { |
| 801 "description": "Unique numerical account ID
of the sponsor buyer to list the clients for.", |
| 802 "format": "int64", |
| 803 "location": "path", |
| 804 "required": true, |
| 805 "type": "string" |
| 806 }, |
| 807 "pageToken": { |
| 808 "description": "A token identifying a page o
f results the server should return.\nTypically, this is the value of\nListClient
sResponse.nextPageToken\nreturned from the previous call to the\naccounts.client
s.list method.", |
| 809 "location": "query", |
| 810 "type": "string" |
| 811 } |
| 812 }, |
| 813 "path": "v2beta1/accounts/{accountId}/clients", |
| 814 "response": { |
| 815 "$ref": "ListClientsResponse" |
| 816 }, |
| 817 "scopes": [ |
| 818 "https://www.googleapis.com/auth/adexchange.buye
r" |
| 819 ] |
| 820 } |
| 821 }, |
| 822 "resources": { |
| 823 "users": { |
| 824 "methods": { |
| 825 "update": { |
| 826 "description": "Updates an existing client u
ser.\nOnly the user status can be changed on update.", |
| 827 "httpMethod": "PUT", |
| 828 "id": "adexchangebuyer2.accounts.clients.use
rs.update", |
| 829 "parameterOrder": [ |
| 830 "accountId", |
| 831 "clientAccountId", |
| 832 "userId" |
| 833 ], |
| 834 "parameters": { |
| 835 "clientAccountId": { |
| 836 "description": "Numerical account ID
of the client buyer that the user to be retrieved\nis associated with. (require
d)", |
| 837 "format": "int64", |
| 838 "location": "path", |
| 839 "required": true, |
| 840 "type": "string" |
| 841 }, |
| 842 "userId": { |
| 843 "description": "Numerical identifier
of the user to retrieve. (required)", |
| 844 "format": "int64", |
| 845 "location": "path", |
| 846 "required": true, |
| 847 "type": "string" |
| 848 }, |
| 849 "accountId": { |
| 850 "description": "Numerical account ID
of the client's sponsor buyer. (required)", |
| 851 "format": "int64", |
| 852 "location": "path", |
| 853 "required": true, |
| 854 "type": "string" |
| 855 } |
| 856 }, |
| 857 "path": "v2beta1/accounts/{accountId}/client
s/{clientAccountId}/users/{userId}", |
| 858 "request": { |
| 859 "$ref": "ClientUser" |
| 860 }, |
| 861 "response": { |
| 862 "$ref": "ClientUser" |
| 863 }, |
| 864 "scopes": [ |
| 865 "https://www.googleapis.com/auth/adexcha
nge.buyer" |
| 866 ] |
| 867 }, |
| 868 "get": { |
| 869 "description": "Retrieves an existing client
user.", |
| 870 "httpMethod": "GET", |
| 871 "id": "adexchangebuyer2.accounts.clients.use
rs.get", |
| 872 "parameterOrder": [ |
| 873 "accountId", |
| 874 "clientAccountId", |
| 875 "userId" |
| 876 ], |
| 877 "parameters": { |
| 878 "clientAccountId": { |
| 879 "description": "Numerical account ID
of the client buyer\nthat the user to be retrieved is associated with. (require
d)", |
| 880 "format": "int64", |
| 881 "location": "path", |
| 882 "required": true, |
| 883 "type": "string" |
| 884 }, |
| 885 "userId": { |
| 886 "description": "Numerical identifier
of the user to retrieve. (required)", |
| 887 "format": "int64", |
| 888 "location": "path", |
| 889 "required": true, |
| 890 "type": "string" |
| 891 }, |
| 892 "accountId": { |
| 893 "description": "Numerical account ID
of the client's sponsor buyer. (required)", |
| 894 "format": "int64", |
| 895 "location": "path", |
| 896 "required": true, |
| 897 "type": "string" |
| 898 } |
| 899 }, |
| 900 "path": "v2beta1/accounts/{accountId}/client
s/{clientAccountId}/users/{userId}", |
| 901 "response": { |
| 902 "$ref": "ClientUser" |
| 903 }, |
| 904 "scopes": [ |
| 905 "https://www.googleapis.com/auth/adexcha
nge.buyer" |
| 906 ] |
| 907 }, |
| 908 "list": { |
| 909 "description": "Lists all the known client u
sers for a specified\nsponsor buyer account ID.", |
| 910 "httpMethod": "GET", |
| 911 "id": "adexchangebuyer2.accounts.clients.use
rs.list", |
| 912 "parameterOrder": [ |
| 913 "accountId", |
| 914 "clientAccountId" |
| 915 ], |
| 916 "parameters": { |
| 917 "clientAccountId": { |
| 918 "description": "The account ID of th
e client buyer to list users for. (required)\nYou must specify either a string r
epresentation of a\nnumerical account identifier or the `-` character\nto list a
ll the client users for all the clients\nof a given sponsor buyer.", |
| 919 "location": "path", |
| 920 "required": true, |
| 921 "type": "string" |
| 922 }, |
| 923 "pageSize": { |
| 924 "description": "Requested page size.
The server may return fewer clients than requested.\nIf unspecified, the server
will pick an appropriate default.", |
| 925 "format": "int32", |
| 926 "location": "query", |
| 927 "type": "integer" |
| 928 }, |
| 929 "accountId": { |
| 930 "description": "Numerical account ID
of the sponsor buyer of the client to list users for.\n(required)", |
| 931 "format": "int64", |
| 932 "location": "path", |
| 933 "required": true, |
| 934 "type": "string" |
| 935 }, |
| 936 "pageToken": { |
| 937 "description": "A token identifying
a page of results the server should return.\nTypically, this is the value of\nLi
stClientUsersResponse.nextPageToken\nreturned from the previous call to the\nacc
ounts.clients.users.list method.", |
| 938 "location": "query", |
| 939 "type": "string" |
| 940 } |
| 941 }, |
| 942 "path": "v2beta1/accounts/{accountId}/client
s/{clientAccountId}/users", |
| 943 "response": { |
| 944 "$ref": "ListClientUsersResponse" |
| 945 }, |
| 946 "scopes": [ |
| 947 "https://www.googleapis.com/auth/adexcha
nge.buyer" |
| 948 ] |
| 949 } |
| 950 } |
| 951 }, |
| 952 "invitations": { |
| 953 "methods": { |
| 954 "create": { |
| 955 "description": "Creates and sends out an ema
il invitation to access\nan Ad Exchange client buyer account.", |
| 956 "httpMethod": "POST", |
| 957 "id": "adexchangebuyer2.accounts.clients.inv
itations.create", |
| 958 "parameterOrder": [ |
| 959 "accountId", |
| 960 "clientAccountId" |
| 961 ], |
| 962 "parameters": { |
| 963 "clientAccountId": { |
| 964 "description": "Numerical account ID
of the client buyer that the user\nshould be associated with. (required)", |
| 965 "format": "int64", |
| 966 "location": "path", |
| 967 "required": true, |
| 968 "type": "string" |
| 969 }, |
| 970 "accountId": { |
| 971 "description": "Numerical account ID
of the client's sponsor buyer. (required)", |
| 972 "format": "int64", |
| 973 "location": "path", |
| 974 "required": true, |
| 975 "type": "string" |
| 976 } |
| 977 }, |
| 978 "path": "v2beta1/accounts/{accountId}/client
s/{clientAccountId}/invitations", |
| 979 "request": { |
| 980 "$ref": "ClientUserInvitation" |
| 981 }, |
| 982 "response": { |
| 983 "$ref": "ClientUserInvitation" |
| 984 }, |
| 985 "scopes": [ |
| 986 "https://www.googleapis.com/auth/adexcha
nge.buyer" |
| 987 ] |
| 988 }, |
| 989 "get": { |
| 990 "description": "Retrieves an existing client
user invitation.", |
| 991 "httpMethod": "GET", |
| 992 "id": "adexchangebuyer2.accounts.clients.inv
itations.get", |
| 993 "parameterOrder": [ |
| 994 "accountId", |
| 995 "clientAccountId", |
| 996 "invitationId" |
| 997 ], |
| 998 "parameters": { |
| 999 "clientAccountId": { |
| 1000 "description": "Numerical account ID
of the client buyer that the user invitation\nto be retrieved is associated wit
h. (required)", |
| 1001 "format": "int64", |
| 1002 "location": "path", |
| 1003 "required": true, |
| 1004 "type": "string" |
| 1005 }, |
| 1006 "invitationId": { |
| 1007 "description": "Numerical identifier
of the user invitation to retrieve. (required)", |
| 1008 "format": "int64", |
| 1009 "location": "path", |
| 1010 "required": true, |
| 1011 "type": "string" |
| 1012 }, |
| 1013 "accountId": { |
| 1014 "description": "Numerical account ID
of the client's sponsor buyer. (required)", |
| 1015 "format": "int64", |
| 1016 "location": "path", |
| 1017 "required": true, |
| 1018 "type": "string" |
| 1019 } |
| 1020 }, |
| 1021 "path": "v2beta1/accounts/{accountId}/client
s/{clientAccountId}/invitations/{invitationId}", |
| 1022 "response": { |
| 1023 "$ref": "ClientUserInvitation" |
| 1024 }, |
| 1025 "scopes": [ |
| 1026 "https://www.googleapis.com/auth/adexcha
nge.buyer" |
| 1027 ] |
| 1028 }, |
| 1029 "list": { |
| 1030 "description": "Lists all the client users i
nvitations for a client\nwith a given account ID.", |
| 1031 "httpMethod": "GET", |
| 1032 "id": "adexchangebuyer2.accounts.clients.inv
itations.list", |
| 1033 "parameterOrder": [ |
| 1034 "accountId", |
| 1035 "clientAccountId" |
| 1036 ], |
| 1037 "parameters": { |
| 1038 "clientAccountId": { |
| 1039 "description": "Numerical account ID
of the client buyer to list invitations for.\n(required)\nYou must either speci
fy a string representation of a\nnumerical account identifier or the `-` charact
er\nto list all the invitations for all the clients\nof a given sponsor buyer.", |
| 1040 "location": "path", |
| 1041 "required": true, |
| 1042 "type": "string" |
| 1043 }, |
| 1044 "pageSize": { |
| 1045 "description": "Requested page size.
Server may return fewer clients than requested.\nIf unspecified, server will pi
ck an appropriate default.", |
| 1046 "format": "int32", |
| 1047 "location": "query", |
| 1048 "type": "integer" |
| 1049 }, |
| 1050 "accountId": { |
| 1051 "description": "Numerical account ID
of the client's sponsor buyer. (required)", |
| 1052 "format": "int64", |
| 1053 "location": "path", |
| 1054 "required": true, |
| 1055 "type": "string" |
| 1056 }, |
| 1057 "pageToken": { |
| 1058 "description": "A token identifying
a page of results the server should return.\nTypically, this is the value of\nLi
stClientUserInvitationsResponse.nextPageToken\nreturned from the previous call t
o the\nclients.invitations.list\nmethod.", |
| 1059 "location": "query", |
| 1060 "type": "string" |
| 1061 } |
| 1062 }, |
| 1063 "path": "v2beta1/accounts/{accountId}/client
s/{clientAccountId}/invitations", |
| 1064 "response": { |
| 1065 "$ref": "ListClientUserInvitationsRespon
se" |
| 1066 }, |
| 1067 "scopes": [ |
| 1068 "https://www.googleapis.com/auth/adexcha
nge.buyer" |
| 1069 ] |
| 1070 } |
| 1071 } |
| 1072 } |
| 1073 } |
| 503 } | 1074 } |
| 504 } | 1075 } |
| 505 } | 1076 } |
| 506 }, | 1077 }, |
| 507 "revision": "20160621", | 1078 "revision": "20160714", |
| 508 "rootUrl": "https://adexchangebuyer.googleapis.com/", | 1079 "rootUrl": "https://adexchangebuyer.googleapis.com/", |
| 509 "schemas": { | 1080 "schemas": { |
| 1081 "BidMetrics": { |
| 1082 "description": "The set of metrics that are measured in numbers of b
ids, representing how\nmany bids were considered eligible at each stage of the b
idding funnel.", |
| 1083 "id": "BidMetrics", |
| 1084 "properties": { |
| 1085 "startTime": { |
| 1086 "description": "The timestamp marking the start of the range
(inclusive) for which data is\nincluded.", |
| 1087 "format": "google-datetime", |
| 1088 "type": "string" |
| 1089 }, |
| 1090 "endTime": { |
| 1091 "description": "The timestamp marking the end of the range (
exclusive) for which data is\nincluded.", |
| 1092 "format": "google-datetime", |
| 1093 "type": "string" |
| 1094 }, |
| 1095 "bids": { |
| 1096 "description": "The number of bids that Ad Exchange received
from the buyer.", |
| 1097 "format": "int64", |
| 1098 "type": "string" |
| 1099 }, |
| 1100 "bidsInAuction": { |
| 1101 "description": "The number of bids that were permitted to co
mpete in the auction.", |
| 1102 "format": "int64", |
| 1103 "type": "string" |
| 1104 }, |
| 1105 "impressionsWon": { |
| 1106 "description": "The number of bids that won an impression.", |
| 1107 "format": "int64", |
| 1108 "type": "string" |
| 1109 } |
| 1110 }, |
| 1111 "type": "object" |
| 1112 }, |
| 1113 "ListResponseErrorsResponse": { |
| 1114 "description": "Response message for listing all reasons that bid re
sponses resulted in an\nerror.", |
| 1115 "id": "ListResponseErrorsResponse", |
| 1116 "properties": { |
| 1117 "startTime": { |
| 1118 "description": "The timestamp marking the start of the range
(inclusive) for which data is\nincluded.", |
| 1119 "format": "google-datetime", |
| 1120 "type": "string" |
| 1121 }, |
| 1122 "endTime": { |
| 1123 "description": "The timestamp marking the end of the range (
exclusive) for which data is\nincluded.", |
| 1124 "format": "google-datetime", |
| 1125 "type": "string" |
| 1126 }, |
| 1127 "frequencies": { |
| 1128 "description": "List of all callout status IDs, identifying
the error in the bid responses,\nwith their associated impression counts.\nSee c
allout-status-codes.\nThere is a fixed set of statuses, hence results are not pa
ged.", |
| 1129 "items": { |
| 1130 "$ref": "CalloutStatusFrequency" |
| 1131 }, |
| 1132 "type": "array" |
| 1133 } |
| 1134 }, |
| 1135 "type": "object" |
| 1136 }, |
| 510 "ClientUser": { | 1137 "ClientUser": { |
| 511 "description": "A client user is created under a client buyer and ha
s restricted access to\nthe Ad Exchange Marketplace and certain other sections\n
of 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\nema
il invitation\n(see the\naccounts.clients.invitations.create\nmethod).\n\nAll fi
elds are required unless otherwise specified.", | 1138 "description": "A client user is created under a client buyer and ha
s restricted access to\nthe Ad Exchange Marketplace and certain other sections\n
of 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\nema
il invitation\n(see the\naccounts.clients.invitations.create\nmethod).\n\nAll fi
elds are required unless otherwise specified.", |
| 512 "id": "ClientUser", | 1139 "id": "ClientUser", |
| 513 "properties": { | 1140 "properties": { |
| 514 "email": { | 1141 "email": { |
| 515 "description": "User's email address. The value of this fiel
d\nis ignored in an update operation.", | 1142 "description": "User's email address. The value of this fiel
d\nis ignored in an update operation.", |
| 516 "type": "string" | 1143 "type": "string" |
| 517 }, | 1144 }, |
| 518 "clientAccountId": { | 1145 "clientAccountId": { |
| 519 "description": "Numerical account ID of the client buyer\nwi
th which the user is associated; the\nbuyer must be a client of the current spon
sor buyer.\nThe value of this field is ignored in an update operation.", | 1146 "description": "Numerical account ID of the client buyer\nwi
th which the user is associated; the\nbuyer must be a client of the current spon
sor buyer.\nThe value of this field is ignored in an update operation.", |
| (...skipping 16 matching lines...) Expand all Loading... |
| 536 ], | 1163 ], |
| 537 "type": "string" | 1164 "type": "string" |
| 538 }, | 1165 }, |
| 539 "userId": { | 1166 "userId": { |
| 540 "description": "The unique numerical ID of the client user\n
that has accepted an invitation.\nThe value of this field is ignored in an updat
e operation.", | 1167 "description": "The unique numerical ID of the client user\n
that has accepted an invitation.\nThe value of this field is ignored in an updat
e operation.", |
| 541 "format": "int64", | 1168 "format": "int64", |
| 542 "type": "string" | 1169 "type": "string" |
| 543 } | 1170 } |
| 544 }, | 1171 }, |
| 545 "type": "object" | 1172 "type": "object" |
| 1173 }, |
| 1174 "CreativeFrequency": { |
| 1175 "description": "The number of bids for a given creative.", |
| 1176 "id": "CreativeFrequency", |
| 1177 "properties": { |
| 1178 "creativeId": { |
| 1179 "description": "The ID of the creative.", |
| 1180 "type": "string" |
| 1181 }, |
| 1182 "bidCount": { |
| 1183 "description": "The number of bids associated with the speci
fied creative.", |
| 1184 "format": "int64", |
| 1185 "type": "string" |
| 1186 } |
| 1187 }, |
| 1188 "type": "object" |
| 1189 }, |
| 1190 "CreativeStatusFrequency": { |
| 1191 "description": "The number of bids with the specified creative statu
s.", |
| 1192 "id": "CreativeStatusFrequency", |
| 1193 "properties": { |
| 1194 "creativeStatusId": { |
| 1195 "description": "The ID of the creative status.\nSee creative
-status-codes.", |
| 1196 "format": "int32", |
| 1197 "type": "integer" |
| 1198 }, |
| 1199 "bidCount": { |
| 1200 "description": "The number of bids associated with the speci
fied status.", |
| 1201 "format": "int64", |
| 1202 "type": "string" |
| 1203 } |
| 1204 }, |
| 1205 "type": "object" |
| 1206 }, |
| 1207 "FilterSet": { |
| 1208 "description": "A set of filters that is applied to a request for da
ta from the\nRtbTroubleshootingService. Within a filter set, an AND operation is
performed\nacross the filters represented by each field. An OR operation is per
formed\nacross the filters represented by the multiple values of a repeated fiel
d.\nE.g.\n\"format=VIDEO AND deal_id=12 AND (web_property_id=34 OR web_property_
id=56)\"", |
| 1209 "id": "FilterSet", |
| 1210 "properties": { |
| 1211 "format": { |
| 1212 "description": "The format on which to filter; optional.", |
| 1213 "enum": [ |
| 1214 "FORMAT_UNSPECIFIED", |
| 1215 "DISPLAY", |
| 1216 "VIDEO" |
| 1217 ], |
| 1218 "enumDescriptions": [ |
| 1219 "A placeholder for an undefined format; indicates that n
o format filter\nwill be applied.", |
| 1220 "The ad impression is display format (i.e. an image).", |
| 1221 "The ad impression is video format." |
| 1222 ], |
| 1223 "type": "string" |
| 1224 }, |
| 1225 "relativeDateRange": { |
| 1226 "$ref": "RelativeDateRange", |
| 1227 "description": "A relative date range, defined by an offset
from today and a duration." |
| 1228 }, |
| 1229 "creativeId": { |
| 1230 "description": "The ID of the creative on which to filter; o
ptional.", |
| 1231 "type": "string" |
| 1232 }, |
| 1233 "dealId": { |
| 1234 "description": "The ID of the deal on which to filter; optio
nal.", |
| 1235 "format": "int64", |
| 1236 "type": "string" |
| 1237 }, |
| 1238 "buyerAccountId": { |
| 1239 "description": "The ID of the buyer account on which to filt
er; optional.", |
| 1240 "format": "int64", |
| 1241 "type": "string" |
| 1242 }, |
| 1243 "filterSetOwnerAccountId": { |
| 1244 "description": "The account ID of the buyer who owns this fi
lter set.\nThe value of this field is ignored in create operations.", |
| 1245 "format": "int64", |
| 1246 "type": "string" |
| 1247 }, |
| 1248 "absoluteDateRange": { |
| 1249 "$ref": "AbsoluteDateRange", |
| 1250 "description": "An absolute date range, defined by a start d
ate and an end date." |
| 1251 }, |
| 1252 "webPropertyIds": { |
| 1253 "description": "The list of IDs of web properties on which t
o filter; may be empty.\nThe filters represented by multiple web property IDs ar
e ORed together\n(i.e. if non-empty, results must match any one of the web prope
rties).", |
| 1254 "items": { |
| 1255 "format": "int64", |
| 1256 "type": "string" |
| 1257 }, |
| 1258 "type": "array" |
| 1259 }, |
| 1260 "platform": { |
| 1261 "description": "The platform on which to filter; optional.", |
| 1262 "enum": [ |
| 1263 "PLATFORM_UNSPECIFIED", |
| 1264 "DESKTOP", |
| 1265 "TABLET_WEB", |
| 1266 "TABLET_APP", |
| 1267 "MOBILE_WEB", |
| 1268 "MOBILE_APP" |
| 1269 ], |
| 1270 "enumDescriptions": [ |
| 1271 "A placeholder for an undefined platform; indicates that
no platform\nfilter will be applied.", |
| 1272 "The ad impression appears on a desktop.", |
| 1273 "The ad impression appears on a tablet, on the web.", |
| 1274 "The ad impression appears on a tablet, in an app.", |
| 1275 "The ad impression appears on a mobile device, on the we
b.", |
| 1276 "The ad impression appears on a mobile device, in an app
." |
| 1277 ], |
| 1278 "type": "string" |
| 1279 }, |
| 1280 "filterSetId": { |
| 1281 "description": "The ID of the filter set; unique within the
account of the filter set\nowner.\nThe value of this field is ignored in create
operations.", |
| 1282 "format": "int32", |
| 1283 "type": "integer" |
| 1284 } |
| 1285 }, |
| 1286 "type": "object" |
| 1287 }, |
| 1288 "RelativeDateRange": { |
| 1289 "description": "A relative date range, specified by an offset and a
duration.\nThe supported range of dates begins 30 days before today and ends tod
ay.\nI.e. the limits for these values are:\noffset_days >= 0\nduration_days >= 1
\noffset_days + duration_days <= 30", |
| 1290 "id": "RelativeDateRange", |
| 1291 "properties": { |
| 1292 "offsetDays": { |
| 1293 "description": "The end date of the filter set, specified as
the number of days before\ntoday. E.g. for a range where the last date is today
, 0.", |
| 1294 "format": "int32", |
| 1295 "type": "integer" |
| 1296 }, |
| 1297 "durationDays": { |
| 1298 "description": "The number of days in the requested date ran
ge. E.g. for a range spanning\ntoday, 1. For a range spanning the last 7 days, 7
.", |
| 1299 "format": "int32", |
| 1300 "type": "integer" |
| 1301 } |
| 1302 }, |
| 1303 "type": "object" |
| 1304 }, |
| 1305 "ListResponsesWithoutBidsResponse": { |
| 1306 "description": "Response message for listing all reasons that bid re
sponses were considered\nto have no applicable bids.", |
| 1307 "id": "ListResponsesWithoutBidsResponse", |
| 1308 "properties": { |
| 1309 "startTime": { |
| 1310 "description": "The timestamp marking the start of the range
(inclusive) for which data is\nincluded.", |
| 1311 "format": "google-datetime", |
| 1312 "type": "string" |
| 1313 }, |
| 1314 "endTime": { |
| 1315 "description": "The timestamp marking the end of the range (
exclusive) for which data is\nincluded.", |
| 1316 "format": "google-datetime", |
| 1317 "type": "string" |
| 1318 }, |
| 1319 "frequencies": { |
| 1320 "description": "List of all statuses with their associated i
mpression counts.\nThere is a fixed set of statuses, hence results are not paged
.", |
| 1321 "items": { |
| 1322 "$ref": "ResponsesWithoutBidsStatusFrequency" |
| 1323 }, |
| 1324 "type": "array" |
| 1325 } |
| 1326 }, |
| 1327 "type": "object" |
| 1328 }, |
| 1329 "ResponsesWithoutBidsStatusFrequency": { |
| 1330 "description": "The number of impressions for which the correspondin
g response had no\napplicable bids, as described by the specified status.", |
| 1331 "id": "ResponsesWithoutBidsStatusFrequency", |
| 1332 "properties": { |
| 1333 "impressionCount": { |
| 1334 "description": "The number of impressions associated with th
e specified status.", |
| 1335 "format": "int64", |
| 1336 "type": "string" |
| 1337 }, |
| 1338 "status": { |
| 1339 "description": "The status that caused the bid response to b
e considered to have no\napplicable bids.", |
| 1340 "enum": [ |
| 1341 "STATUS_UNSPECIFIED", |
| 1342 "RESPONSES_WITHOUT_BIDS", |
| 1343 "RESPONSES_WITHOUT_BIDS_FOR_ACCOUNT", |
| 1344 "RESPONSES_WITHOUT_BIDS_FOR_DEAL" |
| 1345 ], |
| 1346 "enumDescriptions": [ |
| 1347 "A placeholder for an undefined status.\nThis value will
never be returned in responses.", |
| 1348 "The response had no bids.", |
| 1349 "The response had no bids for the specified account, tho
ugh it may have\nincluded bids on behalf of other accounts.", |
| 1350 "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." |
| 1351 ], |
| 1352 "type": "string" |
| 1353 } |
| 1354 }, |
| 1355 "type": "object" |
| 1356 }, |
| 1357 "FilteredImpressionStatusFrequency": { |
| 1358 "description": "The number of impressions filtered due to the specif
ied status.", |
| 1359 "id": "FilteredImpressionStatusFrequency", |
| 1360 "properties": { |
| 1361 "impressionCount": { |
| 1362 "description": "The number of impressions associated with th
e specified status.", |
| 1363 "format": "int64", |
| 1364 "type": "string" |
| 1365 }, |
| 1366 "status": { |
| 1367 "description": "The status for which impressions were filter
ed.", |
| 1368 "enum": [ |
| 1369 "STATUS_UNSPECIFIED", |
| 1370 "PRETARGETING_CONFIGURATIONS" |
| 1371 ], |
| 1372 "enumDescriptions": [ |
| 1373 "A placeholder for an undefined status.\nThis value will
never be returned in responses.", |
| 1374 "The impression was filtered because it did not match th
e buyer's\npretargeting configurations." |
| 1375 ], |
| 1376 "type": "string" |
| 1377 } |
| 1378 }, |
| 1379 "type": "object" |
| 546 }, | 1380 }, |
| 547 "ClientUserInvitation": { | 1381 "ClientUserInvitation": { |
| 548 "description": "An invitation for a new client user to get access to
the AdExchange Buyer UI.\n\nAll fields are required unless otherwise specified.
", | 1382 "description": "An invitation for a new client user to get access to
the AdExchange Buyer UI.\n\nAll fields are required unless otherwise specified.
", |
| 549 "id": "ClientUserInvitation", | 1383 "id": "ClientUserInvitation", |
| 550 "properties": { | 1384 "properties": { |
| 551 "email": { | 1385 "email": { |
| 552 "description": "The email address to which the invitation is
sent. Email\naddresses should be unique among all client users under each spons
or\nbuyer.", | 1386 "description": "The email address to which the invitation is
sent. Email\naddresses should be unique among all client users under each spons
or\nbuyer.", |
| 553 "type": "string" | 1387 "type": "string" |
| 554 }, | 1388 }, |
| 555 "clientAccountId": { | 1389 "clientAccountId": { |
| 556 "description": "Numerical account ID of the client buyer\nth
at the invited user is associated with.\nThe value of this field is ignored in c
reate operations.", | 1390 "description": "Numerical account ID of the client buyer\nth
at the invited user is associated with.\nThe value of this field is ignored in c
reate operations.", |
| 557 "format": "int64", | 1391 "format": "int64", |
| 558 "type": "string" | 1392 "type": "string" |
| 559 }, | 1393 }, |
| 560 "invitationId": { | 1394 "invitationId": { |
| 561 "description": "The unique numerical ID of the invitation th
at is sent to the user.\nThe value of this field is ignored in create operations
.", | 1395 "description": "The unique numerical ID of the invitation th
at is sent to the user.\nThe value of this field is ignored in create operations
.", |
| 562 "format": "int64", | 1396 "format": "int64", |
| 563 "type": "string" | 1397 "type": "string" |
| 564 } | 1398 } |
| 565 }, | 1399 }, |
| 566 "type": "object" | 1400 "type": "object" |
| 567 }, | 1401 }, |
| 1402 "ListCreativeStatusBreakdownByCreativeResponse": { |
| 1403 "description": "Response message for listing all creatives associate
d with a given filtered\nbid reason.", |
| 1404 "id": "ListCreativeStatusBreakdownByCreativeResponse", |
| 1405 "properties": { |
| 1406 "startTime": { |
| 1407 "description": "The timestamp marking the start of the range
(inclusive) for which data is\nincluded.", |
| 1408 "format": "google-datetime", |
| 1409 "type": "string" |
| 1410 }, |
| 1411 "endTime": { |
| 1412 "description": "The timestamp marking the end of the range (
exclusive) for which data is\nincluded.", |
| 1413 "format": "google-datetime", |
| 1414 "type": "string" |
| 1415 }, |
| 1416 "creativeStatusId": { |
| 1417 "description": "The ID of the creative status that identifie
s the reason the bid was\nfiltered before the auction.\nSee creative-status-code
s.", |
| 1418 "format": "int32", |
| 1419 "type": "integer" |
| 1420 }, |
| 1421 "frequencies": { |
| 1422 "description": "List of creative IDs with their associated b
id counts.", |
| 1423 "items": { |
| 1424 "$ref": "CreativeFrequency" |
| 1425 }, |
| 1426 "type": "array" |
| 1427 }, |
| 1428 "nextPageToken": { |
| 1429 "description": "A token to retrieve the next page of results
.\nPass this value in the\nListCreativeStatusBreakdownByCreativeRequest.pageToke
n\nfield in the subsequent call to the\naccounts.filterSets.filteredBids.creativ
es.list\nmethod to retrieve the next page of results.", |
| 1430 "type": "string" |
| 1431 } |
| 1432 }, |
| 1433 "type": "object" |
| 1434 }, |
| 1435 "ImpressionMetrics": { |
| 1436 "description": "The set of metrics that are measured in numbers of i
mpressions, representing\nhow many impressions were considered eligible at each
stage of the bidding\nfunnel.", |
| 1437 "id": "ImpressionMetrics", |
| 1438 "properties": { |
| 1439 "responsesWithBids": { |
| 1440 "description": "The number of impressions for which Ad Excha
nge received a response from\nthe buyer that contained at least one applicable b
id.", |
| 1441 "format": "int64", |
| 1442 "type": "string" |
| 1443 }, |
| 1444 "inventoryMatches": { |
| 1445 "description": "The number of impressions that match the buy
er's inventory pretargeting.", |
| 1446 "format": "int64", |
| 1447 "type": "string" |
| 1448 }, |
| 1449 "endTime": { |
| 1450 "description": "The timestamp marking the end of the range (
exclusive) for which data is\nincluded.", |
| 1451 "format": "google-datetime", |
| 1452 "type": "string" |
| 1453 }, |
| 1454 "successfulResponses": { |
| 1455 "description": "The number of impressions for which the buye
r successfully sent a response\nto Ad Exchange.", |
| 1456 "format": "int64", |
| 1457 "type": "string" |
| 1458 }, |
| 1459 "startTime": { |
| 1460 "description": "The timestamp marking the start of the range
(inclusive) for which data is\nincluded.", |
| 1461 "format": "google-datetime", |
| 1462 "type": "string" |
| 1463 }, |
| 1464 "bidRequests": { |
| 1465 "description": "The number of impressions for which Ad Excha
nge sent the buyer a bid\nrequest.", |
| 1466 "format": "int64", |
| 1467 "type": "string" |
| 1468 }, |
| 1469 "availableImpressions": { |
| 1470 "description": "The number of impressions available to the b
uyer on Ad Exchange.\nIn some cases this value may be unavailable.", |
| 1471 "format": "int64", |
| 1472 "type": "string" |
| 1473 } |
| 1474 }, |
| 1475 "type": "object" |
| 1476 }, |
| 1477 "ListLosingBidsResponse": { |
| 1478 "description": "Response message for listing all reasons that bids l
ost in the auction.", |
| 1479 "id": "ListLosingBidsResponse", |
| 1480 "properties": { |
| 1481 "startTime": { |
| 1482 "description": "The timestamp marking the start of the range
(inclusive) for which data is\nincluded.", |
| 1483 "format": "google-datetime", |
| 1484 "type": "string" |
| 1485 }, |
| 1486 "endTime": { |
| 1487 "description": "The timestamp marking the end of the range (
exclusive) for which data is\nincluded.", |
| 1488 "format": "google-datetime", |
| 1489 "type": "string" |
| 1490 }, |
| 1491 "frequencies": { |
| 1492 "description": "List of all creative status IDs with their a
ssociated bid counts.\nSee creative-status-codes.\nThere is a fixed set of statu
ses, hence results are not paged.", |
| 1493 "items": { |
| 1494 "$ref": "CreativeStatusFrequency" |
| 1495 }, |
| 1496 "type": "array" |
| 1497 } |
| 1498 }, |
| 1499 "type": "object" |
| 1500 }, |
| 1501 "ListFilteredImpressionsResponse": { |
| 1502 "description": "Response message for listing all reasons that impres
sions were filtered (i.e.\nnot considered as an inventory match) for the buyer."
, |
| 1503 "id": "ListFilteredImpressionsResponse", |
| 1504 "properties": { |
| 1505 "startTime": { |
| 1506 "description": "The timestamp marking the start of the range
(inclusive) for which data is\nincluded.", |
| 1507 "format": "google-datetime", |
| 1508 "type": "string" |
| 1509 }, |
| 1510 "endTime": { |
| 1511 "description": "The timestamp marking the end of the range (
exclusive) for which data is\nincluded.", |
| 1512 "format": "google-datetime", |
| 1513 "type": "string" |
| 1514 }, |
| 1515 "frequencies": { |
| 1516 "description": "List of all statuses identifying the reason
the bid request was filtered,\nwith their associated impression counts.\nThere i
s a fixed set of statuses, hence results are not paged.", |
| 1517 "items": { |
| 1518 "$ref": "FilteredImpressionStatusFrequency" |
| 1519 }, |
| 1520 "type": "array" |
| 1521 } |
| 1522 }, |
| 1523 "type": "object" |
| 1524 }, |
| 1525 "AbsoluteDateRange": { |
| 1526 "description": "An absolute date range, specified by its start date
and end date.\nThe supported range of dates begins 30 days before today and ends
today.\nValidity checked upon filter set creation. If a filter set with an abso
lute\ndate range is run at a later date more than 30 days after start_date, it w
ill\nfail.", |
| 1527 "id": "AbsoluteDateRange", |
| 1528 "properties": { |
| 1529 "startDate": { |
| 1530 "$ref": "Date", |
| 1531 "description": "The start date of the range (inclusive).\nMu
st be within the 30 days leading up to current date, and must be equal to\nor be
fore end_date." |
| 1532 }, |
| 1533 "endDate": { |
| 1534 "$ref": "Date", |
| 1535 "description": "The end date of the range (inclusive).\nMust
be within the 30 days leading up to current date, and must be equal to\nor afte
r start_date." |
| 1536 } |
| 1537 }, |
| 1538 "type": "object" |
| 1539 }, |
| 1540 "ListFilteredRequestsResponse": { |
| 1541 "description": "Response message for listing all reasons that bid re
quests were filtered and\nnot sent to the buyer.", |
| 1542 "id": "ListFilteredRequestsResponse", |
| 1543 "properties": { |
| 1544 "startTime": { |
| 1545 "description": "The timestamp marking the start of the range
(inclusive) for which data is\nincluded.", |
| 1546 "format": "google-datetime", |
| 1547 "type": "string" |
| 1548 }, |
| 1549 "endTime": { |
| 1550 "description": "The timestamp marking the end of the range (
exclusive) for which data is\nincluded.", |
| 1551 "format": "google-datetime", |
| 1552 "type": "string" |
| 1553 }, |
| 1554 "frequencies": { |
| 1555 "description": "List of all callout status IDs, identifying
the reason the bid request was\nfiltered, with their associated impression count
s.\nSee callout-status-codes.\nThere is a fixed set of statuses, hence results a
re not paged.", |
| 1556 "items": { |
| 1557 "$ref": "CalloutStatusFrequency" |
| 1558 }, |
| 1559 "type": "array" |
| 1560 } |
| 1561 }, |
| 1562 "type": "object" |
| 1563 }, |
| 1564 "ListFilterSetsResponse": { |
| 1565 "description": "Response message for listing filter sets.", |
| 1566 "id": "ListFilterSetsResponse", |
| 1567 "properties": { |
| 1568 "filterSets": { |
| 1569 "description": "The filter sets belonging to the buyer.", |
| 1570 "items": { |
| 1571 "$ref": "FilterSet" |
| 1572 }, |
| 1573 "type": "array" |
| 1574 }, |
| 1575 "nextPageToken": { |
| 1576 "description": "A token to retrieve the next page of results
.\nPass this value in the\nListFilterSetsRequest.pageToken\nfield in the subsequ
ent call to the\naccounts.filterSets.list\nmethod to retrieve the next page of r
esults.", |
| 1577 "type": "string" |
| 1578 } |
| 1579 }, |
| 1580 "type": "object" |
| 1581 }, |
| 568 "ListClientUserInvitationsResponse": { | 1582 "ListClientUserInvitationsResponse": { |
| 569 "id": "ListClientUserInvitationsResponse", | 1583 "id": "ListClientUserInvitationsResponse", |
| 570 "properties": { | 1584 "properties": { |
| 571 "nextPageToken": { | 1585 "nextPageToken": { |
| 572 "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 nex
t\npage of results.", | 1586 "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 nex
t\npage of results.", |
| 573 "type": "string" | 1587 "type": "string" |
| 574 }, | 1588 }, |
| 575 "invitations": { | 1589 "invitations": { |
| 576 "description": "The returned list of client users.", | 1590 "description": "The returned list of client users.", |
| 577 "items": { | 1591 "items": { |
| 578 "$ref": "ClientUserInvitation" | 1592 "$ref": "ClientUserInvitation" |
| 579 }, | 1593 }, |
| 580 "type": "array" | 1594 "type": "array" |
| 581 } | 1595 } |
| 582 }, | 1596 }, |
| 583 "type": "object" | 1597 "type": "object" |
| 584 }, | 1598 }, |
| 1599 "CalloutStatusFrequency": { |
| 1600 "description": "The number of impressions for which the correspondin
g callouts had the\nspecified status.", |
| 1601 "id": "CalloutStatusFrequency", |
| 1602 "properties": { |
| 1603 "impressionCount": { |
| 1604 "description": "The number of impressions associated with th
e specified status.", |
| 1605 "format": "int64", |
| 1606 "type": "string" |
| 1607 }, |
| 1608 "calloutStatusId": { |
| 1609 "description": "The ID of the callout status.\nSee callout-s
tatus-codes.", |
| 1610 "format": "int32", |
| 1611 "type": "integer" |
| 1612 } |
| 1613 }, |
| 1614 "type": "object" |
| 1615 }, |
| 1616 "DetailFrequency": { |
| 1617 "description": "The number of bids, among those with a given creativ
e status, that had the\nspecified detail.", |
| 1618 "id": "DetailFrequency", |
| 1619 "properties": { |
| 1620 "detailId": { |
| 1621 "description": "The ID of the detail. The associated value c
an be looked up in the\ndictionary file corresponding to the DetailType in the r
esponse message.", |
| 1622 "format": "int32", |
| 1623 "type": "integer" |
| 1624 }, |
| 1625 "bidCount": { |
| 1626 "description": "The number of bids associated with the speci
fied detail.", |
| 1627 "format": "int64", |
| 1628 "type": "string" |
| 1629 } |
| 1630 }, |
| 1631 "type": "object" |
| 1632 }, |
| 1633 "ListCreativeStatusAndCreativeBreakdownByDetailResponse": { |
| 1634 "description": "Response message for listing all details associated
with a given filtered bid\nreason and a given creative.", |
| 1635 "id": "ListCreativeStatusAndCreativeBreakdownByDetailResponse", |
| 1636 "properties": { |
| 1637 "creativeId": { |
| 1638 "description": "The ID of the creative associated with a bid
filtered from the auction.", |
| 1639 "type": "string" |
| 1640 }, |
| 1641 "endTime": { |
| 1642 "description": "The timestamp marking the end of the range (
exclusive) for which data is\nincluded.", |
| 1643 "format": "google-datetime", |
| 1644 "type": "string" |
| 1645 }, |
| 1646 "detailType": { |
| 1647 "description": "The type of detail that the detail IDs repre
sent.", |
| 1648 "enum": [ |
| 1649 "TYPE_UNSPECIFIED", |
| 1650 "CREATIVE_ATTRIBUTE", |
| 1651 "VENDOR", |
| 1652 "SENSITIVE_CATEGORY", |
| 1653 "PRODUCT_CATEGORY" |
| 1654 ], |
| 1655 "enumDescriptions": [ |
| 1656 "A placeholder for an undefined status.\nThis value will
never be returned in responses.", |
| 1657 "Indicates that the detail ID refers to a creative attri
bute; see\npublisher-excludable-creative-attributes.", |
| 1658 "Indicates that the detail ID refers to a vendor; see\nv
endors.", |
| 1659 "Indicates that the detail ID refers to a sensitive cate
gory; see\nad-sensitive-categories.", |
| 1660 "Indicates that the detail ID refers to a product catego
ry; see\nad-product-categories." |
| 1661 ], |
| 1662 "type": "string" |
| 1663 }, |
| 1664 "frequencies": { |
| 1665 "description": "List of all detail IDs with their associated
bid counts.\nThere is a fixed set of details, hence results are not paged.", |
| 1666 "items": { |
| 1667 "$ref": "DetailFrequency" |
| 1668 }, |
| 1669 "type": "array" |
| 1670 }, |
| 1671 "startTime": { |
| 1672 "description": "The timestamp marking the start of the range
(inclusive) for which data is\nincluded.", |
| 1673 "format": "google-datetime", |
| 1674 "type": "string" |
| 1675 }, |
| 1676 "creativeStatusId": { |
| 1677 "description": "The ID of the creative status that identifie
s the reason the bid was\nfiltered before the auction.\nSee creative-status-code
s.", |
| 1678 "format": "int32", |
| 1679 "type": "integer" |
| 1680 } |
| 1681 }, |
| 1682 "type": "object" |
| 1683 }, |
| 1684 "Empty": { |
| 1685 "description": "A generic empty message that you can re-use to avoid
defining duplicated\nempty messages in your APIs. A typical example is to use i
t as the request\nor the response type of an API method. For instance:\n\n se
rvice Foo {\n rpc Bar(google.protobuf.Empty) returns (google.protobuf.Empty
);\n }\n\nThe JSON representation for `Empty` is empty JSON object `{}`.", |
| 1686 "id": "Empty", |
| 1687 "properties": {}, |
| 1688 "type": "object" |
| 1689 }, |
| 585 "ListClientUsersResponse": { | 1690 "ListClientUsersResponse": { |
| 586 "id": "ListClientUsersResponse", | 1691 "id": "ListClientUsersResponse", |
| 587 "properties": { | 1692 "properties": { |
| 588 "users": { | 1693 "users": { |
| 589 "description": "The returned list of client users.", | 1694 "description": "The returned list of client users.", |
| 590 "items": { | 1695 "items": { |
| 591 "$ref": "ClientUser" | 1696 "$ref": "ClientUser" |
| 592 }, | 1697 }, |
| 593 "type": "array" | 1698 "type": "array" |
| 594 }, | 1699 }, |
| 595 "nextPageToken": { | 1700 "nextPageToken": { |
| 596 "description": "A token to retrieve the next page of results
.\nPass this value in the\nListClientUsersRequest.pageToken\nfield in the subseq
uent call to the\nclients.invitations.list\nmethod to retrieve the next\npage of
results.", | 1701 "description": "A token to retrieve the next page of results
.\nPass this value in the\nListClientUsersRequest.pageToken\nfield in the subseq
uent call to the\nclients.invitations.list\nmethod to retrieve the next\npage of
results.", |
| 597 "type": "string" | 1702 "type": "string" |
| 598 } | 1703 } |
| 599 }, | 1704 }, |
| 600 "type": "object" | 1705 "type": "object" |
| 601 }, | 1706 }, |
| 1707 "ListCreativeStatusBreakdownByDetailResponse": { |
| 1708 "description": "Response message for listing all details associated
with a given filtered bid\nreason.", |
| 1709 "id": "ListCreativeStatusBreakdownByDetailResponse", |
| 1710 "properties": { |
| 1711 "startTime": { |
| 1712 "description": "The timestamp marking the start of the range
(inclusive) for which data is\nincluded.", |
| 1713 "format": "google-datetime", |
| 1714 "type": "string" |
| 1715 }, |
| 1716 "endTime": { |
| 1717 "description": "The timestamp marking the end of the range (
exclusive) for which data is\nincluded.", |
| 1718 "format": "google-datetime", |
| 1719 "type": "string" |
| 1720 }, |
| 1721 "creativeStatusId": { |
| 1722 "description": "The ID of the creative status that identifie
s the reason the bid was\nfiltered before the auction.\nSee creative-status-code
s.", |
| 1723 "format": "int32", |
| 1724 "type": "integer" |
| 1725 }, |
| 1726 "frequencies": { |
| 1727 "description": "List of all detail IDs with their associated
bid counts.\nThere is a fixed set of details, hence results are not paged.", |
| 1728 "items": { |
| 1729 "$ref": "DetailFrequency" |
| 1730 }, |
| 1731 "type": "array" |
| 1732 }, |
| 1733 "detailType": { |
| 1734 "description": "The type of detail that the detail IDs repre
sent.", |
| 1735 "enum": [ |
| 1736 "TYPE_UNSPECIFIED", |
| 1737 "CREATIVE_ATTRIBUTE", |
| 1738 "VENDOR", |
| 1739 "SENSITIVE_CATEGORY", |
| 1740 "PRODUCT_CATEGORY" |
| 1741 ], |
| 1742 "enumDescriptions": [ |
| 1743 "A placeholder for an undefined status.\nThis value will
never be returned in responses.", |
| 1744 "Indicates that the detail ID refers to a creative attri
bute; see\npublisher-excludable-creative-attributes.", |
| 1745 "Indicates that the detail ID refers to a vendor; see\nv
endors.", |
| 1746 "Indicates that the detail ID refers to a sensitive cate
gory; see\nad-sensitive-categories.", |
| 1747 "Indicates that the detail ID refers to a product catego
ry; see\nad-product-categories." |
| 1748 ], |
| 1749 "type": "string" |
| 1750 } |
| 1751 }, |
| 1752 "type": "object" |
| 1753 }, |
| 602 "Client": { | 1754 "Client": { |
| 603 "description": "A client resource represents a client buyer—an
agency,\na brand, or an advertiser customer of the sponsor buyer.\nUsers associ
ated with the client buyer have restricted access to\nthe Ad Exchange Marketplac
e and certain other sections\nof the Ad Exchange Buyer UI based on the role\ngra
nted to the client buyer.\nAll fields are required unless otherwise specified.", | 1755 "description": "A client resource represents a client buyer—an
agency,\na brand, or an advertiser customer of the sponsor buyer.\nUsers associ
ated with the client buyer have restricted access to\nthe Ad Exchange Marketplac
e and certain other sections\nof the Ad Exchange Buyer UI based on the role\ngra
nted to the client buyer.\nAll fields are required unless otherwise specified.", |
| 604 "id": "Client", | 1756 "id": "Client", |
| 605 "properties": { | 1757 "properties": { |
| 606 "visibleToSeller": { | 1758 "visibleToSeller": { |
| 607 "description": "Whether the client buyer will be visible to
sellers.", | 1759 "description": "Whether the client buyer will be visible to
sellers.", |
| 608 "type": "boolean" | 1760 "type": "boolean" |
| 609 }, | 1761 }, |
| 610 "status": { | 1762 "status": { |
| 611 "description": "The status of the client buyer.", | 1763 "description": "The status of the client buyer.", |
| (...skipping 55 matching lines...) Expand 10 before | Expand all | Expand 10 after Loading... |
| 667 "format": "int64", | 1819 "format": "int64", |
| 668 "type": "string" | 1820 "type": "string" |
| 669 }, | 1821 }, |
| 670 "entityName": { | 1822 "entityName": { |
| 671 "description": "The name of the entity. This field is automa
tically fetched based on\nthe type and ID.\nThe value of this field is ignored i
n create and update operations.", | 1823 "description": "The name of the entity. This field is automa
tically fetched based on\nthe type and ID.\nThe value of this field is ignored i
n create and update operations.", |
| 672 "type": "string" | 1824 "type": "string" |
| 673 } | 1825 } |
| 674 }, | 1826 }, |
| 675 "type": "object" | 1827 "type": "object" |
| 676 }, | 1828 }, |
| 1829 "Date": { |
| 1830 "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 signi
ficant. The date\nis relative to the Proleptic Gregorian Calendar. The day may b
e 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 independe
nt\nof year, e.g. anniversary date. Related types are google.type.TimeOfDay\nand
`google.protobuf.Timestamp`.", |
| 1831 "id": "Date", |
| 1832 "properties": { |
| 1833 "month": { |
| 1834 "description": "Month of year. Must be from 1 to 12.", |
| 1835 "format": "int32", |
| 1836 "type": "integer" |
| 1837 }, |
| 1838 "year": { |
| 1839 "description": "Year of date. Must be from 1 to 9999, or 0 i
f specifying a date without\na year.", |
| 1840 "format": "int32", |
| 1841 "type": "integer" |
| 1842 }, |
| 1843 "day": { |
| 1844 "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 s
ignificant.", |
| 1845 "format": "int32", |
| 1846 "type": "integer" |
| 1847 } |
| 1848 }, |
| 1849 "type": "object" |
| 1850 }, |
| 1851 "ListFilteredBidsResponse": { |
| 1852 "description": "Response message for listing all reasons that bids w
ere filtered from the\nauction.", |
| 1853 "id": "ListFilteredBidsResponse", |
| 1854 "properties": { |
| 1855 "startTime": { |
| 1856 "description": "The timestamp marking the start of the range
(inclusive) for which data is\nincluded.", |
| 1857 "format": "google-datetime", |
| 1858 "type": "string" |
| 1859 }, |
| 1860 "endTime": { |
| 1861 "description": "The timestamp marking the end of the range (
exclusive) for which data is\nincluded.", |
| 1862 "format": "google-datetime", |
| 1863 "type": "string" |
| 1864 }, |
| 1865 "frequencies": { |
| 1866 "description": "List of all creative status IDs, identifying
the reason the bids were\nfiltered from the auction, with their associated bid
counts.\nSee creative-status-codes.\nThere is a fixed set of statuses, hence res
ults are not paged.", |
| 1867 "items": { |
| 1868 "$ref": "CreativeStatusFrequency" |
| 1869 }, |
| 1870 "type": "array" |
| 1871 } |
| 1872 }, |
| 1873 "type": "object" |
| 1874 }, |
| 677 "ListClientsResponse": { | 1875 "ListClientsResponse": { |
| 678 "id": "ListClientsResponse", | 1876 "id": "ListClientsResponse", |
| 679 "properties": { | 1877 "properties": { |
| 680 "nextPageToken": { | 1878 "nextPageToken": { |
| 681 "description": "A token to retrieve the next page of results
.\nPass this value in the\nListClientsRequest.pageToken\nfield in the subsequent
call to the\naccounts.clients.list method\nto retrieve the next page of results
.", | 1879 "description": "A token to retrieve the next page of results
.\nPass this value in the\nListClientsRequest.pageToken\nfield in the subsequent
call to the\naccounts.clients.list method\nto retrieve the next page of results
.", |
| 682 "type": "string" | 1880 "type": "string" |
| 683 }, | 1881 }, |
| 684 "clients": { | 1882 "clients": { |
| 685 "description": "The returned list of clients.", | 1883 "description": "The returned list of clients.", |
| 686 "items": { | 1884 "items": { |
| 687 "$ref": "Client" | 1885 "$ref": "Client" |
| 688 }, | 1886 }, |
| 689 "type": "array" | 1887 "type": "array" |
| 690 } | 1888 } |
| 691 }, | 1889 }, |
| 692 "type": "object" | 1890 "type": "object" |
| 693 } | 1891 } |
| 694 }, | 1892 }, |
| 695 "servicePath": "", | 1893 "servicePath": "", |
| 696 "title": "Ad Exchange Buyer API II", | 1894 "title": "Ad Exchange Buyer API II", |
| 697 "version": "v2beta1" | 1895 "version": "v2beta1" |
| 698 } | 1896 } |
| OLD | NEW |