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 de 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. Por isso, os proprietários de canais podem criar grupos de vídeos e playlists. Os proprietários de conteúdo podem criar grupos de vídeos, playlists, canais ou recursos.

Métodos

A API oferece suporte aos seguintes métodos para recursos groups:

list
Retorna uma lista de grupos que correspondem aos parâmetros da solicitação da API. Por exemplo, é possível recuperar todos os grupos que pertencem ao usuário autenticado ou recuperar um ou mais grupos pelos 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 a ele. Faça um teste agora.
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. Teste agora.
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 exclusivamente o grupo.
snippet object
O objeto snippet contém informações básicas sobre o grupo, incluindo a data de criação e o 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 o número e o tipo de itens que ele contém.
contentDetails.itemCount unsigned long
O número de itens no grupo.
contentDetails.itemType string
O tipo de recursos que o grupo contém.

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