GOgoogle
buyers

GET /v1/buyers/{buyersId}

Gets a buyer account by its name.

Request

  • Base URL
    https://realtimebidding.googleapis.com
  • Auth
    OAuth 2 and OAuth 2
    Implicithttps://accounts.google.com/o/oauth2/auth
    Scopeshttps://www.googleapis.com/auth/realtime-bidding
    Authorization codehttps://accounts.google.com/o/oauth2/auth
    Token URLhttps://accounts.google.com/o/oauth2/token
    Scopeshttps://www.googleapis.com/auth/realtime-bidding
  • TypeScript
    A function with typed inputs. Its response is checked against the schema.

Path parameters

buyersIdstring required

Response

Successful response

activeCreativeCountstring int64

Output only. The number of creatives that this buyer submitted through the API or bid with in the last 30 days. This is counted against the maximum number of active creatives.

bidderstring

Output only. The name of the bidder resource that is responsible for receiving bidding traffic for this account. The bidder name must follow the pattern bidders/{bidderAccountId}, where {bidderAccountId} is the account ID of the bidder receiving traffic for this buyer.

billingIdsstring[]

Output only. A list of billing IDs associated with this account. These IDs appear on: 1. A bid request, to signal which buyers are eligible to bid on a given opportunity, and which pretargeting configurations were matched for each eligible buyer. 2. The bid response, to attribute a winning impression to a specific account for billing, reporting, policy and publisher block enforcement.

displayNamestring

Output only. The diplay name associated with this buyer account, as visible to sellers.

maximumActiveCreativeCountstring int64

Output only. The maximum number of active creatives that this buyer can have.

namestring

Output only. Name of the buyer resource that must follow the pattern buyers/{buyerAccountId}, where {buyerAccountId} is the account ID of the buyer account whose information is to be received. One can get their account ID on the Authorized Buyers or Open Bidding UI, or by contacting their Google account manager.

Changes

No recorded changes to this operation across all 5 revisions of this API.