Jobs

Eine job-Ressource steht für einen geplanten Berichtsjob. Bei einem Berichterstellungsjob wird ein bestimmter Bericht identifiziert, der von YouTube täglich für einen bestimmten Kanal oder Rechteinhaber erstellt wird.

Methoden

Die folgende Tabelle zeigt die Methoden, die von der API für job-Ressourcen unterstützt werden.

Methoden
create Erstellt einen Berichterstellungsjob. Durch das Erstellen eines Berichtsauftrags weist 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 Berichterstellungsjob.
get Ruft Informationen zu einem bestimmten Berichtjob ab, der für einen Kanal oder Rechteinhaber geplant wurde.
list Hier werden Jobs gemeldet, die für einen Kanal oder Rechteinhaber geplant wurden. Jede Ressource in der Antwort enthält ein id-Attribut, das die ID angibt, die YouTube zur eindeutigen Identifizierung des Jobs verwendet. Sie benötigen diese ID, um die Liste der Berichte abzurufen, die für den Job generiert wurden, oder um den Job zu löschen.

JSON-Ressourcendarstellung

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 zur eindeutigen Identifizierung des Berichtsjobs verwendet. Der Wert darf maximal 40 Zeichen lang sein.
reportTypeId string
Der vom Job erstellte Berichtstyp. Der Attributwert entspricht dem id einer id eines reportType, wie er über die Methode reportTypes.list abgerufen wurde.
name string
Ein Name, der von YouTube generiert wird, um den Job zu beschreiben. Der Wert darf maximal 100 Zeichen lang sein.
createTime timestamp
Datum und Uhrzeit der Joberstellung. Der Eigenschaftswert ist ein Zeitstempel in RFC3339 UTC "Zulu" bis auf Mikrosekunden genau. Beispiel: "2015-10-02T15:01:23.045678Z".
expireTime timestamp
Das Datum und die Uhrzeit, zu der der Job abgelaufen ist oder abläuft. Der Eigenschaftswert ist ein Zeitstempel in RFC3339 UTC "Zulu" bis auf Mikrosekunden genau. Beispiel: "2015-10-02T15:01:23.045678Z".

Diese Property hat einen Wert, wenn der mit dem Job verknüpfte Berichtstyp nicht mehr verfügbar ist oder wenn für den Job generierte Berichte über einen längeren Zeitraum nicht heruntergeladen wurden. Der Wert kennzeichnet das Datum, nach dem YouTube keine neuen Berichte mehr für den Job erstellt.

Wenn du einen Job hast, bei dem ein Ablaufdatum festgelegt ist, solltest du deine Systeme so aktualisieren, dass der Bericht ab diesem Datum nicht mehr angefordert wird. In einigen Fällen ist möglicherweise 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 in YouTube Studio Zugriff auf dieselben Berichte haben. Rechteinhaber können Jobs, die diese Berichte erstellen, nicht ändern oder löschen.