Jobs

Una risorsa job rappresenta un job di generazione di report pianificato. Un'attività di reporting identifica un report specifico che YouTube genera ogni giorno per un determinato canale o proprietario dei contenuti.

Metodi

La tabella seguente mostra i metodi supportati dall'API per le risorse job.

Metodi
create	Crea un job di generazione di report. Creando un job di generazione di report, indichi a YouTube di generare il report su base giornaliera. Il report è disponibile entro 24 ore dalla creazione del job.
delete	Elimina un job di reporting.
get	Recupera le informazioni su uno specifico lavoro di generazione dei report che è stato programmato per un canale o un proprietario di contenuti.
list	Elenca i job relativi ai report che sono stati pianificati per un canale o un proprietario dei contenuti. Ogni risorsa nella risposta contiene una proprietà id, che specifica l'ID utilizzato da YouTube per identificare in modo univoco il job. Questo ID è necessario per recuperare l'elenco dei report generati per il job o per eliminare il job.

Rappresentazione delle risorse JSON

La struttura JSON di seguito mostra il formato di una risorsa job:

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

Proprietà

La tabella seguente definisce le proprietà visualizzate in questa risorsa:

Proprietà
id	string L'ID utilizzato da YouTube per identificare in modo univoco il job relativo alla segnalazione. Il valore ha una lunghezza massima di 40 caratteri.
reportTypeId	string Il tipo di report creato dal job. Il valore della proprietà corrisponde al id di un id di un reportType recuperato dal metodo reportTypes.list.
name	string Un nome generato da YouTube per descrivere il lavoro. Il valore ha una lunghezza massima di 100 caratteri.
createTime	timestamp La data e l'ora in cui è stato creato il job. Il valore della proprietà è un timestamp in formato "Zulu" UTC RFC3339, preciso in microsecondi. Esempio: "2015-10-02T15:01:23.045678Z".
expireTime	timestamp La data e l'ora in cui il job è scaduto o scadrà. Il valore della proprietà è un timestamp in formato "Zulu" UTC RFC3339, preciso in microsecondi. Esempio: "2015-10-02T15:01:23.045678Z". Questa proprietà ha un valore se il tipo di report associato al job è stato deprecato o se i report generati per il job non sono stati scaricati per un periodo di tempo prolungato. Il valore indica la data dopo la quale YouTube non genera più nuovi report per quel lavoro. Se hai un'offerta che identifica una data di scadenza, devi aggiornare i tuoi sistemi per interrompere la richiesta di report entro questa data. In alcuni casi, potrebbe essere disponibile un report sostitutivo.
systemManaged	boolean Questo valore è true se il job genera report gestiti dal sistema. YouTube genera automaticamente report gestiti dal sistema per i proprietari dei contenuti YouTube che hanno accesso agli stessi report in YouTube Creator Studio. I proprietari dei contenuti non possono modificare o eliminare i job che creano questi report.