MembershipsLevels: list

Observação: esse endpoint só pode ser usado por criadores de conteúdo para fazer solicitações aos próprios canais do YouTube com Clubes dos canais ativados. Entre em contato com seu representante do Google ou do YouTube para solicitar acesso.

Lista os níveis de assinatura do canal que autorizou a solicitação. Os níveis são retornados em ordem de exibição implícita. As solicitações de API para esse método produzem uma das seguintes respostas:

  • Se o criador de conteúdo tiver ativado os Clubes dos canais e tiver níveis de preços, a resposta da API conterá a lista de níveis.
  • Se o criador de conteúdo ativou os Clubes dos canais, mas não definiu níveis de preços, a resposta da API conterá uma lista vazia.
  • Se o criador de conteúdo não tiver ativado os Clubes dos canais, a API retornará um erro channelMembershipsNotEnabled.

Impacto da cota:uma chamada para esse método tem um custo de cota de 1 unidade.

Solicitação

Solicitação HTTP

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

Esta solicitação requer autorização com o seguinte escopo:

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

Parâmetros

A tabela a seguir lista os parâmetros compatíveis com essa consulta. Todos os parâmetros listados são os parâmetros de consulta.

Parâmetros
Parâmetros obrigatórios
part string
O parâmetro part especifica as propriedades do recurso membershipsLevel que serão incluídas pela resposta da API. O valor do parâmetro é uma lista separada por vírgulas de partes de recursos. A lista a seguir mostra as partes que podem ser recuperadas:
  • id
  • snippet

Corpo da solicitação

Não forneça um corpo de solicitação ao chamar este método.

Resposta

Se for bem-sucedido, esse método retornará um corpo de resposta com esta estrutura:

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

Propriedades

A tabela a seguir define as propriedades que aparecem neste recurso:

Propriedades
kind string
Identifica o tipo de recurso da API. O valor será youtube#membershipsLevelListResponse.
etag etag
A Etag desse recurso.
items[] list
Uma lista de membershipsLevel recursos pertencentes ao canal que autorizou a solicitação de API.

Erros

A tabela a seguir identifica mensagens de erro que a API pode retornar em resposta a uma chamada para esse método. Consulte a documentação mensagem de erro para mais detalhes.

Tipo de erro Detalhe do erro Descrição
badRequest (400) channelMembershipsNotEnabled O canal do criador de conteúdo que autorizou a solicitação não está com os Clubes dos canais ativados.