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.
HTTP request
POST https://realtimebidding.googleapis.com/v1/{parent=bidders/*}/creatives:watch
Required. To watch all creatives pertaining to the bidder and all its child seat accounts, the bidder must follow the pattern bidders/{bidderAccountId}.
Request body
The request body must be empty.
Response body
A response for the request to receive push notification when a bidder's creatives change status.
If successful, the response body contains data with the following structure:
JSON representation
{"topic": string,"subscription": string}
Fields
topic
string
The Pub/Sub topic that will be used to publish creative serving status notifications. This would be of the format projects/{projectId}/topics/{topic_id}.
subscription
string
The Pub/Sub subscription that can be used to pull creative status notifications. This would be of the format projects/{projectId}/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.
[[["Easy to understand","easyToUnderstand","thumb-up"],["Solved my problem","solvedMyProblem","thumb-up"],["Other","otherUp","thumb-up"]],[["Missing the information I need","missingTheInformationINeed","thumb-down"],["Too complicated / too many steps","tooComplicatedTooManySteps","thumb-down"],["Out of date","outOfDate","thumb-down"],["Samples / code issue","samplesCodeIssue","thumb-down"],["Other","otherDown","thumb-down"]],["Last updated 2024-09-18 UTC."],[[["Watches all creatives for a specified bidder and its child seat accounts, delivering status change notifications via Pub/Sub."],["Utilizes a POST request to `https://realtimebidding.googleapis.com/v1/{parent=bidders/*}/creatives:watch`, with the bidder ID specified in the path."],["Returns a Pub/Sub topic and subscription for receiving creative status notifications, accessible to the bidder's service accounts."],["Requires the `https://www.googleapis.com/auth/realtime-bidding` OAuth scope for authorization."],["Inactive subscriptions (90+ days) are disabled and can be re-enabled using the `watchCreatives` method."]]],[]]
