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. |