Reports

Una risorsa report identifica un'istanza specifica di un report. La risorsa identifica il periodo di tempo durante il quale il report contiene dati, nonché l'URL da cui è possibile scaricare il report.

Metodi

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

Metodi
get Recupera i metadati per un report specifico.
list Elenca i report che sono stati generati per il job di reporting specificato.

Rappresentazione della risorsa JSON

La struttura JSON seguente mostra il formato di una risorsa report:

{
  "id": string,
  "jobId": string,
  "startTime": timestamp,
  "endTime": timestamp,
  "createTime": timestamp,
  "jobExpireTime": timestamp,
  "downloadUrl": string
}

Proprietà

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

Proprietà
id string
L'ID assegnato da YouTube per identificare in modo univoco il report. Ogni report è associato a un singolo job, sebbene un job possa essere associato a molti ID report.
jobId string
L'ID del job che ha creato il report.
startTime timestamp
L'inizio del periodo di tempo coperto dall'istanza del report. Il valore inclusivo è un timestamp in RFC3339 UTC "Zulu" con precisione in microsecondi. Esempio: "2015-10-02T15:01:23.045678Z".
endTime timestamp
La fine del periodo di tempo coperto dall'istanza del report. Il valore esclusivo è un timestamp in RFC3339 UTC "Zulu" con precisione in microsecondi. Esempio: "2015-10-02T15:01:23.045678Z".
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".
jobExpireTime timestamp
La data e l'ora in cui il job associato al report è 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 del report è stato ritirato o i report generati per quel job non sono stati scaricati per un periodo di tempo prolungato. Il valore indica la data dopo la quale YouTube non genererà più nuovi report per il job.

Se hai un job che identifica una data di scadenza, devi aggiornare il tuo sistema per interrompere la richiesta del report entro quella data. In alcuni casi, potrebbe essere disponibile un report sostitutivo.
downloadUrl string
L'URL da cui è possibile scaricare il report. Il valore della proprietà ha una lunghezza massima di 1000 caratteri.

Per recuperare il report, invia una richiesta GET HTTP a questo URL. Nella richiesta, imposta l'intestazione della richiesta HTTP Authorization utilizzando il token di autorizzazione come valore dell'intestazione.

Utilizzo di gzip

Puoi ridurre la larghezza di banda necessaria per scaricare i report abilitando la compressione gzip nelle richieste di download. Sebbene l'applicazione richieda più tempo di CPU per decomprimere le risposte dell'API, il vantaggio di un consumo inferiore di risorse di rete di solito supera questo costo.

Per ricevere una risposta con codifica gzip, imposta l'intestazione della richiesta HTTP Accept-Encoding su gzip, come mostrato nell'esempio seguente:

Accept-Encoding: gzip