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