Мы обновляем API данных, чтобы он соответствовал тому, как YouTube подсчитывает просмотры коротких видео.
Узнать больше
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. Значение параметра представляет собой список частей ресурса, разделенных запятыми. В следующем списке показаны части, которые можно получить:
|
Тело запроса
Не указывайте тело запроса при вызове этого метода.
Ответ
В случае успеха этот метод возвращает тело ответа следующей структуры:
{
"kind": "youtube#membershipsLevelListResponse",
"etag": etag,
"items": [
membershipsLevel Resource
]
} Характеристики
В следующей таблице определены свойства, которые появляются в этом ресурсе:
| Характеристики |
|---|
kind | string
Идентифицирует тип ресурса API. Значением будет youtube#membershipsLevelListResponse . |
etag | etag
Etag этого ресурса. |
items[] | list
Список ресурсов membershipsLevel принадлежащих каналу, авторизовавшему запрос API. |
Ошибки
В следующей таблице указаны сообщения об ошибках, которые API может вернуть в ответ на вызов этого метода. Более подробную информацию см. в документации по сообщениям об ошибках .
| Тип ошибки | Детализация ошибки | Описание |
|---|
badRequest (400) | channelMembershipsNotEnabled | Канал автора, авторизующий запрос, не поддерживает членство в канале. |
Если не указано иное, контент на этой странице предоставляется по лицензии Creative Commons "С указанием авторства 4.0", а примеры кода – по лицензии Apache 2.0. Подробнее об этом написано в правилах сайта. Java – это зарегистрированный товарный знак корпорации Oracle и ее аффилированных лиц.
Последнее обновление: 2024-04-26 UTC.
[null,null,["Последнее обновление: 2024-04-26 UTC."],[[["\u003cp\u003eThis API endpoint allows individual YouTube creators with channel memberships enabled to retrieve a list of their channel's membership levels.\u003c/p\u003e\n"],["\u003cp\u003eThe API response will either include a list of membership levels, an empty list if memberships are enabled but no levels are set, or an error if memberships are not enabled.\u003c/p\u003e\n"],["\u003cp\u003eA successful request returns a JSON response containing the resource type, Etag, and a list of \u003ccode\u003emembershipsLevel\u003c/code\u003e resources.\u003c/p\u003e\n"],["\u003cp\u003eRequests to this method have a quota cost of 1 unit and require authorization with the scope \u003ccode\u003ehttps://www.googleapis.com/auth/youtube.channel-memberships.creator\u003c/code\u003e.\u003c/p\u003e\n"],["\u003cp\u003eThe request requires the \u003ccode\u003epart\u003c/code\u003e parameter with a string value that can contain either \u003ccode\u003eid\u003c/code\u003e, \u003ccode\u003esnippet\u003c/code\u003e, or both, as comma separated values.\u003c/p\u003e\n"]]],["This API endpoint allows individual creators to retrieve channel membership levels for their YouTube channel. A `GET` request requires authorization with the `youtube.channel-memberships.creator` scope and the `part` parameter to specify the properties. The response, in JSON format, lists membership levels or an empty list if levels are undefined. If channel memberships aren't enabled, the API returns a `channelMembershipsNotEnabled` error. This method has a quota cost of 1 unit per call.\n"],null,["# MembershipsLevels: list\n\nNote: This endpoint can only be used by individual creators to make requests for their own, channel-memberships-enabled YouTube channel. Reach out to your Google or YouTube representative to request access.\n\nLists membership levels for the channel that authorized the request. Levels are returned in\nimplicit display order. API requests to this method yield one of the following responses:\n\n- If the creator has enabled channel memberships and has pricing levels, then the API response contains the list of levels.\n- If the creator has enabled channel memberships but has not defined pricing levels, then the API response contains an empty list.\n- If the creator has not enabled channel memberships, the API returns a [channelMembershipsNotEnabled](#errors) error.\n\n**Quota impact:** A call to this method has a\n[quota cost](/youtube/v3/getting-started#quota) of 1 unit.\n\nRequest\n-------\n\n### HTTP request\n\n```\nGET https://www.googleapis.com/youtube/v3/membershipsLevels\n```\nThis request requires authorization with the following scope:\n\n| Scope |\n|-----------------------------------------------------------------------|\n| `https://www.googleapis.com/auth/youtube.channel-memberships.creator` |\n\n### Parameters\n\nThe following table lists the parameters that this query supports. All of the parameters listed are query parameters.\n\n| Parameters ||\n|--------|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|---|\n| **Required parameters** |||\n| `part` | `string` The **part** parameter specifies the `membershipsLevel` resource properties that the API response will include. The parameter value is a comma-separated list of resource parts. The following list shows the parts that can be retrieved: - `id` - `snippet` |\n\n### Request body\n\nDo not provide a request body when calling this method.\n\nResponse\n--------\n\nIf successful, this method returns a response body with the following structure: \n\n```objective-c\n{\n \"kind\": \"youtube#membershipsLevelListResponse\",\n \"etag\": etag,\n \"items\": [\n membershipsLevel Resource\n ]\n}\n```\n\n### Properties\n\nThe following table defines the properties that appear in this resource:\n\n| Properties ||\n|-----------|--------------------------------------------------------------------------------------------------------|\n| `kind` | `string` Identifies the API resource's type. The value will be `youtube#membershipsLevelListResponse`. |\n| `etag` | `etag` The Etag of this resource. |\n| `items[]` | `list` A list of `membershipsLevel` resources owned by the channel that authorized the API request. |\n\nErrors\n------\n\nThe following table identifies error messages that the API could return in response to a call to this method. Please see the [error message](/youtube/v3/docs/errors) documentation for more detail.\n\n| Error type | Error detail | Description |\n|--------------------|--------------------------------|----------------------------------------------------------------------------------------|\n| `badRequest (400)` | `channelMembershipsNotEnabled` | The creator channel authorizing the request does not have channel memberships enabled. |"]]
