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.