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. |