MembershipsLevels: list

Примечание: Этот адрес электронной почты могут использовать только отдельные авторы для отправки запросов на свой собственный 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 У канала автора, подтвердившего запрос, не включена функция членства в канале.