MembershipsLevels: list

Observação: esse endpoint só pode ser usado por criadores de conteúdo individuais para fazer solicitações do próprio canal do YouTube com os Clubes dos canais ativados.

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

  • Se o criador de conteúdo ativou os Clubes dos canais e tem níveis de preços, a resposta da API contém 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 contém uma lista vazia.
  • Se o criador de conteúdo não ativou os Clubes dos canais, a API retorna um channelMembershipsNotEnabled erro.

Impacto na 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 a resposta da API vai incluir. O valor de parâmetro é uma lista separada por vírgulas de partes do recurso. 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 as 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 autoriza a solicitação não tem os Clubes dos canais ativados.