Jobs

Zasób job reprezentuje zaplanowane zadanie raportowania. Zadanie raportowania określa konkretny raport, który YouTube generuje każdego dnia dla określonego kanału lub właściciela treści.

Metody

W tabeli poniżej znajdziesz metody, które interfejs API obsługuje w przypadku zasobów job.

Metody
create	Tworzy zadanie raportowania. Tworząc zadanie raportowania, informujesz YouTube, że ma generować ten raport codziennie. Raport jest dostępny w ciągu 24 godzin od utworzenia zadania.
delete	Usuwa zadanie raportowania.
get	Pobiera informacje o konkretnym zadaniu raportowania, które zostało zaplanowane dla kanału lub właściciela treści.
list	Wyświetla listę zadań raportowania, które zostały zaplanowane dla właściciela kanału lub treści. Każdy zasób w odpowiedzi zawiera właściwość id, która określa identyfikator używany przez YouTube do jednoznacznej identyfikacji zadania. Ten identyfikator jest potrzebny do pobrania listy raportów wygenerowanych dla tego zadania lub do jego usunięcia.

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

Tabela poniżej zawiera właściwości widoczne w tym zasobie:

Właściwości
id	string, Identyfikator używany przez YouTube do jednoznacznej identyfikacji zadania raportowania. Maksymalna długość wartości to 40 znaków.
reportTypeId	string, Typ raportu tworzonego przez zadanie. Wartość właściwości odpowiada id elementu id obiektu reportType pobranego z metody reportTypes.list.
name	string, Nazwa wygenerowana przez YouTube w celu opisania danego 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 dokumencie 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 lub wygaśnięcia zadania. Wartość właściwości jest sygnaturą czasową w dokumencie 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 wygenerowane dla tego zadania nie były pobierane od dłuższego czasu. Wartość oznacza datę, po której YouTube nie będzie już generować nowych raportów dotyczących danego zadania. Jeśli masz zadanie, które określa datę ważności, zaktualizuj swoje systemy tak, aby do tego dnia przestały wysyłać żądania raportu. W niektórych przypadkach może być dostępny raport zastępczy.
systemManaged	boolean, Ta wartość wynosi true, jeśli zadanie generuje raporty zarządzane przez system. YouTube automatycznie generuje zarządzane przez system raporty dla właścicieli treści w 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.