MembershipsLevels: list

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

Перечисляет уровни членства для канала, авторизовавшего запрос. Уровни возвращаются в неявном порядке отображения. Запросы 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 Канал автора, авторизующий запрос, не поддерживает членство в канале.