Une ressource job
représente une tâche de création de rapports planifiée. Une tâche de création de rapports identifie 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 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 de la tâche. |
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 missions de création de rapports 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 cette tâche ou pour supprimer cette tâche. |
Représentation des ressources JSON
La structure JSON ci-dessous illustre 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 dépasser 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 a été récupéré à partir de la méthode reportTypes.list . |
name |
string Nom généré par YouTube pour décrire l'offre d'emploi. 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 ou d'expiration de l'offre d'emploi. 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é 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 la tâche n'ont pas été téléchargés pendant une période prolongée. La valeur indique la date à partir de laquelle YouTube ne génère plus de rapports pour cette offre d'emploi. Si vous avez une mission qui indique 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 jobs qui créent ces rapports. |