# REST Resource: bidders.endpoints

- [Resource: Endpoint](https://developers.google.com/authorized-buyers/apis/realtimebidding/reference/rest/v1/bidders.endpoints#Endpoint)
  - [JSON representation](https://developers.google.com/authorized-buyers/apis/realtimebidding/reference/rest/v1/bidders.endpoints#Endpoint.SCHEMA_REPRESENTATION)
- [TradingLocation](https://developers.google.com/authorized-buyers/apis/realtimebidding/reference/rest/v1/bidders.endpoints#TradingLocation)
- [BidProtocol](https://developers.google.com/authorized-buyers/apis/realtimebidding/reference/rest/v1/bidders.endpoints#BidProtocol)
- [Methods](https://developers.google.com/authorized-buyers/apis/realtimebidding/reference/rest/v1/bidders.endpoints#METHODS_SUMMARY)

## Resource: Endpoint

Bidder endpoint that receives bid requests.

| JSON representation |
|---|
| ``` { "name": string, "url": string, "maximumQps": string, "tradingLocation": enum (`https://developers.google.com/authorized-buyers/apis/realtimebidding/reference/rest/v1/bidders.endpoints#TradingLocation`), "bidProtocol": enum (`https://developers.google.com/authorized-buyers/apis/realtimebidding/reference/rest/v1/bidders.endpoints#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 (https://developers.google.com/discovery/v1/type-format format)` The maximum number of queries per second allowed to be sent to this server. |
| `tradingLocation` | ``enum (`https://developers.google.com/authorized-buyers/apis/realtimebidding/reference/rest/v1/bidders.endpoints#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 (`https://developers.google.com/authorized-buyers/apis/realtimebidding/reference/rest/v1/bidders.endpoints#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. > [!WARNING] > Deprecated: The Google RTB protocol has been sunset. Use the OpenRTB protocol instead. |
| `OPENRTB_JSON` | OpenRTB / JSON encoding (unversioned/latest). |
| `OPENRTB_PROTOBUF` | OpenRTB / Protobuf encoding (unversioned/latest). |

| ## Methods ||
|---|---|
| ### `https://developers.google.com/authorized-buyers/apis/realtimebidding/reference/rest/v1/bidders.endpoints/get` | Gets a bidder endpoint by its name. |
| ### `https://developers.google.com/authorized-buyers/apis/realtimebidding/reference/rest/v1/bidders.endpoints/list` | Lists all the bidder's endpoints. |
| ### `https://developers.google.com/authorized-buyers/apis/realtimebidding/reference/rest/v1/bidders.endpoints/patch` | Updates a bidder's endpoint. |