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."],[[["\u003cp\u003eWatches all creatives for a specified bidder and its child seat accounts, delivering status change notifications via Pub/Sub.\u003c/p\u003e\n"],["\u003cp\u003eUtilizes a POST request to \u003ccode\u003ehttps://realtimebidding.googleapis.com/v1/{parent=bidders/*}/creatives:watch\u003c/code\u003e, with the bidder ID specified in the path.\u003c/p\u003e\n"],["\u003cp\u003eReturns a Pub/Sub topic and subscription for receiving creative status notifications, accessible to the bidder's service accounts.\u003c/p\u003e\n"],["\u003cp\u003eRequires the \u003ccode\u003ehttps://www.googleapis.com/auth/realtime-bidding\u003c/code\u003e OAuth scope for authorization.\u003c/p\u003e\n"],["\u003cp\u003eInactive subscriptions (90+ days) are disabled and can be re-enabled using the \u003ccode\u003ewatchCreatives\u003c/code\u003e method.\u003c/p\u003e\n"]]],[],null,["- [HTTP request](#body.HTTP_TEMPLATE)\n- [Path parameters](#body.PATH_PARAMETERS)\n- [Request body](#body.request_body)\n- [Response body](#body.response_body)\n - [JSON representation](#body.WatchCreativesResponse.SCHEMA_REPRESENTATION)\n- [Authorization scopes](#body.aspect)\n- [Try it!](#try-it)\n\nWatches 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.\n\nHTTP request\n\n`POST https://realtimebidding.googleapis.com/v1/{parent=bidders/*}/creatives:watch`\n\nThe URL uses [gRPC Transcoding](https://google.aip.dev/127) syntax.\n\nPath parameters\n\n| Parameters ||\n|----------|---------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `parent` | `string` Required. To watch all creatives pertaining to the bidder and all its child seat accounts, the bidder must follow the pattern `bidders/{bidderAccountId}`. |\n\nRequest body\n\nThe request body must be empty.\n\nResponse body A response for the request to receive push notification when a bidder's creatives change status.\n\nIf successful, the response body contains data with the following structure:\n\n| JSON representation |\n|-----------------------------------------------------|\n| ``` { \"topic\": string, \"subscription\": string } ``` |\n\n| Fields ||\n|----------------|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `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}`. |\n| `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](/authorized-buyers/apis/realtimebidding/reference/rest/v1/bidders.creatives/watch#google.ads.realtimebidding.v1.Creatives.WatchCreatives) to re-enable the subscription. |\n\nAuthorization scopes\n\nRequires the following OAuth scope:\n\n- `https://www.googleapis.com/auth/realtime-bidding`"]]
