Список уровней членства для канала, авторизовавшего запрос. Уровни возвращаются в неявном порядке отображения. Запросы 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. Значение параметра представляет собой список частей ресурсов, разделенных запятыми. В следующем списке показаны части, которые можно получить:
|
Тело запроса
Не указывайте тело запроса при вызове этого метода.
Ответ
В случае успеха этот метод возвращает тело ответа со следующей структурой:
{ "kind": "youtube#membershipsLevelListResponse", "etag": etag, "items": [ membershipsLevel Resource ] }
Характеристики
В следующей таблице определены свойства, которые появляются в этом ресурсе:
Характеристики | |
---|---|
kind | string Идентифицирует тип ресурса API. Значение будет youtube#membershipsLevelListResponse . |
etag | etag Etag этого ресурса. |
items[] | list Список ресурсов membershipsLevel , принадлежащих каналу, авторизовавшему запрос API. |
Ошибки
В следующей таблице указаны сообщения об ошибках, которые API может возвращать в ответ на вызов этого метода. Более подробную информацию см. в документации по сообщениям об ошибках .
Тип ошибки | Сведения об ошибке | Описание |
---|---|---|
badRequest (400) | channelMembershipsNotEnabled | Канал создателя, авторизовавший запрос, не имеет включенного членства в канале. |