Zasób job
reprezentuje zaplanowane zadanie raportowania. Zadanie raportowania identyfikuje określony raport, który YouTube generuje codziennie dla danego kanału lub właściciela treści.
Metody
W tabeli poniżej znajdziesz metody obsługiwane przez interfejs API w przypadku zasobów job
.
Metody | |
---|---|
create |
Tworzy zadanie raportowania. Tworząc zadanie raportowania, informujesz YouTube o codziennym generowaniu tego raportu. Raport jest dostępny w ciągu 24 godzin od utworzenia zadania. |
delete |
Usuwa zadanie raportowania. |
get |
Pobiera informacje o konkretnym zadaniu raportowania zaplanowanym dla kanału lub właściciela treści. |
list |
Wyświetla listę zadań raportowania zaplanowanych dla kanału lub właściciela treści. Każdy zasób w odpowiedzi zawiera właściwość id , która określa identyfikator, którego YouTube używa do jednoznacznego identyfikowania zadania. Ten identyfikator jest potrzebny do pobrania listy raportów wygenerowanych dla tego zadania lub do usunięcia zadania. |
Reprezentacja zasobu JSON
Poniższa struktura JSON przedstawia format zasobu job
:
{ "id": string, "reportTypeId": string, "name": string, "createTime": timestamp, "expireTime": timestamp, "systemManaged": boolean }
Właściwości
Poniższa tabela definiuje właściwości, które pojawiają się w tym zasobie:
Właściwości | |
---|---|
id |
string Identyfikator, którego YouTube używa do jednoznacznego identyfikowania zadania raportowania. Maksymalna długość wartości to 40 znaków. |
reportTypeId |
string Typ raportu tworzonego przez zadanie. Wartość właściwości odpowiada parametrowi id elementu id w kolumnie reportType pobranej z metody reportTypes.list . |
name |
string Nazwa, którą YouTube generuje do opisu stanowiska. Maksymalna długość wartości to 100 znaków. |
createTime |
timestamp Data i godzina utworzenia zadania. Wartość właściwości jest sygnaturą czasową w formacie RFC3339 UTC „Zulu”, z dokładnością do mikrosekund. Przykład: "2015-10-02T15:01:23.045678Z" . |
expireTime |
timestamp Data i godzina wygaśnięcia oferty pracy. Wartość właściwości jest sygnaturą czasową w formacie RFC3339 UTC „Zulu”, z dokładnością do mikrosekund. Przykład: "2015-10-02T15:01:23.045678Z" .Ta właściwość zawiera wartość, jeśli typ raportu powiązany z zadaniem został wycofany lub jeśli raporty generowane dla tego zadania nie były pobierane od dłuższego czasu. Ta wartość oznacza datę, po której YouTube przestanie generować nowe raporty dotyczące zadania. Jeśli masz zadanie, które ma datę ważności, zaktualizuj swoje systemy, aby do tego dnia przestały wysyłać żądania raportu. W niektórych przypadkach może być dostępny raport zastępczy. |
systemManaged |
boolean Jeśli zadanie generuje raporty zarządzane przez system, ta wartość wynosi true . YouTube automatycznie generuje raporty zarządzane przez system dla właścicieli treści YouTube, którzy mają dostęp do tych samych raportów w Studiu twórców YouTube. Właściciele treści nie mogą modyfikować ani usuwać zadań, które tworzą te raporty. |