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