---
title: "GET /v4/advertisers/{advertisersId}/reachForecast:retrievePlannableProducts"
method: GET
path: "/v4/advertisers/{advertisersId}/reachForecast:retrievePlannableProducts"
tags: ["advertisers"]
---

# GET /v4/advertisers/{advertisersId}/reachForecast:retrievePlannableProducts

`GET /v4/advertisers/{advertisersId}/reachForecast:retrievePlannableProducts`

## Request

- Base URL: `https://displayvideo.googleapis.com`
- URL: `https://displayvideo.googleapis.com/v4/advertisers/{advertisersId}/reachForecast:retrievePlannableProducts`
- Auth: OAuth 2 and OAuth 2
  - Implicit: `https://accounts.google.com/o/oauth2/auth`
  - Scopes: `https://www.googleapis.com/auth/display-video`
  - Authorization code: `https://accounts.google.com/o/oauth2/auth`
  - Token URL: `https://accounts.google.com/o/oauth2/token` scopes: `https://www.googleapis.com/auth/display-video`
- TypeScript: <https://skmtc.dev/google/apis/displayvideo/docs/v4/advertisers/:advertisersId/reachForecast:retrievePlannableProducts/get.ts> (a function with typed inputs; its response is checked against the schema)

Retrieves the list of products that can be planned for a location. API support for generating reach forecasts and retrieving related metadata is in beta. This method is only available to allowlisted users.

## Path parameters

- `advertisersId` string, required

## Query parameters

- `plannableLocationId` string

## Response `200`

Successful response

- RetrievePlannableProductsResponse: Response for RetrievePlannableProducts
  - `productMetadata` ProductMetadata[]: Output only. The list of product metadata showing targeting possibilities.
    - `displayName` string: Output only. The name associated with the ad product. For example: "Video View Campaign".
    - `plannableProductCode` string: Output only. The plannable product code (e.g. "YOUTUBE_REACH_MIX").
    - `plannableProductCoreAttributes` PlannableProductCoreAttributes: Core attributes for a plannable product.
      - `buyingMethod` 'PLANNABLE_BUYING_METHOD_UNSPECIFIED' | 'PLANNABLE_BUYING_METHOD_AUCTION' | 'PLANNABLE_BUYING_METHOD_RESERVATION': Output only. The buying method.
      - `costModel` 'PLANNABLE_COST_MODEL_UNSPECIFIED' | 'PLANNABLE_COST_MODEL_CPM' | 'PLANNABLE_COST_MODEL_CPV' | 'PLANNABLE_COST_MODEL_CPC' | 'PLANNABLE_COST_MODEL_CPA': Output only. The cost model.
      - `productCategory` 'PLANNABLE_PRODUCT_CATEGORY_UNSPECIFIED' | 'YOUTUBE' | 'OPEN_AUCTION': Output only. The product category.
    - `plannableProductDescription` string: Output only. The plain-text description of the ad product.
    - `plannableTargeting` PlannableTargeting: Targeting capabilities for a given product.
      - `ageRanges` string[]: Output only. Allowed plannable age ranges for the product. Actual targeting is computed by mapping this age range onto standard Google age targeting.
      - `defaultYoutubeSelectLineup` YouTubeSelectLineUp: A Plannable YouTube Select Lineup for product targeting.
        - `displayName` string: Output only. The display name of the YouTube Select Lineup.
        - `lineupId` string, int64: Output only. The ID of the YouTube Select Lineup.
      - `devices` string[]: Output only. Targetable devices for the ad product.
      - `genders` string[]: Output only. Targetable genders for the ad product.
      - `networks` string[]: Output only. Targetable networks for the ad product.
      - `surfaceTargetingCombinations` SurfaceTargetingCombinations: Surface targeting rules.
        - `availableSurfaceTypes` string[]: Output only. The surface types available.
        - `defaultSurfaceTypes` string[]: Output only. The default surface types for this product.
        - `validSurfaceCombinations` SurfaceTargetingCombination[]: Output only. Valid combinations of surfaces that can be selected together.
          - `choices` string[]: Output only. The combination of surfaces.
      - `youtubeSelectLineups` YouTubeSelectLineUp[]: Output only. Targetable YouTube Select Lineups for the ad product.
        - `displayName` string: Output only. The display name of the YouTube Select Lineup.
        - `lineupId` string, int64: Output only. The ID of the YouTube Select Lineup.

---

[API](https://skmtc.dev/google/apis/displayvideo.md) - [All operations](https://skmtc.dev/google/apis/displayvideo/llms.txt) - [OpenAPI document](https://skmtc.dev/google/apis/displayvideo/revisions/d80b56b6703a?raw)