REST Resource: approvals

Ressource : Approval

Métadonnées d'une approbation. Une approbation est un processus d'examen ou d'approbation d'un élément Drive.

Représentation JSON 
{
  "kind": string,
  "approvalId": string,
  "targetFileId": string,
  "createTime": string,
  "modifyTime": string,
  "completeTime": string,
  "dueTime": string,
  "status": enum (Status),
  "initiator": {
    object (User)
  },
  "reviewerResponses": [
    {
      object (ReviewerResponse)
    }
  ],
  "fileContentChangeBehavior": enum (FileContentChangeBehavior)
}
Champs
kind

string

Il s'agit toujours de drive#approval.
approvalId

string

ID de l'approbation.
targetFileId

string

ID du fichier cible de l'approbation.
createTime

string (Timestamp format)

Uniquement en sortie. Heure de création de l'approbation.

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

string (Timestamp format)

Uniquement en sortie. Date et heure de la dernière modification de l'approbation.

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

string (Timestamp format)

Uniquement en sortie. Heure à laquelle l'approbation a été 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".
dueTime

string (Timestamp format)

Heure à laquelle l'approbation est due.

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

enum (Status)

Uniquement en sortie. État de l'approbation au moment où cette ressource a été demandée.
initiator

object (User)

Utilisateur qui a demandé l'approbation.
reviewerResponses[]

object (ReviewerResponse)

Réponses des examinateurs à la demande d'approbation.
fileContentChangeBehavior

enum (FileContentChangeBehavior)

Uniquement en sortie. Comportement de l'approbation lorsque le contenu du fichier est modifié.

État

États possibles d'une approbation.

Enums
STATUS_UNSPECIFIED L'état d'approbation n'a pas été défini ou a été défini sur une valeur non valide.
IN_PROGRESS Le processus d'approbation a commencé, mais n'est pas terminé.
APPROVED Le processus d'approbation est terminé et la cible a été approuvée.
CANCELLED La procédure d'approbation a été annulée avant d'être terminée.
DECLINED Le processus d'approbation est terminé et la cible a été refusée.

ReviewerResponse

Réponse à une approbation effectuée par un examinateur spécifique.

Représentation JSON 
{
  "kind": string,
  "reviewer": {
    object (User)
  },
  "response": enum (Response)
}
Champs
kind

string

Il s'agit toujours de drive#reviewerResponse.
reviewer

object (User)

Utilisateur responsable de cette réponse.
response

enum (Response)

Réponse d'un examinateur concernant l'approbation.

Réponse

Réponses possibles pour une approbation.

Enums
RESPONSE_UNSPECIFIED La réponse a été définie sur une valeur non reconnue.
NO_RESPONSE L'examinateur n'a pas répondu.
APPROVED L'examinateur a approuvé l'élément.
DECLINED La personne qui a examiné la demande a refusé l'élément.

FileContentChangeBehavior

Comportement de l'approbation lorsque le contenu du fichier change alors que l'état de l'approbation est IN_PROGRESS. Ce comportement ne se produit plus une fois l'approbation terminée.

Enums
FILE_CONTENT_CHANGE_BEHAVIOR_UNSPECIFIED Le comportement n'est pas spécifié.
RESET_APPROVAL Tout ReviewerResponse dont le Response est défini sur "APPROVED" (APPROUVÉ) sera réinitialisé sur "NO_DECISION" (AUCUNE_DÉCISION) si le contenu du fichier est modifié alors que l'approbation a l'état "IN_PROGRESS" (EN_COURS). Lorsque l'approbation a l'état [Status][] "APPROUVÉ" et que RESET_APPROVAL est sélectionné, le fichier est verrouillé.
NO_APPROVAL_ACTION Aucune action n'est effectuée lorsque le contenu du fichier change.

Méthodes

approve

 Approuve une approbation.

cancel

 Annule une approbation.

comment

 Commentaires sur une approbation.

decline

 Refuse une approbation.

get

 Obtient une approbation par ID.

list

 Liste les approbations d'un fichier.

reassign

 Réattribue les examinateurs d'une approbation.

start

 Démarre une approbation pour un fichier.