openapi-directory
Version:
Building & bundling https://github.com/APIs-guru/openapi-directory for easy use from JS
1 lines • 181 kB
JSON
{"openapi":"3.0.0","servers":[{"url":"https://adexchangebuyer.googleapis.com/"}],"info":{"contact":{"name":"Google","url":"https://google.com","x-twitter":"youtube"},"description":"Accesses the latest features for managing Authorized Buyers accounts, Real-Time Bidding configurations and auction metrics, and Marketplace programmatic deals.","license":{"name":"Creative Commons Attribution 3.0","url":"http://creativecommons.org/licenses/by/3.0/"},"termsOfService":"https://developers.google.com/terms/","title":"Ad Exchange Buyer API II","version":"v2beta1","x-apisguru-categories":["analytics","media"],"x-logo":{"url":"https://upload.wikimedia.org/wikipedia/commons/e/e1/YouTube_play_buttom_icon_%282013-2017%29.svg"},"x-origin":[{"format":"google","url":"https://adexchangebuyer.googleapis.com/$discovery/rest?version=v2beta1","version":"v1"}],"x-providerName":"googleapis.com","x-serviceName":"adexchangebuyer2"},"externalDocs":{"url":"https://developers.google.com/authorized-buyers/apis/reference/rest/"},"tags":[{"name":"accounts"},{"name":"bidders"},{"name":"buyers"}],"paths":{"/v2beta1/accounts/{accountId}/clients":{"get":{"description":"Lists all the clients for the current sponsor buyer.","operationId":"adexchangebuyer2.accounts.clients.list","parameters":[{"description":"Unique numerical account ID of the sponsor buyer to list the clients for.","in":"path","name":"accountId","required":true,"schema":{"type":"string"}},{"description":"Requested page size. The server may return fewer clients than requested. If unspecified, the server will pick an appropriate default.","in":"query","name":"pageSize","schema":{"type":"integer"}},{"description":"A token identifying a page of results the server should return. Typically, this is the value of ListClientsResponse.nextPageToken returned from the previous call to the accounts.clients.list method.","in":"query","name":"pageToken","schema":{"type":"string"}},{"description":"Optional unique identifier (from the standpoint of an Ad Exchange sponsor buyer partner) of the client to return. If specified, at most one client will be returned in the response.","in":"query","name":"partnerClientId","schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ListClientsResponse"}}},"description":"Successful response"}},"security":[{"Oauth2":["https://www.googleapis.com/auth/adexchange.buyer"],"Oauth2c":["https://www.googleapis.com/auth/adexchange.buyer"]}],"tags":["accounts"]},"parameters":[{"$ref":"#/components/parameters/_.xgafv"},{"$ref":"#/components/parameters/access_token"},{"$ref":"#/components/parameters/alt"},{"$ref":"#/components/parameters/callback"},{"$ref":"#/components/parameters/fields"},{"$ref":"#/components/parameters/key"},{"$ref":"#/components/parameters/oauth_token"},{"$ref":"#/components/parameters/prettyPrint"},{"$ref":"#/components/parameters/quotaUser"},{"$ref":"#/components/parameters/upload_protocol"},{"$ref":"#/components/parameters/uploadType"}],"post":{"description":"Creates a new client buyer.","operationId":"adexchangebuyer2.accounts.clients.create","parameters":[{"description":"Unique numerical account ID for the buyer of which the client buyer is a customer; the sponsor buyer to create a client for. (required)","in":"path","name":"accountId","required":true,"schema":{"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Client"}}}},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Client"}}},"description":"Successful response"}},"security":[{"Oauth2":["https://www.googleapis.com/auth/adexchange.buyer"],"Oauth2c":["https://www.googleapis.com/auth/adexchange.buyer"]}],"tags":["accounts"]}},"/v2beta1/accounts/{accountId}/clients/{clientAccountId}":{"get":{"description":"Gets a client buyer with a given client account ID.","operationId":"adexchangebuyer2.accounts.clients.get","parameters":[{"description":"Numerical account ID of the client's sponsor buyer. (required)","in":"path","name":"accountId","required":true,"schema":{"type":"string"}},{"description":"Numerical account ID of the client buyer to retrieve. (required)","in":"path","name":"clientAccountId","required":true,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Client"}}},"description":"Successful response"}},"security":[{"Oauth2":["https://www.googleapis.com/auth/adexchange.buyer"],"Oauth2c":["https://www.googleapis.com/auth/adexchange.buyer"]}],"tags":["accounts"]},"parameters":[{"$ref":"#/components/parameters/_.xgafv"},{"$ref":"#/components/parameters/access_token"},{"$ref":"#/components/parameters/alt"},{"$ref":"#/components/parameters/callback"},{"$ref":"#/components/parameters/fields"},{"$ref":"#/components/parameters/key"},{"$ref":"#/components/parameters/oauth_token"},{"$ref":"#/components/parameters/prettyPrint"},{"$ref":"#/components/parameters/quotaUser"},{"$ref":"#/components/parameters/upload_protocol"},{"$ref":"#/components/parameters/uploadType"}],"put":{"description":"Updates an existing client buyer.","operationId":"adexchangebuyer2.accounts.clients.update","parameters":[{"description":"Unique numerical account ID for the buyer of which the client buyer is a customer; the sponsor buyer to update a client for. (required)","in":"path","name":"accountId","required":true,"schema":{"type":"string"}},{"description":"Unique numerical account ID of the client to update. (required)","in":"path","name":"clientAccountId","required":true,"schema":{"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Client"}}}},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Client"}}},"description":"Successful response"}},"security":[{"Oauth2":["https://www.googleapis.com/auth/adexchange.buyer"],"Oauth2c":["https://www.googleapis.com/auth/adexchange.buyer"]}],"tags":["accounts"]}},"/v2beta1/accounts/{accountId}/clients/{clientAccountId}/invitations":{"get":{"description":"Lists all the client users invitations for a client with a given account ID.","operationId":"adexchangebuyer2.accounts.clients.invitations.list","parameters":[{"description":"Numerical account ID of the client's sponsor buyer. (required)","in":"path","name":"accountId","required":true,"schema":{"type":"string"}},{"description":"Numerical account ID of the client buyer to list invitations for. (required) You must either specify a string representation of a numerical account identifier or the `-` character to list all the invitations for all the clients of a given sponsor buyer.","in":"path","name":"clientAccountId","required":true,"schema":{"type":"string"}},{"description":"Requested page size. Server may return fewer clients than requested. If unspecified, server will pick an appropriate default.","in":"query","name":"pageSize","schema":{"type":"integer"}},{"description":"A token identifying a page of results the server should return. Typically, this is the value of ListClientUserInvitationsResponse.nextPageToken returned from the previous call to the clients.invitations.list method.","in":"query","name":"pageToken","schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ListClientUserInvitationsResponse"}}},"description":"Successful response"}},"security":[{"Oauth2":["https://www.googleapis.com/auth/adexchange.buyer"],"Oauth2c":["https://www.googleapis.com/auth/adexchange.buyer"]}],"tags":["accounts"]},"parameters":[{"$ref":"#/components/parameters/_.xgafv"},{"$ref":"#/components/parameters/access_token"},{"$ref":"#/components/parameters/alt"},{"$ref":"#/components/parameters/callback"},{"$ref":"#/components/parameters/fields"},{"$ref":"#/components/parameters/key"},{"$ref":"#/components/parameters/oauth_token"},{"$ref":"#/components/parameters/prettyPrint"},{"$ref":"#/components/parameters/quotaUser"},{"$ref":"#/components/parameters/upload_protocol"},{"$ref":"#/components/parameters/uploadType"}],"post":{"description":"Creates and sends out an email invitation to access an Ad Exchange client buyer account.","operationId":"adexchangebuyer2.accounts.clients.invitations.create","parameters":[{"description":"Numerical account ID of the client's sponsor buyer. (required)","in":"path","name":"accountId","required":true,"schema":{"type":"string"}},{"description":"Numerical account ID of the client buyer that the user should be associated with. (required)","in":"path","name":"clientAccountId","required":true,"schema":{"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ClientUserInvitation"}}}},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ClientUserInvitation"}}},"description":"Successful response"}},"security":[{"Oauth2":["https://www.googleapis.com/auth/adexchange.buyer"],"Oauth2c":["https://www.googleapis.com/auth/adexchange.buyer"]}],"tags":["accounts"]}},"/v2beta1/accounts/{accountId}/clients/{clientAccountId}/invitations/{invitationId}":{"get":{"description":"Retrieves an existing client user invitation.","operationId":"adexchangebuyer2.accounts.clients.invitations.get","parameters":[{"description":"Numerical account ID of the client's sponsor buyer. (required)","in":"path","name":"accountId","required":true,"schema":{"type":"string"}},{"description":"Numerical account ID of the client buyer that the user invitation to be retrieved is associated with. (required)","in":"path","name":"clientAccountId","required":true,"schema":{"type":"string"}},{"description":"Numerical identifier of the user invitation to retrieve. (required)","in":"path","name":"invitationId","required":true,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ClientUserInvitation"}}},"description":"Successful response"}},"security":[{"Oauth2":["https://www.googleapis.com/auth/adexchange.buyer"],"Oauth2c":["https://www.googleapis.com/auth/adexchange.buyer"]}],"tags":["accounts"]},"parameters":[{"$ref":"#/components/parameters/_.xgafv"},{"$ref":"#/components/parameters/access_token"},{"$ref":"#/components/parameters/alt"},{"$ref":"#/components/parameters/callback"},{"$ref":"#/components/parameters/fields"},{"$ref":"#/components/parameters/key"},{"$ref":"#/components/parameters/oauth_token"},{"$ref":"#/components/parameters/prettyPrint"},{"$ref":"#/components/parameters/quotaUser"},{"$ref":"#/components/parameters/upload_protocol"},{"$ref":"#/components/parameters/uploadType"}]},"/v2beta1/accounts/{accountId}/clients/{clientAccountId}/users":{"get":{"description":"Lists all the known client users for a specified sponsor buyer account ID.","operationId":"adexchangebuyer2.accounts.clients.users.list","parameters":[{"description":"Numerical account ID of the sponsor buyer of the client to list users for. (required)","in":"path","name":"accountId","required":true,"schema":{"type":"string"}},{"description":"The account ID of the client buyer to list users for. (required) You must specify either a string representation of a numerical account identifier or the `-` character to list all the client users for all the clients of a given sponsor buyer.","in":"path","name":"clientAccountId","required":true,"schema":{"type":"string"}},{"description":"Requested page size. The server may return fewer clients than requested. If unspecified, the server will pick an appropriate default.","in":"query","name":"pageSize","schema":{"type":"integer"}},{"description":"A token identifying a page of results the server should return. Typically, this is the value of ListClientUsersResponse.nextPageToken returned from the previous call to the accounts.clients.users.list method.","in":"query","name":"pageToken","schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ListClientUsersResponse"}}},"description":"Successful response"}},"security":[{"Oauth2":["https://www.googleapis.com/auth/adexchange.buyer"],"Oauth2c":["https://www.googleapis.com/auth/adexchange.buyer"]}],"tags":["accounts"]},"parameters":[{"$ref":"#/components/parameters/_.xgafv"},{"$ref":"#/components/parameters/access_token"},{"$ref":"#/components/parameters/alt"},{"$ref":"#/components/parameters/callback"},{"$ref":"#/components/parameters/fields"},{"$ref":"#/components/parameters/key"},{"$ref":"#/components/parameters/oauth_token"},{"$ref":"#/components/parameters/prettyPrint"},{"$ref":"#/components/parameters/quotaUser"},{"$ref":"#/components/parameters/upload_protocol"},{"$ref":"#/components/parameters/uploadType"}]},"/v2beta1/accounts/{accountId}/clients/{clientAccountId}/users/{userId}":{"get":{"description":"Retrieves an existing client user.","operationId":"adexchangebuyer2.accounts.clients.users.get","parameters":[{"description":"Numerical account ID of the client's sponsor buyer. (required)","in":"path","name":"accountId","required":true,"schema":{"type":"string"}},{"description":"Numerical account ID of the client buyer that the user to be retrieved is associated with. (required)","in":"path","name":"clientAccountId","required":true,"schema":{"type":"string"}},{"description":"Numerical identifier of the user to retrieve. (required)","in":"path","name":"userId","required":true,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ClientUser"}}},"description":"Successful response"}},"security":[{"Oauth2":["https://www.googleapis.com/auth/adexchange.buyer"],"Oauth2c":["https://www.googleapis.com/auth/adexchange.buyer"]}],"tags":["accounts"]},"parameters":[{"$ref":"#/components/parameters/_.xgafv"},{"$ref":"#/components/parameters/access_token"},{"$ref":"#/components/parameters/alt"},{"$ref":"#/components/parameters/callback"},{"$ref":"#/components/parameters/fields"},{"$ref":"#/components/parameters/key"},{"$ref":"#/components/parameters/oauth_token"},{"$ref":"#/components/parameters/prettyPrint"},{"$ref":"#/components/parameters/quotaUser"},{"$ref":"#/components/parameters/upload_protocol"},{"$ref":"#/components/parameters/uploadType"}],"put":{"description":"Updates an existing client user. Only the user status can be changed on update.","operationId":"adexchangebuyer2.accounts.clients.users.update","parameters":[{"description":"Numerical account ID of the client's sponsor buyer. (required)","in":"path","name":"accountId","required":true,"schema":{"type":"string"}},{"description":"Numerical account ID of the client buyer that the user to be retrieved is associated with. (required)","in":"path","name":"clientAccountId","required":true,"schema":{"type":"string"}},{"description":"Numerical identifier of the user to retrieve. (required)","in":"path","name":"userId","required":true,"schema":{"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ClientUser"}}}},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ClientUser"}}},"description":"Successful response"}},"security":[{"Oauth2":["https://www.googleapis.com/auth/adexchange.buyer"],"Oauth2c":["https://www.googleapis.com/auth/adexchange.buyer"]}],"tags":["accounts"]}},"/v2beta1/accounts/{accountId}/creatives":{"get":{"description":"Lists creatives.","operationId":"adexchangebuyer2.accounts.creatives.list","parameters":[{"description":"The account to list the creatives from. Specify \"-\" to list all creatives the current user has access to.","in":"path","name":"accountId","required":true,"schema":{"type":"string"}},{"description":"Requested page size. The server may return fewer creatives than requested (due to timeout constraint) even if more are available through another call. If unspecified, server will pick an appropriate default. Acceptable values are 1 to 1000, inclusive.","in":"query","name":"pageSize","schema":{"type":"integer"}},{"description":"A token identifying a page of results the server should return. Typically, this is the value of ListCreativesResponse.next_page_token returned from the previous call to 'ListCreatives' method.","in":"query","name":"pageToken","schema":{"type":"string"}},{"description":"An optional query string to filter creatives. If no filter is specified, all active creatives will be returned. Supported queries are: - accountId=*account_id_string* - creativeId=*creative_id_string* - dealsStatus: {approved, conditionally_approved, disapproved, not_checked} - openAuctionStatus: {approved, conditionally_approved, disapproved, not_checked} - attribute: {a numeric attribute from the list of attributes} - disapprovalReason: {a reason from DisapprovalReason} Example: 'accountId=12345 AND (dealsStatus:disapproved AND disapprovalReason:unacceptable_content) OR attribute:47'","in":"query","name":"query","schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ListCreativesResponse"}}},"description":"Successful response"}},"security":[{"Oauth2":["https://www.googleapis.com/auth/adexchange.buyer"],"Oauth2c":["https://www.googleapis.com/auth/adexchange.buyer"]}],"tags":["accounts"]},"parameters":[{"$ref":"#/components/parameters/_.xgafv"},{"$ref":"#/components/parameters/access_token"},{"$ref":"#/components/parameters/alt"},{"$ref":"#/components/parameters/callback"},{"$ref":"#/components/parameters/fields"},{"$ref":"#/components/parameters/key"},{"$ref":"#/components/parameters/oauth_token"},{"$ref":"#/components/parameters/prettyPrint"},{"$ref":"#/components/parameters/quotaUser"},{"$ref":"#/components/parameters/upload_protocol"},{"$ref":"#/components/parameters/uploadType"}],"post":{"description":"Creates a creative.","operationId":"adexchangebuyer2.accounts.creatives.create","parameters":[{"description":"The account that this creative belongs to. Can be used to filter the response of the creatives.list method.","in":"path","name":"accountId","required":true,"schema":{"type":"string"}},{"description":"Indicates if multiple creatives can share an ID or not. Default is NO_DUPLICATES (one ID per creative).","in":"query","name":"duplicateIdMode","schema":{"enum":["NO_DUPLICATES","FORCE_ENABLE_DUPLICATE_IDS"],"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Creative"}}}},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Creative"}}},"description":"Successful response"}},"security":[{"Oauth2":["https://www.googleapis.com/auth/adexchange.buyer"],"Oauth2c":["https://www.googleapis.com/auth/adexchange.buyer"]}],"tags":["accounts"]}},"/v2beta1/accounts/{accountId}/creatives/{creativeId}":{"get":{"description":"Gets a creative.","operationId":"adexchangebuyer2.accounts.creatives.get","parameters":[{"description":"The account the creative belongs to.","in":"path","name":"accountId","required":true,"schema":{"type":"string"}},{"description":"The ID of the creative to retrieve.","in":"path","name":"creativeId","required":true,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Creative"}}},"description":"Successful response"}},"security":[{"Oauth2":["https://www.googleapis.com/auth/adexchange.buyer"],"Oauth2c":["https://www.googleapis.com/auth/adexchange.buyer"]}],"tags":["accounts"]},"parameters":[{"$ref":"#/components/parameters/_.xgafv"},{"$ref":"#/components/parameters/access_token"},{"$ref":"#/components/parameters/alt"},{"$ref":"#/components/parameters/callback"},{"$ref":"#/components/parameters/fields"},{"$ref":"#/components/parameters/key"},{"$ref":"#/components/parameters/oauth_token"},{"$ref":"#/components/parameters/prettyPrint"},{"$ref":"#/components/parameters/quotaUser"},{"$ref":"#/components/parameters/upload_protocol"},{"$ref":"#/components/parameters/uploadType"}],"put":{"description":"Updates a creative.","operationId":"adexchangebuyer2.accounts.creatives.update","parameters":[{"description":"The account that this creative belongs to. Can be used to filter the response of the creatives.list method.","in":"path","name":"accountId","required":true,"schema":{"type":"string"}},{"description":"The buyer-defined creative ID of this creative. Can be used to filter the response of the creatives.list method.","in":"path","name":"creativeId","required":true,"schema":{"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Creative"}}}},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Creative"}}},"description":"Successful response"}},"security":[{"Oauth2":["https://www.googleapis.com/auth/adexchange.buyer"],"Oauth2c":["https://www.googleapis.com/auth/adexchange.buyer"]}],"tags":["accounts"]}},"/v2beta1/accounts/{accountId}/creatives/{creativeId}/dealAssociations":{"get":{"description":"List all creative-deal associations.","operationId":"adexchangebuyer2.accounts.creatives.dealAssociations.list","parameters":[{"description":"The account to list the associations from. Specify \"-\" to list all creatives the current user has access to.","in":"path","name":"accountId","required":true,"schema":{"type":"string"}},{"description":"The creative ID to list the associations from. Specify \"-\" to list all creatives under the above account.","in":"path","name":"creativeId","required":true,"schema":{"type":"string"}},{"description":"Requested page size. Server may return fewer associations than requested. If unspecified, server will pick an appropriate default.","in":"query","name":"pageSize","schema":{"type":"integer"}},{"description":"A token identifying a page of results the server should return. Typically, this is the value of ListDealAssociationsResponse.next_page_token returned from the previous call to 'ListDealAssociations' method.","in":"query","name":"pageToken","schema":{"type":"string"}},{"description":"An optional query string to filter deal associations. If no filter is specified, all associations will be returned. Supported queries are: - accountId=*account_id_string* - creativeId=*creative_id_string* - dealsId=*deals_id_string* - dealsStatus:{approved, conditionally_approved, disapproved, not_checked} - openAuctionStatus:{approved, conditionally_approved, disapproved, not_checked} Example: 'dealsId=12345 AND dealsStatus:disapproved'","in":"query","name":"query","schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ListDealAssociationsResponse"}}},"description":"Successful response"}},"security":[{"Oauth2":["https://www.googleapis.com/auth/adexchange.buyer"],"Oauth2c":["https://www.googleapis.com/auth/adexchange.buyer"]}],"tags":["accounts"]},"parameters":[{"$ref":"#/components/parameters/_.xgafv"},{"$ref":"#/components/parameters/access_token"},{"$ref":"#/components/parameters/alt"},{"$ref":"#/components/parameters/callback"},{"$ref":"#/components/parameters/fields"},{"$ref":"#/components/parameters/key"},{"$ref":"#/components/parameters/oauth_token"},{"$ref":"#/components/parameters/prettyPrint"},{"$ref":"#/components/parameters/quotaUser"},{"$ref":"#/components/parameters/upload_protocol"},{"$ref":"#/components/parameters/uploadType"}]},"/v2beta1/accounts/{accountId}/creatives/{creativeId}/dealAssociations:add":{"parameters":[{"$ref":"#/components/parameters/_.xgafv"},{"$ref":"#/components/parameters/access_token"},{"$ref":"#/components/parameters/alt"},{"$ref":"#/components/parameters/callback"},{"$ref":"#/components/parameters/fields"},{"$ref":"#/components/parameters/key"},{"$ref":"#/components/parameters/oauth_token"},{"$ref":"#/components/parameters/prettyPrint"},{"$ref":"#/components/parameters/quotaUser"},{"$ref":"#/components/parameters/upload_protocol"},{"$ref":"#/components/parameters/uploadType"}],"post":{"description":"Associate an existing deal with a creative.","operationId":"adexchangebuyer2.accounts.creatives.dealAssociations.add","parameters":[{"description":"The account the creative belongs to.","in":"path","name":"accountId","required":true,"schema":{"type":"string"}},{"description":"The ID of the creative associated with the deal.","in":"path","name":"creativeId","required":true,"schema":{"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AddDealAssociationRequest"}}}},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Empty"}}},"description":"Successful response"}},"security":[{"Oauth2":["https://www.googleapis.com/auth/adexchange.buyer"],"Oauth2c":["https://www.googleapis.com/auth/adexchange.buyer"]}],"tags":["accounts"]}},"/v2beta1/accounts/{accountId}/creatives/{creativeId}/dealAssociations:remove":{"parameters":[{"$ref":"#/components/parameters/_.xgafv"},{"$ref":"#/components/parameters/access_token"},{"$ref":"#/components/parameters/alt"},{"$ref":"#/components/parameters/callback"},{"$ref":"#/components/parameters/fields"},{"$ref":"#/components/parameters/key"},{"$ref":"#/components/parameters/oauth_token"},{"$ref":"#/components/parameters/prettyPrint"},{"$ref":"#/components/parameters/quotaUser"},{"$ref":"#/components/parameters/upload_protocol"},{"$ref":"#/components/parameters/uploadType"}],"post":{"description":"Remove the association between a deal and a creative.","operationId":"adexchangebuyer2.accounts.creatives.dealAssociations.remove","parameters":[{"description":"The account the creative belongs to.","in":"path","name":"accountId","required":true,"schema":{"type":"string"}},{"description":"The ID of the creative associated with the deal.","in":"path","name":"creativeId","required":true,"schema":{"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/RemoveDealAssociationRequest"}}}},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Empty"}}},"description":"Successful response"}},"security":[{"Oauth2":["https://www.googleapis.com/auth/adexchange.buyer"],"Oauth2c":["https://www.googleapis.com/auth/adexchange.buyer"]}],"tags":["accounts"]}},"/v2beta1/accounts/{accountId}/creatives/{creativeId}:stopWatching":{"parameters":[{"$ref":"#/components/parameters/_.xgafv"},{"$ref":"#/components/parameters/access_token"},{"$ref":"#/components/parameters/alt"},{"$ref":"#/components/parameters/callback"},{"$ref":"#/components/parameters/fields"},{"$ref":"#/components/parameters/key"},{"$ref":"#/components/parameters/oauth_token"},{"$ref":"#/components/parameters/prettyPrint"},{"$ref":"#/components/parameters/quotaUser"},{"$ref":"#/components/parameters/upload_protocol"},{"$ref":"#/components/parameters/uploadType"}],"post":{"description":"Stops watching a creative. Will stop push notifications being sent to the topics when the creative changes status.","operationId":"adexchangebuyer2.accounts.creatives.stopWatching","parameters":[{"description":"The account of the creative to stop notifications for.","in":"path","name":"accountId","required":true,"schema":{"type":"string"}},{"description":"The creative ID of the creative to stop notifications for. Specify \"-\" to specify stopping account level notifications.","in":"path","name":"creativeId","required":true,"schema":{"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/StopWatchingCreativeRequest"}}}},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Empty"}}},"description":"Successful response"}},"security":[{"Oauth2":["https://www.googleapis.com/auth/adexchange.buyer"],"Oauth2c":["https://www.googleapis.com/auth/adexchange.buyer"]}],"tags":["accounts"]}},"/v2beta1/accounts/{accountId}/creatives/{creativeId}:watch":{"parameters":[{"$ref":"#/components/parameters/_.xgafv"},{"$ref":"#/components/parameters/access_token"},{"$ref":"#/components/parameters/alt"},{"$ref":"#/components/parameters/callback"},{"$ref":"#/components/parameters/fields"},{"$ref":"#/components/parameters/key"},{"$ref":"#/components/parameters/oauth_token"},{"$ref":"#/components/parameters/prettyPrint"},{"$ref":"#/components/parameters/quotaUser"},{"$ref":"#/components/parameters/upload_protocol"},{"$ref":"#/components/parameters/uploadType"}],"post":{"description":"Watches a creative. Will result in push notifications being sent to the topic when the creative changes status.","operationId":"adexchangebuyer2.accounts.creatives.watch","parameters":[{"description":"The account of the creative to watch.","in":"path","name":"accountId","required":true,"schema":{"type":"string"}},{"description":"The creative ID to watch for status changes. Specify \"-\" to watch all creatives under the above account. If both creative-level and account-level notifications are sent, only a single notification will be sent to the creative-level notification topic.","in":"path","name":"creativeId","required":true,"schema":{"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/WatchCreativeRequest"}}}},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Empty"}}},"description":"Successful response"}},"security":[{"Oauth2":["https://www.googleapis.com/auth/adexchange.buyer"],"Oauth2c":["https://www.googleapis.com/auth/adexchange.buyer"]}],"tags":["accounts"]}},"/v2beta1/accounts/{accountId}/finalizedProposals":{"get":{"description":"List finalized proposals, regardless if a proposal is being renegotiated. A filter expression (PQL query) may be specified to filter the results. The notes will not be returned.","operationId":"adexchangebuyer2.accounts.finalizedProposals.list","parameters":[{"description":"Account ID of the buyer.","in":"path","name":"accountId","required":true,"schema":{"type":"string"}},{"description":"An optional PQL filter query used to query for proposals. Nested repeated fields, such as proposal.deals.targetingCriterion, cannot be filtered.","in":"query","name":"filter","schema":{"type":"string"}},{"description":"Syntax the filter is written in. Current implementation defaults to PQL but in the future it will be LIST_FILTER.","in":"query","name":"filterSyntax","schema":{"enum":["FILTER_SYNTAX_UNSPECIFIED","PQL","LIST_FILTER"],"type":"string"}},{"description":"Requested page size. The server may return fewer results than requested. If unspecified, the server will pick an appropriate default.","in":"query","name":"pageSize","schema":{"type":"integer"}},{"description":"The page token as returned from ListProposalsResponse.","in":"query","name":"pageToken","schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ListProposalsResponse"}}},"description":"Successful response"}},"security":[{"Oauth2":["https://www.googleapis.com/auth/adexchange.buyer"],"Oauth2c":["https://www.googleapis.com/auth/adexchange.buyer"]}],"tags":["accounts"]},"parameters":[{"$ref":"#/components/parameters/_.xgafv"},{"$ref":"#/components/parameters/access_token"},{"$ref":"#/components/parameters/alt"},{"$ref":"#/components/parameters/callback"},{"$ref":"#/components/parameters/fields"},{"$ref":"#/components/parameters/key"},{"$ref":"#/components/parameters/oauth_token"},{"$ref":"#/components/parameters/prettyPrint"},{"$ref":"#/components/parameters/quotaUser"},{"$ref":"#/components/parameters/upload_protocol"},{"$ref":"#/components/parameters/uploadType"}]},"/v2beta1/accounts/{accountId}/finalizedProposals/{proposalId}:pause":{"parameters":[{"$ref":"#/components/parameters/_.xgafv"},{"$ref":"#/components/parameters/access_token"},{"$ref":"#/components/parameters/alt"},{"$ref":"#/components/parameters/callback"},{"$ref":"#/components/parameters/fields"},{"$ref":"#/components/parameters/key"},{"$ref":"#/components/parameters/oauth_token"},{"$ref":"#/components/parameters/prettyPrint"},{"$ref":"#/components/parameters/quotaUser"},{"$ref":"#/components/parameters/upload_protocol"},{"$ref":"#/components/parameters/uploadType"}],"post":{"description":"Update given deals to pause serving. This method will set the `DealServingMetadata.DealPauseStatus.has_buyer_paused` bit to true for all listed deals in the request. Currently, this method only applies to PG and PD deals. For PA deals, call accounts.proposals.pause endpoint. It is a no-op to pause already-paused deals. It is an error to call PauseProposalDeals for deals which are not part of the proposal of proposal_id or which are not finalized or renegotiating.","operationId":"adexchangebuyer2.accounts.finalizedProposals.pause","parameters":[{"description":"Account ID of the buyer.","in":"path","name":"accountId","required":true,"schema":{"type":"string"}},{"description":"The proposal_id of the proposal containing the deals.","in":"path","name":"proposalId","required":true,"schema":{"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PauseProposalDealsRequest"}}}},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Proposal"}}},"description":"Successful response"}},"security":[{"Oauth2":["https://www.googleapis.com/auth/adexchange.buyer"],"Oauth2c":["https://www.googleapis.com/auth/adexchange.buyer"]}],"tags":["accounts"]}},"/v2beta1/accounts/{accountId}/finalizedProposals/{proposalId}:resume":{"parameters":[{"$ref":"#/components/parameters/_.xgafv"},{"$ref":"#/components/parameters/access_token"},{"$ref":"#/components/parameters/alt"},{"$ref":"#/components/parameters/callback"},{"$ref":"#/components/parameters/fields"},{"$ref":"#/components/parameters/key"},{"$ref":"#/components/parameters/oauth_token"},{"$ref":"#/components/parameters/prettyPrint"},{"$ref":"#/components/parameters/quotaUser"},{"$ref":"#/components/parameters/upload_protocol"},{"$ref":"#/components/parameters/uploadType"}],"post":{"description":"Update given deals to resume serving. This method will set the `DealServingMetadata.DealPauseStatus.has_buyer_paused` bit to false for all listed deals in the request. Currently, this method only applies to PG and PD deals. For PA deals, call accounts.proposals.resume endpoint. It is a no-op to resume running deals or deals paused by the other party. It is an error to call ResumeProposalDeals for deals which are not part of the proposal of proposal_id or which are not finalized or renegotiating.","operationId":"adexchangebuyer2.accounts.finalizedProposals.resume","parameters":[{"description":"Account ID of the buyer.","in":"path","name":"accountId","required":true,"schema":{"type":"string"}},{"description":"The proposal_id of the proposal containing the deals.","in":"path","name":"proposalId","required":true,"schema":{"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ResumeProposalDealsRequest"}}}},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Proposal"}}},"description":"Successful response"}},"security":[{"Oauth2":["https://www.googleapis.com/auth/adexchange.buyer"],"Oauth2c":["https://www.googleapis.com/auth/adexchange.buyer"]}],"tags":["accounts"]}},"/v2beta1/accounts/{accountId}/products":{"get":{"description":"List all products visible to the buyer (optionally filtered by the specified PQL query).","operationId":"adexchangebuyer2.accounts.products.list","parameters":[{"description":"Account ID of the buyer.","in":"path","name":"accountId","required":true,"schema":{"type":"string"}},{"description":"An optional PQL query used to query for products. See https://developers.google.com/ad-manager/docs/pqlreference for documentation about PQL and examples. Nested repeated fields, such as product.targetingCriterion.inclusions, cannot be filtered.","in":"query","name":"filter","schema":{"type":"string"}},{"description":"Requested page size. The server may return fewer results than requested. If unspecified, the server will pick an appropriate default.","in":"query","name":"pageSize","schema":{"type":"integer"}},{"description":"The page token as returned from ListProductsResponse.","in":"query","name":"pageToken","schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ListProductsResponse"}}},"description":"Successful response"}},"security":[{"Oauth2":["https://www.googleapis.com/auth/adexchange.buyer"],"Oauth2c":["https://www.googleapis.com/auth/adexchange.buyer"]}],"tags":["accounts"]},"parameters":[{"$ref":"#/components/parameters/_.xgafv"},{"$ref":"#/components/parameters/access_token"},{"$ref":"#/components/parameters/alt"},{"$ref":"#/components/parameters/callback"},{"$ref":"#/components/parameters/fields"},{"$ref":"#/components/parameters/key"},{"$ref":"#/components/parameters/oauth_token"},{"$ref":"#/components/parameters/prettyPrint"},{"$ref":"#/components/parameters/quotaUser"},{"$ref":"#/components/parameters/upload_protocol"},{"$ref":"#/components/parameters/uploadType"}]},"/v2beta1/accounts/{accountId}/products/{productId}":{"get":{"description":"Gets the requested product by ID.","operationId":"adexchangebuyer2.accounts.products.get","parameters":[{"description":"Account ID of the buyer.","in":"path","name":"accountId","required":true,"schema":{"type":"string"}},{"description":"The ID for the product to get the head revision for.","in":"path","name":"productId","required":true,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Product"}}},"description":"Successful response"}},"security":[{"Oauth2":["https://www.googleapis.com/auth/adexchange.buyer"],"Oauth2c":["https://www.googleapis.com/auth/adexchange.buyer"]}],"tags":["accounts"]},"parameters":[{"$ref":"#/components/parameters/_.xgafv"},{"$ref":"#/components/parameters/access_token"},{"$ref":"#/components/parameters/alt"},{"$ref":"#/components/parameters/callback"},{"$ref":"#/components/parameters/fields"},{"$ref":"#/components/parameters/key"},{"$ref":"#/components/parameters/oauth_token"},{"$ref":"#/components/parameters/prettyPrint"},{"$ref":"#/components/parameters/quotaUser"},{"$ref":"#/components/parameters/upload_protocol"},{"$ref":"#/components/parameters/uploadType"}]},"/v2beta1/accounts/{accountId}/proposals":{"get":{"description":"List proposals. A filter expression (PQL query) may be specified to filter the results. To retrieve all finalized proposals, regardless if a proposal is being renegotiated, see the FinalizedProposals resource. Note that Bidder/ChildSeat relationships differ from the usual behavior. A Bidder account can only see its child seats' proposals by specifying the ChildSeat's accountId in the request path.","operationId":"adexchangebuyer2.accounts.proposals.list","parameters":[{"description":"Account ID of the buyer.","in":"path","name":"accountId","required":true,"schema":{"type":"string"}},{"description":"An optional PQL filter query used to query for proposals. Nested repeated fields, such as proposal.deals.targetingCriterion, cannot be filtered.","in":"query","name":"filter","schema":{"type":"string"}},{"description":"Syntax the filter is written in. Current implementation defaults to PQL but in the future it will be LIST_FILTER.","in":"query","name":"filterSyntax","schema":{"enum":["FILTER_SYNTAX_UNSPECIFIED","PQL","LIST_FILTER"],"type":"string"}},{"description":"Requested page size. The server may return fewer results than requested. If unspecified, the server will pick an appropriate default.","in":"query","name":"pageSize","schema":{"type":"integer"}},{"description":"The page token as returned from ListProposalsResponse.","in":"query","name":"pageToken","schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ListProposalsResponse"}}},"description":"Successful response"}},"security":[{"Oauth2":["https://www.googleapis.com/auth/adexchange.buyer"],"Oauth2c":["https://www.googleapis.com/auth/adexchange.buyer"]}],"tags":["accounts"]},"parameters":[{"$ref":"#/components/parameters/_.xgafv"},{"$ref":"#/components/parameters/access_token"},{"$ref":"#/components/parameters/alt"},{"$ref":"#/components/parameters/callback"},{"$ref":"#/components/parameters/fields"},{"$ref":"#/components/parameters/key"},{"$ref":"#/components/parameters/oauth_token"},{"$ref":"#/components/parameters/prettyPrint"},{"$ref":"#/components/parameters/quotaUser"},{"$ref":"#/components/parameters/upload_protocol"},{"$ref":"#/components/parameters/uploadType"}],"post":{"description":"Create the given proposal. Each created proposal and any deals it contains are assigned a unique ID by the server.","operationId":"adexchangebuyer2.accounts.proposals.create","parameters":[{"description":"Account ID of the buyer.","in":"path","name":"accountId","required":true,"schema":{"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Proposal"}}}},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Proposal"}}},"description":"Successful response"}},"security":[{"Oauth2":["https://www.googleapis.com/auth/adexchange.buyer"],"Oauth2c":["https://www.googleapis.com/auth/adexchange.buyer"]}],"tags":["accounts"]}},"/v2beta1/accounts/{accountId}/proposals/{proposalId}":{"get":{"description":"Gets a proposal given its ID. The proposal is returned at its head revision.","operationId":"adexchangebuyer2.accounts.proposals.get","parameters":[{"description":"Account ID of the buyer.","in":"path","name":"accountId","required":true,"schema":{"type":"string"}},{"description":"The unique ID of the proposal","in":"path","name":"proposalId","required":true,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Proposal"}}},"description":"Successful response"}},"security":[{"Oauth2":["https://www.googleapis.com/auth/adexchange.buyer"],"Oauth2c":["https://www.googleapis.com/auth/adexchange.buyer"]}],"tags":["accounts"]},"parameters":[{"$ref":"#/components/parameters/_.xgafv"},{"$ref":"#/components/parameters/access_token"},{"$ref":"#/components/parameters/alt"},{"$ref":"#/components/parameters/callback"},{"$ref":"#/components/parameters/fields"},{"$ref":"#/components/parameters/key"},{"$ref":"#/components/parameters/oauth_token"},{"$ref":"#/components/parameters/prettyPrint"},{"$ref":"#/components/parameters/quotaUser"},{"$ref":"#/components/parameters/upload_protocol"},{"$ref":"#/components/parameters/uploadType"}],"put":{"description":"Update the given proposal at the client known revision number. If the server revision has advanced since the passed-in `proposal.proposal_revision`, an `ABORTED` error message will be returned. Only the buyer-modifiable fields of the proposal will be updated. Note that the deals in the proposal will be updated to match the passed-in copy. If a passed-in deal does not have a `deal_id`, the server will assign a new unique ID and create the deal. If passed-in deal has a `deal_id`, it will be updated to match the passed-in copy. Any existing deals not present in the passed-in proposal will be deleted. It is an error to pass in a deal with a `deal_id` not present at head.","operationId":"adexchangebuyer2.accounts.proposals.update","parameters":[{"description":"Account ID of the buyer.","in":"path","name":"accountId","required":true,"schema":{"type":"string"}},{"description":"The unique ID of the proposal.","in":"path","name":"proposalId","required":true,"schema":{"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Proposal"}}}},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Proposal"}}},"description":"Successful response"}},"security":[{"Oauth2":["https://www.googleapis.com/auth/adexchange.buyer"],"Oauth2c":["https://www.googleapis.com/auth/adexchange.buyer"]}],"tags":["accounts"]}},"/v2beta1/accounts/{accountId}/proposals/{proposalId}:accept":{"parameters":[{"$ref":"#/components/parameters/_.xgafv"},{"$ref":"#/components/parameters/access_token"},{"$ref":"#/components/parameters/alt"},{"$ref":"#/components/parameters/callback"},{"$ref":"#/components/parameters/fields"},{"$ref":"#/components/parameters/key"},{"$ref":"#/components/parameters/oauth_token"},{"$ref":"#/components/parameters/prettyPrint"},{"$ref":"#/components/parameters/quotaUser"},{"$ref":"#/components/parameters/upload_protocol"},{"$ref":"#/components/parameters/uploadType"}],"post":{"description":"Mark the proposal as accepted at the given revision number. If the number does not match the server's revision number an `ABORTED` error message will be returned. This call updates the proposal_state from `PROPOSED` to `BUYER_ACCEPTED`, or from `SELLER_ACCEPTED` to `FINALIZED`. Upon calling this endpoint, the buyer implicitly agrees to the terms and conditions optionally set within the proposal by the publisher.","operationId":"adexchangebuyer2.accounts.proposals.accept","parameters":[{"description":"Account ID of the buyer.","in":"path","name":"accountId","required":true,"schema":{"type":"string"}},{"description":"The ID of the proposal to accept.","in":"path","name":"proposalId","required":true,"schema":{"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AcceptProposalRequest"}}}},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Proposal"}}},"description":"Successful response"}},"security":[{"Oauth2":["https://www.googleapis.com/auth/adexchange.buyer"],"Oauth2c":["https://www.googleapis.com/auth/adexchange.buyer"]}],"tags":["accounts"]}},"/v2beta1/accounts/{accountId}/proposals/{proposalId}:addNote":{"parameters":[{"$ref":"#/components/parameters/_.xgafv"},{"$ref":"#/components/parameters/access_token"},{"$ref":"#/components/parameters/alt"},{"$ref":"#/components/parameters/callback"},{"$ref":"#/components/parameters/fields"},{"$ref":"#/components/parameters/key"},{"$ref":"#/components/parameters/oauth_token"},{"$ref":"#/components/parameters/prettyPrint"},{"$ref":"#/components/parameters/quotaUser"},{"$ref":"#/components/parameters/upload_protocol"},{"$ref":"#/components/parameters/uploadType"}],"post":{"description":"Create a new note and attach it to the proposal. The note is assigned a unique ID by the server. The proposal revision number will not increase when associated with a new note.","operationId":"adexchangebuyer2.accounts.proposals.addNote","parameters":[{"description":"Account ID of the buyer.","in":"path","name":"accountId","required":true,"schema":{"type":"string"}},{"description":"The ID of the proposal to attach the note to.","in":"path","name":"proposalId","required":true,"schema":{"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AddNoteRequest"}}}},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Note"}}},"description":"Successful response"}},"security":[{"Oauth2":["https://www.googleapis.com/auth/adexchange.buyer"],"Oauth2c":["https://www.googleapis.com/auth/adexchange.buyer"]}],"tags":["accounts"]}},"/v2beta1/accounts/{accountId}/proposals/{proposalId}:cancelNegotiation":{"parameters":[{"$ref":"#/components/parameters/_.xgafv"},{"$ref":"#/components/parameters/access_token"},{"$ref":"#/components/parameters/alt"},{"$ref":"#/components/parameters/callback"},{"$ref":"#/components/parameters/fields"},{"$ref":"#/components/parameters/key"},{"$ref":"#/components/parameters/oauth_token"},{"$ref":"#/components/parameters/prettyPrint"},{"$ref":"#/components/parameters/quotaUser"},{"$ref":"#/components/parameters/upload_protocol"},{"$ref":"#/components/parameters/uploadType"}],"post":{"description":"Cancel an ongoing negotiation on a proposal. This does not cancel or end serving for the deals if the proposal has been finalized, but only cancels a negotiation unilaterally.","operationId":"adexchangebuyer2.accounts.proposals.cancelNegotiation","parameters":[{"description":"Account ID of the buyer.","in":"path","name":"accountId","required":true,"schema":{"type":"string"}},{"description":"The ID of the proposal to cancel negotiation for.","in":"path","name":"proposalId","required":true,"schema":{"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CancelNegotiationRequest"}}}},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Proposal"}}},"description":"Successful response"}},"security":[{"Oauth2":["https://www.googleapis.com/auth/adexchange.buyer"],"Oauth2c":["https://www.googleapis.com/auth/adexchange.buyer"]}],"tags":["accounts"]}},"/v2beta1/accounts/{accountId}/proposals/{proposalId}:completeSetup":{"parameters":[{"$ref":"#/components/parameters/_.xgafv"},{"$ref":"#/components/parameters/access_token"},{"$ref":"#/components/parameters/alt"},{"$ref":"#/components/parameters/callback"},{"$ref":"#/components/parameters/fields"},{"$ref":"#/components/parameters/key"},{"$ref":"#/components/parameters/oauth_token"},{"$ref":"#/components/parameters/prettyPrint"},{"$ref":"#/components/parameters/quotaUser"},{"$ref":"#/components/parameters/upload_protocol"},{"$ref":"#/components/parameters/uploadType"}],"post":{"description":"You can opt-in to manually update proposals to indicate that setup is complete. By default, proposal setup is automatically completed after their deals are finalized. Contact your Technical Account Manager to opt in. Buyers can call this method when the proposal has been finalized, and all the required creatives have been uploaded using the Creatives API. This call updates the `is_setup_completed` field on the deals in the proposal, and notifies the seller. The server then advances the revision number of the most recent proposal. To mark an individual deal as