Method: approvals.start

Démarre une approbation sur un fichier.

Requête HTTP

POST https://www.googleapis.com/drive/v3/files/{fileId}/approvals:start

L'URL utilise la syntaxe de transcodage gRPC.

Paramètres de chemin d'accès

Paramètres
fileId

string

Obligatoire. ID du fichier sur lequel l'approbation sera créée.

Corps de la requête

Le corps de la requête contient des données présentant la structure suivante :

Représentation JSON 
{
  "reviewerEmails": [
    string
  ],
  "dueTime": string,
  "lockFile": boolean,
  "message": string
}
Champs
reviewerEmails[]

string

Obligatoire. Adresses e-mail des utilisateurs qui doivent examiner l'approbation.
dueTime

string (Timestamp format)

Facultatif. Heure à laquelle l'approbation doit être effectuée.

Utilise la norme RFC 3339, où la sortie générée utilise toujours le format UTC (indiqué par "Z" pour le temps universel coordonné) avec des secondes fractionnaires de 0, 3, 6 ou 9 chiffres décimaux. Des décalages horaires autres que "Z" (UTC) sont également acceptés. Exemples : "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" ou "2014-10-02T15:01:23+05:30".
lockFile

boolean

Facultatif. Indique si le fichier doit être verrouillé au démarrage de l'approbation.
message

string

Facultatif. Message à envoyer aux examinateurs lorsqu'ils sont informés de la demande d'approbation.

Corps de la réponse

Si la requête aboutit, le corps de la réponse contient une instance de Approval.

Niveaux d'accès des autorisations

Nécessite l'un des champs d'application OAuth suivants :

  • https://www.googleapis.com/auth/drive
  • https://www.googleapis.com/auth/drive.file
  • https://www.googleapis.com/auth/drive.metadata

Certains niveaux d'accès sont limités et nécessitent une évaluation de sécurité pour que votre application puisse les utiliser. Pour en savoir plus, consultez le guide sur l'autorisation.