GOgoogle
bidders

POST /v1/bidders/{biddersId}/creatives:watch

Watches all creatives pertaining to a bidder. It is sufficient to invoke this endpoint once per bidder. A Pub/Sub topic will be created and notifications will be pushed to the topic when any of the bidder's creatives change status. All of the bidder's service accounts will have access to read from the topic. Subsequent invocations of this method will return the existing Pub/Sub configuration.

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

biddersIdstring required

Request body

WatchCreativesRequest required

A request to receive push notifications when any of the creatives belonging to the bidder changes status.

Response

Successful response

subscriptionstring

The Pub/Sub subscription that can be used to pull creative status notifications. This would be of the format projects/{project_id}/subscriptions/{subscription_id}. Subscription is created with pull delivery. All service accounts belonging to the bidder will have read access to this subscription. Subscriptions that are inactive for more than 90 days will be disabled. Use watchCreatives to re-enable the subscription.

topicstring

The Pub/Sub topic that will be used to publish creative serving status notifications. This would be of the format projects/{project_id}/topics/{topic_id}.

Changes

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