Gérer les approbations

Ce document explique comment gérer les approbations dans l'API Google Drive.

Vous pouvez consulter vos approbations de contenu dans Google Drive. L'API Google Drive fournit la ressource approvals pour vous permettre d'obtenir et de lister l'état de vos approbations. Les méthodes de la ressource approvals fonctionnent sur les éléments de Drive, Google Docs et d'autres éditeurs Google Workspace.

Vous pouvez suivre cette procédure pour trouver les approbations dans des situations d'examen formel, comme l'examen d'un contrat ou d'un document officiel avant publication. Une approbation permet de suivre l'état de l'examen (par exemple, "En cours", "Approuvé" ou "Refusé") et les réviseurs concernés. Les approbations sont un excellent moyen de valider le contenu et de conserver un enregistrement des réviseurs.

Pour afficher les approbations d'un fichier, vous devez être autorisé à lire ses métadonnées. Pour en savoir plus, consultez Rôles et autorisations.

Utiliser le paramètre "fields"

Si vous souhaitez spécifier les champs à renvoyer dans la réponse, vous pouvez définir le paramètre système fields avec n'importe quelle méthode de la ressource approvals. Si vous omettez le paramètre fields, le serveur renvoie un ensemble de champs par défaut spécifiques à la méthode. Pour renvoyer différents champs, consultez Renvoyer des champs spécifiques.

Obtenir une approbation

Pour obtenir l'approbation d'un fichier, utilisez la méthode get sur la ressource approvals avec les paramètres de chemin d'accès fileId et approvalId. Si vous ne connaissez pas l'ID d'approbation, vous pouvez lister les approbations à l'aide de la méthode list.

Le corps de la réponse contient une instance de la ressource approvals.

Lister les approbations

Pour lister les approbations d'un fichier, appelez la méthode list sur la ressource approvals et incluez le paramètre de chemin d'accès fileId.

Le corps de la réponse se compose d'une liste des approbations du fichier. Le champ items inclut des informations sur chaque approbation sous la forme d'une ressource approvals.

La ressource approvals inclut également un objet Status qui détaille l'état de l'approbation, ainsi que l'objet ReviewerResponse qui détaille la réponse à une approbation effectuée par un examinateur spécifique. La réponse de cet examinateur est représentée par l'objet Response.

Vous pouvez également transmettre les paramètres de requête suivants pour personnaliser la pagination ou filtrer les approbations :

  • pageSize : nombre maximal d'approbations à renvoyer par page. Si vous ne définissez pas pageSize, le serveur renvoie jusqu'à 100 approbations.

  • pageToken : jeton de page reçu d'un appel de liste précédent. Ce jeton permet de récupérer la page suivante. Elle doit être définie sur la valeur de nextPageToken d'une réponse précédente.