Jobs

Um recurso job representa um job de geração de relatórios programado. O trabalho de geração de relatório identifica um relatório específico gerado diariamente pelo YouTube para determinado canal ou proprietário de 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 geração de relatórios. 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 trabalho de geração de relatórios específico que foi programado para um canal ou proprietário de conteúdo.
list	Lista tarefas de relatórios que foram programadas para um canal ou proprietário do conteúdo. Cada recurso na resposta contém uma propriedade id, que especifica o ID que o YouTube usa para identificar exclusivamente a vaga. Esse ID é necessário para recuperar a lista de relatórios gerados para o job ou excluí-lo.

Representação do 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 O ID que o YouTube usa para identificar de maneira exclusiva o job de relatório. O valor deve ter no máximo 40 caracteres.
reportTypeId	string O tipo de relatório que o job cria. O valor da propriedade corresponde ao id de uma id de uma reportType, conforme extraído do método reportTypes.list.
name	string Um nome que o YouTube gera para descrever o trabalho. O valor pode ter no máximo 100 caracteres.
createTime	timestamp A data e a hora em que o job foi criado. O valor da propriedade é um carimbo de data/hora no formato UTC "Zulu" RFC3339, com precisão de microssegundos. Exemplo: "2015-10-02T15:01:23.045678Z".
expireTime	timestamp A data e a hora em que o job expirou ou irá expirar. O valor da propriedade é um carimbo de data/hora no formato 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 for descontinuado ou se os relatórios gerados para o job não tiverem sido baixados por um período prolongado. O valor marca a data após a qual o YouTube não gera mais novos relatórios para o job. Se você tiver um job que identifique uma data de validade, atualize seus sistemas para interromper a solicitação do relatório até essa data. Em alguns casos, um relatório de substituição está disponível.
systemManaged	boolean 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 do conteúdo que têm acesso aos mesmos relatórios no YouTube Creator Studio. Os proprietários do conteúdo não podem modificar ou excluir trabalhos que criam esses relatórios.