Jobs

Eine job-Ressource steht für einen geplanten Berichterstellungsjob. Ein Berichtauftrag gibt einen bestimmten Bericht an, den YouTube jeden Tag für einen bestimmten Kanal oder Rechteinhaber generiert.

Methoden

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

Methoden
create Erstellt einen Berichterstellungsjob. Durch die Erstellung eines Berichterstellungsjobs weisen Sie YouTube an, diesen Bericht täglich zu erstellen. Der Bericht ist innerhalb von 24 Stunden nach Erstellung des Auftrags verfügbar.
delete Löscht einen Berichterstellungsjob.
get Ruft Informationen zu einem bestimmten Berichterstellungsjob ab, der für einen Kanal oder Rechteinhaber geplant ist
list Enthält Berichterstellungsjobs, die für einen Kanal oder Rechteinhaber geplant sind 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, mit der YouTube den Berichterstellungsjob eindeutig identifiziert. Der Wert darf maximal 40 Zeichen lang sein.
reportTypeId string
Der Berichtstyp, den der Job erstellt. Der Attributwert entspricht dem id von einer id eines reportType, wie er mit der Methode reportTypes.list abgerufen wird.
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 im Format RFC3339 UTC „Zulu“ in Mikrosekunden. 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 im Format RFC3339 UTC „Zulu“ in Mikrosekunden. Beispiel: "2015-10-02T15:01:23.045678Z".

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

Wenn du für einen Job ein Ablaufdatum angegeben hast, solltest du deine Systeme aktualisieren, damit 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 die YouTube-Rechteinhaber, die in YouTube Studio auf dieselben Berichte zugreifen können. Rechteinhaber können Jobs, die diese Berichte erstellen, nicht ändern oder löschen.