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