Jobs

Ресурс job представляет собой запланированное задание по созданию отчетов. Задание отчетности определяет конкретный отчет, который YouTube создает каждый день для определенного канала или владельца контента.

Методы

В следующей таблице показаны методы, которые API поддерживает для ресурсов job .

Методы
create Создает задание отчетности. Создавая задание по созданию отчетов, вы даете YouTube указание создавать этот отчет ежедневно. Отчет доступен в течение 24 часов с момента создания задания.
delete Удаляет задание по созданию отчетов.
get Получает информацию о конкретном задании по созданию отчетов, запланированном для владельца канала или контента.
list Перечисляет задания по созданию отчетов, запланированные для владельца канала или контента. Каждый ресурс в ответе содержит свойство id , которое определяет идентификатор, который YouTube использует для уникальной идентификации задания. Этот идентификатор понадобится вам, чтобы получить список отчетов, созданных для задания, или удалить задание.

Представление ресурса JSON

Структура JSON ниже показывает формат ресурса job : 

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

Характеристики

В следующей таблице определены свойства, которые появляются в этом ресурсе:

Характеристики
id string
Идентификатор, который YouTube использует для уникальной идентификации задания по отправке отчетов. Значение имеет максимальную длину 40 символов.
reportTypeId string
Тип отчета, создаваемого заданием. Значение свойства соответствует id id reportType , полученному из метода reportTypes.list .
name string
Имя, которое YouTube генерирует для описания вакансии. Значение имеет максимальную длину 100 символов.
createTime timestamp
Дата и время создания задания. Значение свойства представляет собой временную метку в формате RFC3339 UTC «Zulu» с точностью до микросекунд. Пример: "2015-10-02T15:01:23.045678Z" .
expireTime timestamp
Дата и время истечения или истечения срока действия задания. Значение свойства представляет собой временную метку в формате RFC3339 UTC «Zulu» с точностью до микросекунд. Пример: "2015-10-02T15:01:23.045678Z" .

Это свойство имеет значение, если тип отчета, связанный с заданием, устарел или если отчеты, созданные для задания, не загружались в течение длительного периода времени. Значение обозначает дату, после которой YouTube больше не будет создавать новые отчеты по заданию.

Если у вас есть задание, в котором указана дата истечения срока действия, вам следует обновить свои системы, чтобы прекратить запрашивать отчет к этой дате. В некоторых случаях может быть доступен отчет о замене.
systemManaged boolean
Это значение true , если задание создает отчеты, управляемые системой. YouTube автоматически создает управляемые системой отчеты для владельцев контента YouTube, у которых есть доступ к тем же отчетам в YouTube Creator Studio . Владельцы контента не могут изменять или удалять задания, создающие эти отчеты.