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. |