Jobs

Eine Ressource vom Typ job stellt einen geplanten Berichtsjob dar. Ein Berichtauftrag identifiziert einen bestimmten Bericht, den YouTube täglich für einen bestimmten Kanal oder Rechteinhaber generiert.

Methoden

In der folgenden Tabelle sind die Methoden aufgeführt, die von der API für job-Ressourcen unterstützt werden.

Methoden
create Erstellt einen Berichtauftrag. Durch das Erstellen eines Berichtsauftrags weisen Sie YouTube an, diesen Bericht täglich zu erstellen. Der Bericht ist innerhalb von 24 Stunden nach Erstellung des Jobs verfügbar.
delete Löscht einen Berichtsjob.
get Ruft Informationen zu einem bestimmten Berichtsjob ab, der für einen Kanal oder Rechteinhaber geplant wurde
list Listet Berichtsjobs auf, die für einen Kanal oder Rechteinhaber geplant wurden Jede Ressource in der Antwort enthält die Eigenschaft id, die die ID angibt, mit der YouTube den Job eindeutig identifiziert. Sie benötigen diese ID, um die Liste der für den Job generierten Berichte abzurufen oder den Job zu löschen.

Darstellung von JSON-Ressourcen

Die folgende JSON-Struktur zeigt das Format einer job-Ressource:

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

Attribute

In der folgenden Tabelle werden die Attribute definiert, die in dieser Ressource angezeigt werden:

Attribute
id string
Die ID, die YouTube verwendet, um den Berichtauftrag eindeutig zu identifizieren. Der Wert darf maximal 40 Zeichen lang sein.
reportTypeId string
Der Berichtstyp, der vom Job erstellt wird. Der Attributwert entspricht dem id eines id eines reportType, wie er aus der reportTypes.list-Methode abgerufen wurde.
name string
Ein Name, den YouTube zur Beschreibung des Jobs generiert. Der Wert darf maximal 100 Zeichen lang sein.
createTime timestamp
Das Datum und die Uhrzeit der Erstellung des Jobs. Der Attributwert ist ein Zeitstempel im Format RFC3339 UTC „Zulu“ in Mikrosekunden. Beispiel: "2015-10-02T15:01:23.045678Z".
expireTime timestamp
Das Datum und die Uhrzeit, wann der Job abgelaufen ist oder abläuft. Der Attributwert ist ein Zeitstempel im Format RFC3339 UTC „Zulu“ in Mikrosekunden. Beispiel: "2015-10-02T15:01:23.045678Z".

Diese Eigenschaft hat einen Wert, wenn der mit dem Job verknüpfte Berichtstyp nicht mehr verwendet wird oder wenn die für den Job erstellten Berichte längere Zeit nicht heruntergeladen wurden. Der Wert gibt das Datum an, nach dem YouTube keine neuen Berichte für den Job mehr erstellt.

Wenn du einen Job mit einem Ablaufdatum hast, solltest du deine Systeme so aktualisieren, dass der Bericht bis zu diesem Datum nicht mehr angefordert wird. In einigen Fällen ist ein Ersatzbericht verfügbar.
systemManaged boolean
Dieser Wert ist true, wenn der Job vom System verwaltete Berichte generiert. YouTube erstellt automatisch vom System verwaltete Berichte für YouTube-Rechteinhaber, die Zugriff auf dieselben Berichte in Creator Studio haben. Rechteinhaber können Jobs, die diese Berichte erstellen, nicht ändern oder löschen.