MembershipsLevels: list

Nota: Solo los creadores individuales pueden usar este extremo a fin de realizar solicitudes para su propio canal de YouTube compatible con las membresías del canal. Comunícate con tu representante de Google o YouTube para solicitar acceso.

Enumera los niveles de membresía del canal que autorizó la solicitud. Los niveles se muestran en un orden de visualización implícito. Las solicitudes de API a este método producen una de las siguientes respuestas:

  • Si el creador habilitó las membresías del canal y tiene niveles de precios, la respuesta de la API contendrá la lista de niveles.
  • Si el creador habilitó las membresías del canal, pero no definió los niveles de precios, la respuesta de la API contendrá una lista vacía.
  • Si el creador no habilitó las membresías del canal, la API muestra un error channelMembershipsNotEnabled.

Impacto en la cuota: Una llamada a este método tiene un costo de cuota de 1 unidad.

Solicitud

Solicitud HTTP

GET https://www.googleapis.com/youtube/v3/membershipsLevels

Esta solicitud requiere una autorización con el siguiente alcance:

Alcance
https://www.googleapis.com/auth/youtube.channel-memberships.creator

Parámetros

En la siguiente tabla, se enumeran los parámetros que admite esta consulta. Todos los parámetros mencionados son parámetros de consulta.

Parámetros
Parámetros obligatorios
part string
El parámetro part especifica las propiedades del recurso membershipsLevel que incluirá la respuesta de la API. El valor del parámetro es una lista separada por comas de las partes de los recursos. En la siguiente lista, se muestran las partes que se pueden recuperar:
  • id
  • snippet

Cuerpo de la solicitud

No proporciones un cuerpo de solicitud cuando invoques este método.

Respuesta

Si se aplica correctamente, este método muestra un cuerpo de respuesta con la siguiente estructura:

{
  "kind": "youtube#membershipsLevelListResponse",
  "etag": etag,
  "items": [
    membershipsLevel Resource
  ]
}

Propiedades

La siguiente tabla define las propiedades que aparecen en este recurso:

Propiedades
kind string
Identifica el tipo de recurso de API. El valor será youtube#membershipsLevelListResponse.
etag etag
Es la Etag de este recurso.
items[] list
Es una lista de recursos de membershipsLevel que pertenecen al canal que autorizó la solicitud a la API.

Errores

En la siguiente tabla se identifican los mensajes de error que la API podría mostrar en respuesta a una llamada a este método. Consulta la documentación sobre mensajes de error para obtener más información.

Tipo de error Detalle del error Descripción
badRequest (400) channelMembershipsNotEnabled El canal del creador que autoriza la solicitud no tiene habilitadas las membresías del canal.