# REST Resource: bidders.publisherConnections

- [Resource: PublisherConnection](https://developers.google.com/authorized-buyers/apis/realtimebidding/reference/rest/v1/bidders.publisherConnections#PublisherConnection)
  - [JSON representation](https://developers.google.com/authorized-buyers/apis/realtimebidding/reference/rest/v1/bidders.publisherConnections#PublisherConnection.SCHEMA_REPRESENTATION)
- [PublisherPlatform](https://developers.google.com/authorized-buyers/apis/realtimebidding/reference/rest/v1/bidders.publisherConnections#PublisherPlatform)
- [State](https://developers.google.com/authorized-buyers/apis/realtimebidding/reference/rest/v1/bidders.publisherConnections#State)
- [Methods](https://developers.google.com/authorized-buyers/apis/realtimebidding/reference/rest/v1/bidders.publisherConnections#METHODS_SUMMARY)

## Resource: PublisherConnection

An Open Bidding exchange's connection to a publisher. This is initiated by the publisher for the bidder to review. If approved by the bidder, this means that the bidder agrees to receive bid requests from the publisher.

| JSON representation |
|---|
| ``` { "name": string, "publisherPlatform": enum (`https://developers.google.com/authorized-buyers/apis/realtimebidding/reference/rest/v1/bidders.publisherConnections#PublisherPlatform`), "displayName": string, "biddingState": enum (`https://developers.google.com/authorized-buyers/apis/realtimebidding/reference/rest/v1/bidders.publisherConnections#State`), "createTime": string } ``` |

| Fields ||
|---|---|
| `name` | `string` Output only. Name of the publisher connection. This follows the pattern `bidders/{bidder}/publisherConnections/{publisher}`, where `{bidder}` represents the account ID of the bidder, and `{publisher}` is the ads.txt/app-ads.txt publisher ID. |
| `publisherPlatform` | ``enum (`https://developers.google.com/authorized-buyers/apis/realtimebidding/reference/rest/v1/bidders.publisherConnections#PublisherPlatform`)`` Output only. Whether the publisher is an Ad Manager or AdMob publisher. |
| `displayName` | `string` Output only. Publisher display name. |
| `biddingState` | ``enum (`https://developers.google.com/authorized-buyers/apis/realtimebidding/reference/rest/v1/bidders.publisherConnections#State`)`` Whether the publisher has been approved by the bidder. |
| `createTime` | ``string (`https://protobuf.dev/reference/protobuf/google.protobuf#timestamp` format)`` Output only. The time at which the publisher initiated a connection with the bidder (irrespective of if or when the bidder approves it). This is subsequently updated if the publisher revokes and re-initiates the connection. Uses RFC 3339, where generated output will always be Z-normalized and use 0, 3, 6 or 9 fractional digits. Offsets other than "Z" are also accepted. Examples: `"2014-10-02T15:01:23Z"`, `"2014-10-02T15:01:23.045123456Z"` or `"2014-10-02T15:01:23+05:30"`. |

## PublisherPlatform

Publisher platforms from which a PublisherConnection can originate.

| Enums ||
|---|---|
| `PUBLISHER_PLATFORM_UNSPECIFIED` | An unspecified publisher platform. |
| `GOOGLE_AD_MANAGER` | A Google Ad Manager publisher. |
| `ADMOB` | An AdMob publisher. |

## State

Possible states of the publisher connection. Bidders may approve a connection in order to receive bid requests from the publisher. If a connection is rejected, no bid requests from the associated publisher will be received.

| Enums ||
|---|---|
| `STATE_UNSPECIFIED` | An unspecified bidding status. |
| `PENDING` | Indicates a request for connection from the publisher that the bidder needs to review. |
| `REJECTED` | Indicates that the publisher was rejected. |
| `APPROVED` | Indicates that the publisher was approved. |

| ## Methods ||
|---|---|
| ### `https://developers.google.com/authorized-buyers/apis/realtimebidding/reference/rest/v1/bidders.publisherConnections/batchApprove` | Batch approves multiple publisher connections. |
| ### `https://developers.google.com/authorized-buyers/apis/realtimebidding/reference/rest/v1/bidders.publisherConnections/batchReject` | Batch rejects multiple publisher connections. |
| ### `https://developers.google.com/authorized-buyers/apis/realtimebidding/reference/rest/v1/bidders.publisherConnections/get` | Gets a publisher connection. |
| ### `https://developers.google.com/authorized-buyers/apis/realtimebidding/reference/rest/v1/bidders.publisherConnections/list` | Lists publisher connections for a given bidder. |