Jobs

O recurso job representa um job de geração de relatórios programado. Um trabalho de relatório identifica um relatório específico gerado pelo YouTube todos os dias para um determinado canal ou proprietário do conteúdo.

Métodos

A tabela a seguir mostra os métodos compatíveis com a API para recursos job.

Métodos
create Cria um job de relatório. Ao criar um trabalho de relatório, você está instruindo o YouTube a gerar esse relatório diariamente. O relatório fica disponível 24 horas após a criação do job.
delete Exclui um job de relatório.
get Recupera informações sobre um job de geração de relatórios específico que foi programado para um canal ou proprietário do conteúdo.
list Lista os trabalhos de geração de relatórios que foram agendados para um proprietário de conteúdo ou canal. Cada recurso na resposta contém uma propriedade id, que especifica o ID que o YouTube usa para identificar exclusivamente a vaga. Você precisa desse ID para recuperar a lista de relatórios que foram gerados para o job ou excluí-lo.

Representação de recurso JSON

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

{
  "id": string,
  "reportTypeId": string,
  "name": string,
  "createTime": timestamp,
  "expireTime": timestamp,
  "systemManaged": boolean
}

Propriedades

A tabela a seguir define as propriedades que aparecem neste recurso:

Propriedades
id string e
O ID que o YouTube usa para identificar de forma exclusiva o trabalho de relatório. O valor deve ter no máximo 40 caracteres.
reportTypeId string e
O tipo de relatório criado pelo job. O valor da propriedade corresponde ao id de um id de um reportType, conforme recuperado do método reportTypes.list.
name string e
Um nome que o YouTube gera para descrever o trabalho. O valor deve ter no máximo 100 caracteres.
createTime timestamp e
A data e a hora em que o job foi criado. O valor da propriedade é um carimbo de data/hora em UTC "Zulu" RFC3339 com precisão de microssegundos. Exemplo: "2015-10-02T15:01:23.045678Z".
expireTime timestamp e
A data e a hora em que o trabalho expirou ou vai expirar. O valor da propriedade é um carimbo de data/hora em UTC "Zulu" RFC3339 com precisão de microssegundos. Exemplo: "2015-10-02T15:01:23.045678Z".

Essa propriedade terá um valor se o tipo de relatório associado ao job tiver sido descontinuado ou se os relatórios gerados para o job não forem transferidos por download por um período prolongado. O valor marca a data final em que o YouTube não vai mais gerar novos relatórios para ela.

Se você tiver um job que identifique uma data de validade, atualize seus sistemas para que parem de solicitar o relatório até essa data. Em alguns casos, um relatório de substituição pode estar disponível.
systemManaged boolean e
Esse valor será true se o job gerar relatórios gerenciados pelo sistema. O YouTube gera automaticamente relatórios gerenciados pelo sistema para os proprietários de conteúdo do YouTube que têm acesso aos mesmos relatórios no YouTube Creator Studio. Os proprietários do conteúdo não podem modificar nem excluir jobs que criam esses relatórios.