Sponsors

Observação: este recurso foi descontinuado em 31 de março de 2020. Ele foi substituído pelo recurso member. Encontre informações sobre esse recurso na documentação da API YouTube Data.

Como parte dessa suspensão de uso, o método sponsors.list não será mais compatível a partir de 30 de setembro de 2020. Os clientes da API precisam atualizar as chamadas para o método sponsors.list para usar o método members.list.

Um recurso sponsor representa um membro do canal (anteriormente conhecido como "patrocinador") para um canal do YouTube. Um membro oferece suporte monetário recorrente a um criador de conteúdo e recebe benefícios especiais. Por exemplo, os membros podem ativar o chat quando o criador de conteúdo ativa o modo somente para membros.

Métodos

A API é compatível com os seguintes métodos para recursos sponsors:

list

Lista os patrocinadores de um canal. A solicitação da API precisa ser autorizada pelo proprietário do canal. Faça um teste agora.

Representação de recurso

A estrutura JSON a seguir mostra o formato de um recurso sponsors:

{
  "kind": "youtube#sponsor",
  "etag": etag,
  "id": string,
  "snippet": {
    "channelId": string,
    "sponsorDetails": {
      "channelId": string,
      "channelUrl": string,
      "displayName": string,
      "profileImageUrl": string
    },
    "sponsorSince": datetime
  }
}

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#sponsor.
etag	etag A ETag deste recurso.
id	string O ID atribuído pelo YouTube para identificar exclusivamente o patrocinador.
snippet	object O objeto snippet contém detalhes sobre o patrocinador.
snippet.channelId	string Esse ID identifica o canal que está sendo patrocinado.
snippet.sponsorDetails	object Esse objeto contém detalhes sobre o patrocinador.
snippet.sponsorDetails.channelId	string O ID do canal do YouTube.
snippet.sponsorDetails.channelUrl	string O URL do canal.
snippet.sponsorDetails.displayName	string O nome de exibição do canal.
snippet.sponsorDetails.profileImageUrl	string O URL do avatar dos canais.
snippet.sponsorSince	datetime A data e a hora em que o usuário se tornou patrocinador. O valor é especificado no formato ISO 8601 (YYYY-MM-DDThh:mm:ss.sZ).