Jobs

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.