Jobs

Une ressource job représente une tâche de création de rapports planifiée. Une tâche de création de rapports permet d'identifier un rapport spécifique généré chaque jour par YouTube pour une chaîne ou un propriétaire de contenu spécifiques.

Méthodes

Le tableau suivant présente les méthodes compatibles avec l'API pour les ressources job.

Méthodes
create crée une tâche de création de rapports ; En créant une tâche de reporting, vous demandez à YouTube de générer ce rapport quotidiennement. Le rapport est disponible dans les 24 heures suivant la création de l'offre d'emploi.
delete Supprime une tâche de reporting.
get Récupère des informations sur une tâche de création de rapports spécifique qui a été planifiée pour une chaîne ou un propriétaire de contenu.
list Répertorie les tâches de rapport qui ont été planifiées pour une chaîne ou un propriétaire de contenu. Chaque ressource de la réponse contient une propriété id, qui spécifie l'ID utilisé par YouTube pour identifier l'offre d'emploi de manière unique. Vous avez besoin de cet ID pour récupérer la liste des rapports générés pour la tâche ou pour la supprimer.

Représentation des ressources JSON

La structure JSON ci-dessous présente le format d'une ressource job:

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

Propriétés

Le tableau suivant définit les propriétés qui apparaissent dans cette ressource:

Propriétés
id string
ID que YouTube utilise pour identifier la tâche de reporting de manière unique. La valeur est limitée à 40 caractères.
reportTypeId string
Type de rapport créé par la tâche. La valeur de la propriété correspond au id d'un id d'un reportType tel qu'il est récupéré à partir de la méthode reportTypes.list.
name string
Nom généré par YouTube pour décrire le poste. La valeur ne doit pas dépasser 100 caractères.
createTime timestamp
Date et heure de création du job. La valeur de la propriété est un horodatage au format RFC3339 UTC "Zulu", précis à la microseconde près. Exemple : "2015-10-02T15:01:23.045678Z".
expireTime timestamp
Date et heure d'expiration du job. La valeur de la propriété est un horodatage au format RFC3339 UTC "Zulu", précis à la microseconde près. Exemple : "2015-10-02T15:01:23.045678Z".

Cette propriété a une valeur si le type de rapport associé à la tâche est obsolète ou si les rapports générés pour la tâche n'ont pas été téléchargés depuis longtemps. La valeur indique la date à partir de laquelle YouTube ne génère plus de nouveaux rapports sur le projet.

Si une tâche identifie une date d'expiration, vous devez mettre à jour vos systèmes pour qu'ils n'envoient plus de demande de rapport à cette date. Dans certains cas, un rapport de remplacement peut être disponible.
systemManaged boolean
Cette valeur est true si la tâche génère des rapports gérés par le système. YouTube génère automatiquement des rapports gérés par le système pour les propriétaires de contenu qui ont accès aux mêmes rapports dans Creator Studio. Les propriétaires de contenu ne peuvent pas modifier ni supprimer les tâches qui créent ces rapports.