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