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).