MembershipsLevels: list

Observação: esse endpoint só pode ser usado por criadores de conteúdo individuais para fazer solicitações para o próprio canal do YouTube habilitado para Clubes dos canais. 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 geram uma das seguintes respostas:

  • Se o criador 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 tiver ativado os Clubes dos canais, mas não tiver definido 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 na cota:uma chamada para esse método tem um custo de cota de uma 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 de recurso membershipsLevel que a resposta da API incluirá. O valor do 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 do recurso da API. O valor será youtube#membershipsLevelListResponse.
etag etag
A ETag deste recurso.
items[] list
Uma lista de recursos membershipsLevel de propriedade do 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 autoriza a solicitação não tem os Clubes dos canais ativados.