Требуется авторизация
Создает список всех клиентских каналов, связанных с данным рекламным блоком. Попробовать...
Запрос
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. Возможные значения:
| |
items[].targetingInfo.description | string | Внешнее описание канала. | |
items[].targetingInfo.siteLanguage | string | Язык сайтов, на которых будут показаны объявления. |
Попробуйте!
Воспользуйтесь сервисом API Explorer, чтобы вызвать этот метод и оценить результаты.