Jobs

Una risorsa job rappresenta un job di generazione di report pianificato. Un job di generazione di report 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 reporting. Se crei un job di generazione di report, chiedi a YouTube di generare quel report ogni giorno. Il report sarà disponibile entro 24 ore dal momento in cui viene creato il job.
delete Elimina un job di reporting.
get Recupera le informazioni su uno specifico lavoro di segnalazione che è stato pianificato per un canale o un proprietario dei contenuti.
list Elenca i job di segnalazione 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 lavoro. L'ID è necessario per recuperare l'elenco dei report generati per il job o per eliminarlo.

Rappresentazione della risorsa JSON

La struttura JSON seguente 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 di 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 RFC3339 UTC "Zulu" con precisione 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 RFC3339 UTC "Zulu" con precisione in microsecondi. Esempio: "2015-10-02T15:01:23.045678Z".

Questa proprietà ha un valore se il tipo di report associato al job è stato ritirato 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 il job.

Se hai un job che identifica una data di scadenza, devi aggiornare i tuoi sistemi per interrompere la richiesta del 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 di 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.