Groups

Um recurso group representa um grupo do YouTube Analytics, que é uma coleção personalizada de até 500 canais, vídeos, playlists ou recursos.

Todos os itens em um grupo precisam representar o mesmo tipo de recurso. Por exemplo, não é possível criar um grupo com 100 vídeos e 100 playlists.

Um grupo do Google Analytics só pode conter recursos que você enviou ou reivindicou ou que estão vinculados a um canal que você administra. Como resultado, os proprietários de canais podem criar grupos de vídeos e playlists. Os proprietários do conteúdo podem criar grupos de vídeos, playlists, canais ou recursos.

Métodos

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

list
Retorna uma lista de grupos que correspondem aos parâmetros da solicitação de API. Por exemplo, é possível recuperar todos os grupos do usuário autenticado ou um ou mais grupos usando os IDs exclusivos. Faça um teste agora.
inserir
Cria um grupo do YouTube Analytics. Depois de criar um grupo, use o método groupItems.insert para adicionar itens ao grupo. Faça um teste.
update
Modifica os metadados de um grupo. Atualmente, a única propriedade que pode ser atualizada é o título do grupo. Use groupItems.insert e groupItems.delete para adicionar e remover itens do grupo. Faça um teste.
delete
Exclui um grupo. Faça um teste agora.

Representação de recurso

A estrutura JSON abaixo mostra o formato de um recurso groups:

{
  "kind": "youtube#group",
  "etag": etag,
  "id": string,
  "snippet": {
    "publishedAt": datetime,
    "title": string
  },
  "contentDetails": {
    "itemCount": unsigned long,
    "itemType": string
  }
}

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#group.
etag etag
A ETag deste recurso.
id string
O ID que o YouTube usa para identificar o grupo de forma exclusiva.
snippet object
O objeto snippet contém informações básicas sobre o grupo, incluindo data de criação e nome.
snippet.publishedAt datetime
A data e a hora em que o grupo foi criado. O valor é especificado no formato ISO 8601 (YYYY-MM-DDThh:mm:ss.sZ).
snippet.title string
O nome do grupo. O valor precisa ser uma string não vazia.
contentDetails object
O objeto contentDetails contém mais informações sobre o grupo, como a quantidade e o tipo de itens.
contentDetails.itemCount unsigned long
O número de itens no grupo.
contentDetails.itemType string
O tipo de recurso que o grupo contém.

Os valores válidos dessa propriedade são:
  • youtube#channel
  • youtube#playlist
  • youtube#video
  • youtubePartner#asset