Method: listPlannableProducts

Возвращает список планируемых форматов рекламы YouTube с разрешенным таргетингом для каждого местоположения.

Список выброшенных ошибок: AuthenticationError AuthorizationError HeaderError InternalError QuotaError RequestError

HTTP-запрос

POST https://googleads.googleapis.com/v16:listPlannableProducts

URL-адрес использует синтаксис транскодирования gRPC .

Тело запроса

Тело запроса содержит данные следующей структуры:

JSON-представление
{
  "plannableLocationId": string
}
Поля
plannableLocationId

string

Необходимый. Идентификатор выбранного места для планирования. Чтобы получить список доступных идентификаторов планируемых местоположений, используйте ReachPlanService.ListPlannableLocations .

Тело ответа

Ответ со всеми доступными товарами.

В случае успеха тело ответа содержит данные следующей структуры:

JSON-представление
{
  "productMetadata": [
    {
      object (ProductMetadata)
    }
  ]
}
Поля
productMetadata[]

object ( ProductMetadata )

Список продуктов, доступных для планирования, и соответствующие метаданные таргетинга.

Области авторизации

Требуется следующая область действия OAuth:

  • https://www.googleapis.com/auth/adwords

Дополнительную информацию см. в обзоре OAuth 2.0 .

Метаданные продукта

Метаданные, связанные с доступным планируемым продуктом.

JSON-представление
{
  "plannableProductName": string,
  "plannableTargeting": {
    object (PlannableTargeting)
  },
  "plannableProductCode": string
}
Поля
plannableProductName

string

Имя, связанное с рекламным продуктом.

plannableTargeting

object ( PlannableTargeting )

Разрешенный планируемый таргетинг для этого товара.

plannableProductCode

string

Код, связанный с рекламным продуктом (например: BUMPER, TRUEVIEW_IN_STREAM). Чтобы просмотреть доступные планируемые коды продуктов, используйте ReachPlanService.ListPlannableProducts .

Планируемый таргетинг

Таргетинг, для которого будут сообщаться показатели трафика.

JSON-представление
{
  "ageRanges": [
    enum (ReachPlanAgeRange)
  ],
  "genders": [
    {
      object (GenderInfo)
    }
  ],
  "devices": [
    {
      object (DeviceInfo)
    }
  ],
  "networks": [
    enum (ReachPlanNetwork)
  ],
  "youtubeSelectLineups": [
    {
      object (YouTubeSelectLineUp)
    }
  ],
  "surfaceTargeting": {
    object (SurfaceTargetingCombinations)
  }
}
Поля
ageRanges[]

enum ( ReachPlanAgeRange )

Разрешенные планируемые возрастные диапазоны для продукта, для которого будут сообщаться показатели. Фактический таргетинг рассчитывается путем сопоставления этого возрастного диапазона со стандартными значениями Google common.AgeRangeInfo.

genders[]

object ( GenderInfo )

Целевые гендерные группы для рекламного продукта.

devices[]

object ( DeviceInfo )

Устройства, на которые можно настроить таргетинг рекламного продукта. Таргетинг на устройства TABLET автоматически применяется к сообщаемым показателям, если таргетинг на MOBILE выбран для продуктов CPM_MAASTHEAD, GOOGLE_PREFERRED_BUMPER и GOOGLE_PREFERRED_SHORT.

networks[]

enum ( ReachPlanNetwork )

Целевые сети для рекламного продукта.

youtubeSelectLineups[]

object ( YouTubeSelectLineUp )

Таргетинговые подборки YouTube Select для рекламного продукта.

surfaceTargeting

object ( SurfaceTargetingCombinations )

Целевые комбинации поверхностей для рекламного продукта.

YouTubeSelectLineUp

Планируемая подборка YouTube Select для продуктового таргетинга.

JSON-представление
{
  "lineupId": string,
  "lineupName": string
}
Поля
lineupId

string ( int64 format)

Идентификатор подборки YouTube Select.

lineupName

string

Уникальное название подборки YouTube Select.

Комбинации SurfaceTargeting

Комбинации поверхностного таргетинга, доступные для рекламного продукта.

JSON-представление
{
  "defaultTargeting": {
    object (SurfaceTargeting)
  },
  "availableTargetingCombinations": [
    {
      object (SurfaceTargeting)
    }
  ]
}
Поля
defaultTargeting

object ( SurfaceTargeting )

К рекламному продукту применен таргетинг на поверхность по умолчанию.

availableTargetingCombinations[]

object ( SurfaceTargeting )

Доступные комбинации поверхностных целей для рекламного продукта.