Subscriptions

Um recurso subscription contém informações sobre uma assinatura de usuário do YouTube. Uma inscrição notifica o usuário quando novos vídeos são adicionados a um canal ou quando outro usuário executa uma das várias ações no YouTube, como o upload ou a classificação de um vídeo ou comentários sobre um vídeo.

Métodos

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

list
Retorna os recursos da assinatura que correspondem aos critérios da solicitação de API. Faça um teste agora.
inserir
Adiciona uma inscrição para o canal do usuário autenticado. Faça um teste agora.
delete
Exclui uma assinatura. Faça um teste agora.

Representação de recurso

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

{
  "kind": "youtube#subscription",
  "etag": etag,
  "id": string,
  "snippet": {
    "publishedAt": datetime,
    "channelTitle": string,
    "title": string,
    "description": string,
    "resourceId": {
      "kind": string,
      "channelId": string,
    },
    "channelId": string,
    "thumbnails": {
      (key): {
        "url": string,
        "width": unsigned integer,
        "height": unsigned integer
      }
    }
  },
  "contentDetails": {
    "totalItemCount": unsigned integer,
    "newItemCount": unsigned integer,
    "activityType": string
  },
  "subscriberSnippet": {
    "title": string,
    "description": string,
    "channelId": string,
    "thumbnails": {
      (key): {
        "url": string,
        "width": unsigned integer,
        "height": unsigned integer
      }
    }
  }
}

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#subscription.
etag etag
A ETag deste recurso.
id string
O ID que o YouTube usa para identificar de forma exclusiva a assinatura.
snippet object
O objeto snippet contém detalhes básicos sobre a assinatura, incluindo o título e o canal em que o usuário está.
snippet.publishedAt datetime
Data e hora em que a assinatura foi criada. O valor é especificado no formato ISO 8601.
snippet.channelTitle string
O título do canal a que a assinatura pertence.
snippet.title string
O título da assinatura.
snippet.description string
Os detalhes da assinatura.
snippet.resourceId object
O objeto id contém informações sobre o canal em que o usuário se inscreveu.
snippet.resourceId.kind string
O tipo do recurso da API.
snippet.resourceId.channelId string
O valor usado pelo YouTube para identificar exclusivamente o canal em que o usuário está inscrito.
snippet.channelId string
O ID que o YouTube usa para identificar de forma exclusiva o canal do inscrito. O objeto resource_id identifica o canal em que o usuário se inscreveu.
snippet.thumbnails object
Um mapa de imagens em miniatura associadas à assinatura. Para cada objeto no mapa, a chave é o nome da imagem em miniatura, e o valor é um objeto que contém outras informações sobre a miniatura.
snippet.thumbnails.(key) object
As chaves-valor válidas são:
  • default: a imagem em miniatura padrão desse recurso. A miniatura padrão para um vídeo ou um recurso que se refere a um vídeo, como um item da playlist ou o resultado da pesquisa, tem 120 px de largura e 90px de altura. A miniatura padrão de um canal tem 88 px de largura e 88 px de altura.
  • medium: uma versão em alta resolução da imagem em miniatura. Para um vídeo (ou um recurso que se refira a um vídeo), esta imagem tem 320 px de largura e 180 px de altura. Para um canal, esta imagem tem 240 px de largura e 240 px de altura.
  • high: uma versão de alta resolução da imagem em miniatura. Para um vídeo (ou um recurso que se refira a um vídeo), esta imagem tem 480 px de largura e 360 px de altura. Para um canal, esta imagem tem 800 px de largura e 800 px de altura.
snippet.thumbnails.(key).url string
O URL da imagem.
snippet.thumbnails.(key).width unsigned integer
A largura da imagem.
snippet.thumbnails.(key).height unsigned integer
A altura da imagem.
contentDetails object
O objeto contentDetails contém estatísticas básicas sobre a assinatura.
contentDetails.totalItemCount unsigned integer
É o número aproximado de itens que a assinatura aponta.
contentDetails.newItemCount unsigned integer
É o número de novos itens na assinatura desde a última leitura do conteúdo.
contentDetails.activityType string
Tipo de atividade desta assinatura (somente uploads, tudo).

Os valores válidos para essa propriedade são:
  • all
  • uploads
subscriberSnippet object
O objeto subscriberSnippet contém detalhes básicos sobre o assinante.
subscriberSnippet.title string
O título do canal do inscrito.
subscriberSnippet.description string
A descrição do canal do inscrito.
subscriberSnippet.channelId string
O ID que o YouTube atribui para identificar exclusivamente o canal do inscrito.
subscriberSnippet.thumbnails object
Imagens em miniatura para o canal do assinante.
subscriberSnippet.thumbnails.(key) object
As chaves-valor válidas são:
  • default: a imagem em miniatura padrão desse recurso. A miniatura padrão para um vídeo ou um recurso que se refere a um vídeo, como um item da playlist ou o resultado da pesquisa, tem 120 px de largura e 90px de altura. A miniatura padrão de um canal tem 88 px de largura e 88 px de altura.
  • medium: uma versão em alta resolução da imagem em miniatura. Para um vídeo (ou um recurso que se refira a um vídeo), esta imagem tem 320 px de largura e 180 px de altura. Para um canal, esta imagem tem 240 px de largura e 240 px de altura.
  • high: uma versão de alta resolução da imagem em miniatura. Para um vídeo (ou um recurso que se refira a um vídeo), esta imagem tem 480 px de largura e 360 px de altura. Para um canal, esta imagem tem 800 px de largura e 800 px de altura.
subscriberSnippet.thumbnails.(key).url string
O URL da imagem.
subscriberSnippet.thumbnails.(key).width unsigned integer
A largura da imagem.
subscriberSnippet.thumbnails.(key).height unsigned integer
A altura da imagem.