MembershipsLevels: list

Примечание. Этот конечный адрес может использоваться только авторами, чтобы отправлять запросы для своих каналов, на которых включено спонсорство.

Возвращает список уровней спонсорства для канала, который авторизовал запрос. Уровни возвращаются в порядке неявного отображения. Запросы к API к этому методу возвращают один из следующих ответов:

  • Если автор включил спонсорство и настроил уровни, ответ API будет содержать список уровней.
  • Если автор включил спонсорство, но не определил уровни цен, ответ API будет содержать пустой список.
  • Если автор не включил спонсорство на канале, API возвращает ошибку channelMembershipsNotEnabled.

Влияние на квоту. Вызов этого метода сокращает квоту на 1 единицу.

Запрос

HTTP-запрос

GET https://www.googleapis.com/youtube/v3/membershipsLevels

Для этого запроса требуется авторизация в указанной ниже области действия:

Область действия
https://www.googleapis.com/auth/youtube.channel-memberships.creator

Параметры

В таблице ниже перечислены параметры, которые поддерживает этот запрос. Все перечисленные параметры являются параметрами запроса.

Параметры
Обязательные параметры
part string
Параметр part указывает свойства ресурса membershipsLevel, которые будут включены в ответ API. Значение параметра представляет собой список частей ресурса, разделенных запятыми. Ниже перечислены части, которые можно получить:
  • id
  • snippet

Тело запроса

При вызове этого метода не указывайте тело запроса.

Ответ

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

{
  "kind": "youtube#membershipsLevelListResponse",
  "etag": etag,
  "items": [
    membershipsLevel Resource
  ]
}

Свойства

В таблице ниже описаны свойства, которые появляются в этом ресурсе.

Свойства
kind string
Тип ресурса API. Значение будет youtube#membershipsLevelListResponse.
etag etag
Тег Etag этого ресурса.
items[] list
Список ресурсов membershipsLevel, принадлежащих каналу, который авторизовал запрос к API.

Ошибки

В таблице ниже перечислены сообщения об ошибках, которые API может возвращать в ответ на вызов этого метода. Подробную информацию можно найти в документации по сообщениям об ошибках.

Тип ошибки Сведения об ошибке Описание
badRequest (400) channelMembershipsNotEnabled На канале автора, который авторизует запрос, не включено спонсорство.