- HTTP-запрос
- Тело запроса
- Тело ответа
- Области авторизации
- Метаданные продукта
- Планируемый таргетинг
- YouTubeSelectLineUp
- Комбинации SurfaceTargeting
- Попробуй это!
Возвращает список планируемых форматов рекламы YouTube с разрешенным таргетингом для каждого местоположения.
Список выброшенных ошибок: AuthenticationError AuthorizationError HeaderError InternalError QuotaError RequestError
HTTP-запрос
POST https://googleads.googleapis.com/v16:listPlannableProducts
URL-адрес использует синтаксис транскодирования gRPC .
Тело запроса
Тело запроса содержит данные следующей структуры:
JSON-представление |
---|
{ "plannableLocationId": string } |
Поля | |
---|---|
plannableLocationId | Необходимый. Идентификатор выбранного места для планирования. Чтобы получить список доступных идентификаторов планируемых местоположений, используйте |
Тело ответа
Ответ со всеми доступными товарами.
В случае успеха тело ответа содержит данные следующей структуры:
JSON-представление |
---|
{
"productMetadata": [
{
object ( |
Поля | |
---|---|
productMetadata[] | Список продуктов, доступных для планирования, и соответствующие метаданные таргетинга. |
Области авторизации
Требуется следующая область действия OAuth:
-
https://www.googleapis.com/auth/adwords
Дополнительную информацию см. в обзоре OAuth 2.0 .
Метаданные продукта
Метаданные, связанные с доступным планируемым продуктом.
JSON-представление |
---|
{
"plannableProductName": string,
"plannableTargeting": {
object ( |
Поля | |
---|---|
plannableProductName | Имя, связанное с рекламным продуктом. |
plannableTargeting | Разрешенный планируемый таргетинг для этого товара. |
plannableProductCode | Код, связанный с рекламным продуктом (например: BUMPER, TRUEVIEW_IN_STREAM). Чтобы просмотреть доступные планируемые коды продуктов, используйте |
Планируемый таргетинг
Таргетинг, для которого будут сообщаться показатели трафика.
JSON-представление |
---|
{ "ageRanges": [ enum ( |
Поля | |
---|---|
ageRanges[] | Разрешенные планируемые возрастные диапазоны для продукта, для которого будут сообщаться показатели. Фактический таргетинг рассчитывается путем сопоставления этого возрастного диапазона со стандартными значениями Google common.AgeRangeInfo. |
genders[] | Целевые гендерные группы для рекламного продукта. |
devices[] | Устройства, на которые можно настроить таргетинг рекламного продукта. Таргетинг на устройства TABLET автоматически применяется к сообщаемым показателям, если таргетинг на MOBILE выбран для продуктов CPM_MAASTHEAD, GOOGLE_PREFERRED_BUMPER и GOOGLE_PREFERRED_SHORT. |
networks[] | Целевые сети для рекламного продукта. |
youtubeSelectLineups[] | Таргетинговые подборки YouTube Select для рекламного продукта. |
surfaceTargeting | Целевые комбинации поверхностей для рекламного продукта. |
YouTubeSelectLineUp
Планируемая подборка YouTube Select для продуктового таргетинга.
JSON-представление |
---|
{ "lineupId": string, "lineupName": string } |
Поля | |
---|---|
lineupId | Идентификатор подборки YouTube Select. |
lineupName | Уникальное название подборки YouTube Select. |
Комбинации SurfaceTargeting
Комбинации поверхностного таргетинга, доступные для рекламного продукта.
JSON-представление |
---|
{ "defaultTargeting": { object ( |
Поля | |
---|---|
defaultTargeting | К рекламному продукту применен таргетинг на поверхность по умолчанию. |
availableTargetingCombinations[] | Доступные комбинации поверхностных целей для рекламного продукта. |