Jobs

Une ressource job représente une tâche de création de rapports planifiée. Une tâche de reporting identifie un rapport spécifique que YouTube génère chaque jour pour une chaîne ou un propriétaire de contenu spécifique.

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 création de rapports, vous demandez à YouTube de générer ce rapport quotidiennement. Le rapport est disponible dans les 24 heures suivant la création du job.
delete	Supprime une tâche de création de rapports.
get	Récupère des informations sur une tâche de création de rapports spécifique planifiée pour une chaîne ou un propriétaire de contenu.
list	Répertorie les tâches de création de rapports qui ont été planifiées pour un propriétaire de chaîne ou 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 supprimer la tâche.

Représentation de la ressource JSON

La structure JSON ci-dessous montre 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 utilisé par YouTube pour identifier de manière unique la tâche de création de rapports. La valeur ne doit pas comporter plus de 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 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 comporter plus de 100 caractères.
createTime	timestamp Date et heure de création du job. La valeur de la propriété est un code temporel dans RFC3339 UTC "Zulu" avec une précision à la microseconde près. Exemple : "2015-10-02T15:01:23.045678Z".
expireTime	timestamp Date et heure d'expiration ou d'expiration de l'offre d'emploi. La valeur de la propriété est un code temporel dans RFC3339 UTC "Zulu" avec une précision à la microseconde près. Exemple: "2015-10-02T15:01:23.045678Z". Cette propriété est associée à une valeur si le type de rapport associé à la tâche est obsolète ou si les rapports générés pour cette tâche n'ont pas été téléchargés pendant une période prolongée. La valeur indique la date après laquelle YouTube ne génère plus de rapports pour l'offre d'emploi. Si une tâche présente une date d'expiration, vous devez mettre à jour vos systèmes pour qu'ils cessent de demander le rapport avant 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 YouTube qui ont accès aux mêmes rapports dans YouTube Creator Studio. Les propriétaires de contenu ne peuvent pas modifier ni supprimer les tâches qui créent ces rapports.