Gérer les approbations

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

Vous pouvez trouver 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 utiliser ce processus pour localiser les approbations dans des situations d'examen formel, comme l'examen d'un contrat ou d'un document officiel avant sa publication. Une approbation suit l'état de l'examen (par exemple, "En cours", "Approuvé" ou "Refusé") et les approbateurs impliqués. Les approbations sont un excellent moyen de valider le contenu et de conserver un enregistrement des approbateurs.

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 fields paramètre système avec n'importe quelle méthode de la res3source.approvals Si vous omettez le paramètre fields, le serveur renvoie un ensemble de champs par défaut spécifique à la méthode. Pour renvoyer différents champs, consultez la section Renvoyer des champs spécifiques.

Obtenir une approbation

Pour obtenir une approbation sur un fichier, utilisez la get méthode 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 approvals ressource.

Lister les approbations

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

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

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

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. Il doit être défini sur la valeur de nextPageToken d'une réponse précédente.