REST Resource: bidders.endpoints

  • The Bidder endpoint is a resource that receives bid requests and has properties like name, URL, maximum queries per second, trading location, and bid protocol.

  • Trading Location refers to the geographical region where the bidder's infrastructure is located and influences latency measurements.

  • Bid Protocol defines the communication protocol and encoding used by the bidder endpoint for handling bid requests, with options like Google RTB, OpenRTB JSON, and OpenRTB Protobuf.

  • You can manage bidder endpoints through methods like Get, List, and Patch to retrieve, view a list, or update them respectively.

Resource: Endpoint

Bidder endpoint that receives bid requests.

JSON representation 
{
  "name": string,
  "url": string,
  "maximumQps": string,
  "tradingLocation": enum (TradingLocation),
  "bidProtocol": enum (BidProtocol)
}
Fields
name

string

Output only. Name of the endpoint resource that must follow the pattern bidders/{bidderAccountId}/endpoints/{endpointId}, where {bidderAccountId} is the account ID of the bidder who operates this endpoint, and {endpointId} is a unique ID assigned by the server.
url

string

Output only. The URL that bid requests should be sent to.
maximumQps

string (int64 format)

The maximum number of queries per second allowed to be sent to this server.
tradingLocation

enum (TradingLocation)

The trading location that bid requests should be sent from. See https://developers.google.com/authorized-buyers/rtb/peer-guide#trading-locations for further information.
bidProtocol

enum (BidProtocol)

The protocol that the bidder endpoint is using.

TradingLocation

The region where infrastructure hosting a bidder application may be located, and corresponds to the location of the users that bid requests are sent for. Trading location serves as a reference point for measuring and enforcing bidder latency.

See https://developers.google.com/authorized-buyers/rtb/peer-guide#trading-locations for further information.

Enums
TRADING_LOCATION_UNSPECIFIED A placeholder for an undefined trading region. This value should not be used.
US_WEST The Western US trading location.
US_EAST The Eastern US trading location.
EUROPE The European trading location.
ASIA The Asia trading location.

BidProtocol

The bid protocol options that a bidder endpoint can use.

Enums
BID_PROTOCOL_UNSPECIFIED Placeholder for undefined bid protocol. This value should not be used.
GOOGLE_RTB

Google RTB protocol / Protobuf encoding.
OPENRTB_JSON OpenRTB / JSON encoding (unversioned/latest).
OPENRTB_PROTOBUF OpenRTB / Protobuf encoding (unversioned/latest).

Methods

get

 Gets a bidder endpoint by its name.

list

 Lists all the bidder's endpoints.

patch

 Updates a bidder's endpoint.