Display & Video 360 API (displayvideo:v4)

2026-06-24

5 new methods

Additions

    Methods
  • displayvideo.advertisers.reachForecast.retrievePlannableLocations

      Parameter Order : advertiserId

      Description : Retrieves the list of countries where reach forecasting is supported.

      Path : v4/advertisers/{+advertiserId}/reachForecast:retrievePlannableLocations

      Flat Path : v4/advertisers/{advertisersId}/reachForecast:retrievePlannableLocations

      Parameters :

        advertiserId

          Pattern : ^[^/]+$

          Location : path

          Required : Yes

          Format : int64

          Description : Required. The ID of the advertiser to list plannable locations for.

          Type : string

      HTTP Method : GET

      Scopes : https://www.googleapis.com/auth/display-video

  • displayvideo.advertisers.reachForecast.generateReachForecast

      HTTP Method : POST

      Scopes : https://www.googleapis.com/auth/display-video

      Path : v4/advertisers/{+advertiserId}/reachForecast:generateReachForecast

      Flat Path : v4/advertisers/{advertisersId}/reachForecast:generateReachForecast

      Parameters :

        advertiserId

          Pattern : ^[^/]+$

          Location : path

          Required : Yes

          Format : int64

          Type : string

          Description : Required. The ID of the advertiser that will run the planned campaign.

      Description : Generates a reach forecast for a given advertiser and targeting configuration.

      Parameter Order : advertiserId

  • displayvideo.advertisers.reachForecast.retrievePlannableProducts

      HTTP Method : GET

      Scopes : https://www.googleapis.com/auth/display-video

      Path : v4/advertisers/{+advertiserId}/reachForecast:retrievePlannableProducts

      Flat Path : v4/advertisers/{advertisersId}/reachForecast:retrievePlannableProducts

      Parameters :

        advertiserId

          Pattern : ^[^/]+$

          Location : path

          Required : Yes

          Format : int64

          Description : Required. The ID of the advertiser to list plannable products for.

          Type : string

        plannableLocationId

          Description : Required. The ID of the plannable location.

          Location : query

          Type : string

      Description : Retrieves the list of products that can be planned for a location.

      Parameter Order : advertiserId

  • displayvideo.advertisers.reachForecast.retrievePlannableUserLists

      Path : v4/advertisers/{+advertiserId}/reachForecast:retrievePlannableUserLists

      Flat Path : v4/advertisers/{advertisersId}/reachForecast:retrievePlannableUserLists

      Parameters :

        pageToken

          Description : Optional. A token identifying a page of results the server should return. Typically, this is the value of next_page_token returned from the previous call to `RetrievePlannableUserLists` method. If not specified, the first page of results will be returned.

          Location : query

          Type : string

        pageSize

          Description : Optional. Requested page size. Must be between `1` and `5000`. If unspecified will default to `5000`.

          Location : query

          Type : integer

          Format : int32

        filter

          Location : query

          Type : string

          Description : Optional. Allows filtering by plannable user list properties. Supported syntax: * Filter expressions are made up of one or more restrictions. * Restrictions can be combined by `AND` or `OR` logical operators. * A restriction has the form of `{field} {operator} {value}`. * The `updateTime` field must use the `GREATER THAN OR EQUAL TO (>=)` or `LESS THAN OR EQUAL TO (<=)` operators. * All other fields must use the `EQUALS (=)` operator. Supported fields: * `plannableStatus` Examples: * All plannable user lists: `plannableStatus="PLANNABLE"` The length of this field should be no more than 500 characters. Reference our [filter `LIST` requests](/display-video/api/guides/how-tos/filters) guide for more information.

        advertiserId

          Pattern : ^[^/]+$

          Location : path

          Required : Yes

          Format : int64

          Type : string

          Description : Required. The ID of the advertiser to retrieve plannable user lists for.

      HTTP Method : GET

      Scopes : https://www.googleapis.com/auth/display-video

      Parameter Order : advertiserId

      Description : Retrieves first and third party user lists available for forecasting.

  • displayvideo.advertisers.reachForecast.retrievePlannableUserInterests

      Parameter Order : advertiserId

      Description : Retrieves Google Audiences (User Interests) available for forecasting.

      Path : v4/advertisers/{+advertiserId}/reachForecast:retrievePlannableUserInterests

      Flat Path : v4/advertisers/{advertisersId}/reachForecast:retrievePlannableUserInterests

      Parameters :

        advertiserId

          Description : Required. The ID of the advertiser to list plannable user interests for.

          Type : string

          Pattern : ^[^/]+$

          Location : path

          Required : Yes

          Format : int64

        productCategory

          Type : string

          Enum Descriptions :

        • Not specified.
        • YouTube.
        • Open Auction.
        • Enum :

        • PLANNABLE_PRODUCT_CATEGORY_UNSPECIFIED
        • YOUTUBE
        • OPEN_AUCTION
        • Description : Required. The product category to retrieve plannable user interests for.

          Location : query

      HTTP Method : GET

      Scopes : https://www.googleapis.com/auth/display-video