UNPKG

openapi-directory

Version:

Building & bundling https://github.com/APIs-guru/openapi-directory for easy use from JS

1 lines 10.4 kB
{"openapi":"3.0.0","servers":[{"url":"https://realtimebidding.googleapis.com/"}],"info":{"contact":{"name":"Google","url":"https://google.com","x-twitter":"youtube"},"description":"Allows external bidders to manage their RTB integration with Google. This includes managing bidder endpoints, QPS quotas, configuring what ad inventory to receive via pretargeting, submitting creatives for verification, and accessing creative metadata such as approval status.","license":{"name":"Creative Commons Attribution 3.0","url":"http://creativecommons.org/licenses/by/3.0/"},"termsOfService":"https://developers.google.com/terms/","title":"Real-time Bidding API","version":"v1alpha","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://realtimebidding.googleapis.com/$discovery/rest?version=v1alpha","version":"v1"}],"x-preferred":true,"x-providerName":"googleapis.com","x-serviceName":"realtimebidding"},"externalDocs":{"url":"https://developers.google.com/authorized-buyers/apis/realtimebidding/reference/rest/"},"tags":[{"name":"bidders"}],"paths":{"/v1alpha/{name}:activate":{"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":"Activates an existing bidding function. An activated function is available for invocation for the server-side TURTLEDOVE simulations.","operationId":"realtimebidding.bidders.biddingFunctions.activate","parameters":[{"description":"Required. The name of the bidding function to activate. Format: `bidders/{bidder_account_id}/biddingFunction/{bidding_function_name}`","in":"path","name":"name","required":true,"schema":{"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ActivateBiddingFunctionRequest"}}}},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/BiddingFunction"}}},"description":"Successful response"}},"security":[{"Oauth2":["https://www.googleapis.com/auth/realtime-bidding"],"Oauth2c":["https://www.googleapis.com/auth/realtime-bidding"]}],"tags":["bidders"]}},"/v1alpha/{name}:archive":{"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":"Archives an existing bidding function. An archived function will not be available for function invocation for the server-side TURTLEDOVE simulations unless it is activated.","operationId":"realtimebidding.bidders.biddingFunctions.archive","parameters":[{"description":"Required. The name of the bidding function to archive. Format: `bidders/{bidder_account_id}/biddingFunction/{bidding_function_name}`","in":"path","name":"name","required":true,"schema":{"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ArchiveBiddingFunctionRequest"}}}},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/BiddingFunction"}}},"description":"Successful response"}},"security":[{"Oauth2":["https://www.googleapis.com/auth/realtime-bidding"],"Oauth2c":["https://www.googleapis.com/auth/realtime-bidding"]}],"tags":["bidders"]}},"/v1alpha/{parent}/biddingFunctions":{"get":{"description":"Lists the bidding functions that a bidder currently has registered.","operationId":"realtimebidding.bidders.biddingFunctions.list","parameters":[{"description":"Required. Name of the bidder whose bidding functions will be listed. Format: `bidders/{bidder_account_id}`","in":"path","name":"parent","required":true,"schema":{"type":"string"}},{"description":"The maximum number of bidding functions to return.","in":"query","name":"pageSize","schema":{"type":"integer"}},{"description":"A token identifying a page of results the server should return. This value is received from a previous `ListBiddingFunctions` call in ListBiddingFunctionsResponse.nextPageToken.","in":"query","name":"pageToken","schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ListBiddingFunctionsResponse"}}},"description":"Successful response"}},"security":[{"Oauth2":["https://www.googleapis.com/auth/realtime-bidding"],"Oauth2c":["https://www.googleapis.com/auth/realtime-bidding"]}],"tags":["bidders"]},"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 bidding function.","operationId":"realtimebidding.bidders.biddingFunctions.create","parameters":[{"description":"Required. The name of the bidder for which to create the bidding function. Format: `bidders/{bidderAccountId}`","in":"path","name":"parent","required":true,"schema":{"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/BiddingFunction"}}}},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/BiddingFunction"}}},"description":"Successful response"}},"security":[{"Oauth2":["https://www.googleapis.com/auth/realtime-bidding"],"Oauth2c":["https://www.googleapis.com/auth/realtime-bidding"]}],"tags":["bidders"]}}},"components":{"parameters":{"_.xgafv":{"description":"V1 error format.","in":"query","name":"$.xgafv","schema":{"enum":["1","2"],"type":"string"}},"access_token":{"description":"OAuth access token.","in":"query","name":"access_token","schema":{"type":"string"}},"alt":{"description":"Data format for response.","in":"query","name":"alt","schema":{"enum":["json","media","proto"],"type":"string"}},"callback":{"description":"JSONP","in":"query","name":"callback","schema":{"type":"string"}},"fields":{"description":"Selector specifying which fields to include in a partial response.","in":"query","name":"fields","schema":{"type":"string"}},"key":{"description":"API key. Your API key identifies your project and provides you with API access, quota, and reports. Required unless you provide an OAuth 2.0 token.","in":"query","name":"key","schema":{"type":"string"}},"oauth_token":{"description":"OAuth 2.0 token for the current user.","in":"query","name":"oauth_token","schema":{"type":"string"}},"prettyPrint":{"description":"Returns response with indentations and line breaks.","in":"query","name":"prettyPrint","schema":{"type":"boolean"}},"quotaUser":{"description":"Available to use for quota purposes for server-side applications. Can be any arbitrary string assigned to a user, but should not exceed 40 characters.","in":"query","name":"quotaUser","schema":{"type":"string"}},"uploadType":{"description":"Legacy upload protocol for media (e.g. \"media\", \"multipart\").","in":"query","name":"uploadType","schema":{"type":"string"}},"upload_protocol":{"description":"Upload protocol for media (e.g. \"raw\", \"multipart\").","in":"query","name":"upload_protocol","schema":{"type":"string"}}},"schemas":{"ActivateBiddingFunctionRequest":{"description":"The request to activate a bidding function.","properties":{},"type":"object"},"ArchiveBiddingFunctionRequest":{"description":"A request to archive a bidding function.","properties":{},"type":"object"},"BiddingFunction":{"description":"The bidding function to be executed as part of the TURTLEDOVE simulation experiment bidding flow.","properties":{"biddingFunction":{"description":"The raw Javascript source code of the bidding function.","type":"string"},"name":{"description":"The name of the bidding function that must follow the pattern: `bidders/{bidder_account_id}/biddingFunctions/{bidding_function_name}`.","type":"string"},"state":{"description":"Output only. The state of the bidding function.","enum":["STATE_UNSPECIFIED","ACTIVE","ARCHIVED"],"readOnly":true,"type":"string"},"type":{"description":"The type of the bidding function to be created.","enum":["FUNCTION_TYPE_UNSPECIFIED","TURTLEDOVE_SIMULATION_BIDDING_FUNCTION","FLEDGE_BIDDING_FUNCTION"],"type":"string"}},"type":"object"},"ListBiddingFunctionsResponse":{"description":"A response containing a list of a bidder's bidding functions.","properties":{"biddingFunctions":{"description":"A list of a bidder's bidding functions.","items":{"$ref":"#/components/schemas/BiddingFunction"},"type":"array"},"nextPageToken":{"description":"A token which can be passed to a subsequent call to the `ListBiddingFunctions` method to retrieve the next page of results in ListBiddingFunctionsRequest.pageToken.","type":"string"}},"type":"object"}},"securitySchemes":{"Oauth2":{"description":"Oauth 2.0 implicit authentication","flows":{"implicit":{"authorizationUrl":"https://accounts.google.com/o/oauth2/auth","scopes":{"https://www.googleapis.com/auth/realtime-bidding":"See, create, edit, and delete your Authorized Buyers and Open Bidding account entities"}}},"type":"oauth2"},"Oauth2c":{"description":"Oauth 2.0 authorizationCode authentication","flows":{"authorizationCode":{"authorizationUrl":"https://accounts.google.com/o/oauth2/auth","scopes":{"https://www.googleapis.com/auth/realtime-bidding":"See, create, edit, and delete your Authorized Buyers and Open Bidding account entities"},"tokenUrl":"https://accounts.google.com/o/oauth2/token"}},"type":"oauth2"}}}}