Subscriptions

Um recurso subscription contém informações sobre a assinatura de um 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 recursos de assinatura que correspondem aos critérios da solicitação de API. Faça um teste agora.

inserir

Adiciona uma inscrição ao 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 a assinatura de forma exclusiva.
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 se inscreveu.
snippet.publishedAt	datetime A data e a hora em que a assinatura foi criada. O valor é especificado no formato ISO 8601.
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 de recurso da API.
snippet.resourceId.channelId	string O valor que o YouTube usa para identificar de forma exclusiva o canal em que o usuário se inscreveu.
snippet.channelId	string O ID que o YouTube usa para identificar exclusivamente o canal do assinante. O objeto resource_id identifica o canal a 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 Os valores de chave válidos são: default: a imagem em miniatura padrão para esse 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 de maior 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 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 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 O tipo de atividade a que esta inscrição se refere (somente envios, 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 assinante.
subscriberSnippet.channelId	string O ID que o YouTube atribui para identificar de forma exclusiva o canal do assinante.
subscriberSnippet.thumbnails	object Miniaturas do canal do assinante.
subscriberSnippet.thumbnails.(key)	object Os valores de chave válidos são: default: a imagem em miniatura padrão para esse 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 de maior 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 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 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.