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, у которых есть доступ к тем же отчетам в Creator Studio . Владельцы контента не могут изменять или удалять задания, которые создают эти отчеты.