Method: partners.channels.sites.list

Возвращает список сайтов в канале.

HTTP-запрос

GET https://displayvideo.googleapis.com/v5/partners/{partnerId}/channels/{channelId}/sites

URL имеет синтаксис gRPC Transcoding.

Параметры пути

Параметры
channelId

string (int64 format)

Обязательно. Идентификатор родительского канала, к которому относятся запрашиваемые сайты.
Обязательно. Идентифицирует объект DV360, которому принадлежит родительский канал. Это может быть как партнер, так и рекламодатель. Ниже приведен список взаимоисключающих полей. В ответе будет задано не более одного из следующих полей:
partnerId

string (int64 format)

Идентификатор партнера, которому принадлежит родительский канал.
Конец взаимоисключающих полей.

Параметры запроса

Параметры
pageSize

integer

Запрошенный размер страницы. Значение должно быть в диапазоне от 1 до 10000. Если не указано, по умолчанию будет использоваться 100. Если указано недопустимое значение, возвращается код ошибки INVALID_ARGUMENT.
pageToken

string

Токен, идентифицирующий страницу результатов, которую должен вернуть сервер.

Обычно это значение nextPageToken, возвращенное предыдущим вызовом метода sites.list. Если значение не указано, будет возвращена первая страница результатов.
orderBy

string

Поле, по которому нужно отсортировать список. Допустимые значения:

  • urlOrAppId (по умолчанию)

По умолчанию используется порядок сортировки по возрастанию. Чтобы указать порядок по убыванию, добавьте к названию поля суффикс " desc". Пример: urlOrAppId desc.
filter

string

Позволяет фильтровать данные по полям сайта.

Поддерживаемый синтаксис:

  • Выражения фильтра для получения сайтов могут содержать не более одного ограничения.
  • Ограничение имеет следующий формат: {field} {operator} {value}.
  • Во всех полях должен использоваться оператор HAS (:).

Поддерживаемые поля:

  • urlOrAppId

Примеры:

  • Все сайты, URL или идентификатор приложения которых содержит "google": urlOrAppId : "google".

Длина этого поля не должна превышать 500 символов.

Подробную информацию вы найдете в руководстве по фильтрации запросов LIST.
Обязательно. Идентифицирует объект DV360, которому принадлежит родительский канал. Это может быть как партнер, так и рекламодатель. Ниже приведен список взаимоисключающих полей. В ответе будет задано не более одного из следующих полей:
advertiserId

string (int64 format)

Идентификатор рекламодателя, которому принадлежит родительский канал.
Конец взаимоисключающих полей.

Тело запроса

Тело запроса должно быть пустым.

Тело ответа

Если ответ получен успешно, его тело содержит экземпляр ListSitesResponse.

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

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

  • https://www.googleapis.com/auth/display-video

Дополнительную информацию вы найдете в OAuth 2.0 Overview.