Jobs

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

Metody

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

Metody
create	Tworzy zadanie raportowania. Tworząc zadanie raportowania, pobierasz raport do YouTube 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 jednoznacznego identyfikowania zadania. Identyfikator ten jest potrzebny do pobrania listy raportów wygenerowanych dla danego zadania lub do usunięcia zadania.

Reprezentacja zasobów JSON

Struktura JSON poniżej przedstawia format zasobu job:

{
  "id": string,
  "reportTypeId": string,
  "name": string,
  "createTime": timestamp,
  "expireTime": timestamp,
  "systemManaged": boolean
}

Usługi

Poniższa tabela określa właściwości, które pojawiają się w tym zasobie:

Usługi
id	string Identyfikator, którego YouTube używa do jednoznacznego identyfikowania zadania raportowania. Maksymalna długość to 40 znaków.
reportTypeId	string Typ raportu tworzonego przez zadanie. Wartość właściwości odpowiada id właściwości id z reportType pobranej z metody reportTypes.list.
name	string Nazwa, którą YouTube generuje, aby opisać stanowisko. Maksymalna długość to 100 znaków.
createTime	timestamp Data i godzina utworzenia zadania. Wartość właściwości to sygnatura czasowa w formacie „RFC 3339 UTC „Zulu” z dokładnością do mikrosekund. Przykład: "2015-10-02T15:01:23.045678Z".
expireTime	timestamp Data i godzina zakończenia zadania. Wartość właściwości to sygnatura czasowa w formacie „RFC 3339 UTC „Zulu” z dokładnością do mikrosekund. Przykład: "2015-10-02T15:01:23.045678Z". Ta właściwość ma wartość, jeśli typ raportu powiązany z zadaniem został wycofany lub raporty nie były pobierane przez dłuższy czas. Wartość oznacza datę, po której YouTube nie będzie już generować nowych raportów dla tego zlecenia. Jeśli masz ofertę pracy z datą wygaśnięcia, zaktualizuj swoje systemy, aby przestały prosić o raport do tego dnia. W niektórych przypadkach może być dostępny raport o zastępstwie.
systemManaged	boolean Jeśli zadanie wygeneruje raporty zarządzane przez system, wartość to true. YouTube automatycznie generuje raporty zarządzane przez system właścicieli treści, którzy mają dostęp do tych samych raportów w Studiu twórców. Właściciele treści nie mogą zmieniać ani usuwać zadań, które tworzą te raporty.