Method: accounts.creatives.watch

  • Enables real-time monitoring of creative status changes through push notifications to a specified Pub/Sub topic.

  • Requires providing the account and creative IDs for targeted watching, with the option to monitor all creatives under an account.

  • Notifications are sent when the creative's status is updated, delivered to the designated Pub/Sub topic with necessary permissions granted.

  • Utilizes a POST request to initiate the watch process, providing the topic details in the request body.

  • Authorization necessitates the https://www.googleapis.com/auth/adexchange.buyer scope for access and operation.

Watches a creative. Will result in push notifications being sent to the topic when the creative changes status.

HTTP request

POST https://adexchangebuyer.googleapis.com/v2beta1/accounts/{accountId}/creatives/{creativeId}:watch

The URL uses gRPC Transcoding syntax.

Path parameters

Parameters
accountId

string

The account of the creative to watch.
creativeId

string

The creative ID to watch for status changes. Specify "-" to watch all creatives under the above account. If both creative-level and account-level notifications are sent, only a single notification will be sent to the creative-level notification topic.

Request body

The request body contains data with the following structure:

JSON representation 
{
  "topic": string
}
Fields
topic

string

The Pub/Sub topic to publish notifications to. This topic must already exist and must give permission to ad-exchange-buyside-reports@google.com to write to the topic. This should be the full resource name in "projects/{project_id}/topics/{topic_id}" format.

Response body

If successful, the response body is empty.

Authorization Scopes

Requires the following OAuth scope:

  • https://www.googleapis.com/auth/adexchange.buyer