Adunits.customchannels: list

Требуется авторизация

Создает список всех клиентских каналов, связанных с данным рекламным блоком. Попробовать...

Запрос

HTTP-запрос

GET https://www.googleapis.com/adsense/v1.4/adclients/adClientId/adunits/adUnitId/customchannels

Параметры

Имя параметра Значение Описание
Параметры пути
adClientId string Рекламный клиент, в котором содержится рекламный блок.
adUnitId string Рекламный блок, для которого необходимо создать список клиентских каналов.
Необязательные параметры запроса
maxResults integer Максимальное число клиентских каналов в ответе. Используется для разбивки на страницы. Возможные значения: от 0 до 10000 включительно.
pageToken string Токен продолжения. Используется для постраничного просмотра клиентских каналов. Чтобы получить следующую страницу результатов, задайте для этого параметра значение nextPageToken из предыдущего ответа.

Авторизация

Этот запрос требует авторизации с использованием хотя бы одного из указанных ниже диапазонов. Подробнее об аутентификации и авторизации...

Диапазон
https://www.googleapis.com/auth/adsense
https://www.googleapis.com/auth/adsense.readonly

Тело запроса

При работе с данным методом тело запроса не используется.

Ответ

В случае успеха этот метод возвращает тело ответа со следующей структурой:

{
  "kind": "adsense#customChannels",
  "etag": etag,
  "nextPageToken": string,
  "items": [
    {
      "kind": "adsense#customChannel",
      "id": string,
      "code": string,
      "name": string,
      "targetingInfo": {
        "adsAppearOn": string,
        "location": string,
        "description": string,
        "siteLanguage": string
      }
    }
  ]
}
Имя свойства Значение Описание Примечания
kind string Тип списка, в данном случае adsense#customChannels.
etag etag ETag данного ответа (для кеширования).
nextPageToken string Токен продолжения. Используется для постраничного просмотра клиентских каналов. Чтобы получить следующую страницу результатов, необходимо присвоить это значение параметру pageToken в следующем запросе.
items[] list Клиентские каналы, возвращаемые в ответе.
items[].kind string Тип ресурса, в данном случае adsense#customChannel.
items[].id string Уникальный идентификатор данного клиентского канала. Это непрозрачный идентификатор без какого-либо определенного формата.
items[].code string Код данного клиентского канала, не обязательно уникальный в данном рекламном клиенте.
items[].name string Название данного клиентского канала.
items[].targetingInfo object Информация о таргетинге для данного клиентского канала (если он активирован).
items[].targetingInfo.adsAppearOn string Внешнее название данного канала.
items[].targetingInfo.location string Места показа рекламы (только для контента и мобильного контента). Допустимые значения для объявлений в контенте: TOP_LEFT, TOP_CENTER, TOP_RIGHT, MIDDLE_LEFT, MIDDLE_CENTER, MIDDLE_RIGHT, BOTTOM_LEFT, BOTTOM_CENTER, BOTTOM_RIGHT, MULTIPLE_LOCATIONS. Допустимые значения для объявлений в мобильном контенте: TOP, MIDDLE, BOTTOM, MULTIPLE_LOCATIONS.

Возможные значения:
  • "BOTTOM":
  • "BOTTOM_CENTER":
  • "BOTTOM_LEFT":
  • "BOTTOM_RIGHT":
  • "MIDDLE":
  • "MIDDLE_CENTER":
  • "MIDDLE_LEFT":
  • "MIDDLE_RIGHT":
  • "MULTIPLE_LOCATIONS":
  • "TOP":
  • "TOP_CENTER":
  • "TOP_LEFT":
  • "TOP_RIGHT":
items[].targetingInfo.description string Внешнее описание канала.
items[].targetingInfo.siteLanguage string Язык сайтов, на которых будут показаны объявления.

Попробуйте!

Воспользуйтесь сервисом API Explorer, чтобы вызвать этот метод и оценить результаты.