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

La valeur est toujours drive#approval.

approvalId

string

ID de l'approbation.

targetFileId

string

ID du fichier cible de l'approbation.

createTime

string (Timestamp format)

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)

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)

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)

Date limite 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".

status

enum (Status)

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

initiator

object (User)

Utilisateur ayant demandé l'approbation.

reviewerResponses[]

object (ReviewerResponse)

Réponses apportées à l'approbation par les examinateurs.

fileContentChangeBehavior

enum (FileContentChangeBehavior)

Comportement de l'approbation lorsque le contenu du fichier change.

É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 Le processus d'approbation a été annulé avant d'être terminé.
DECLINED Le processus d'approbation est terminé et la cible a été refusée.

ReviewerResponse

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

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

string

La valeur est toujours drive#reviewerResponse.

reviewer

object (User)

Utilisateur responsable de cette réponse.

response

enum (Response)

Réponse d'un réviseur pour 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 L'examinateur a refusé l'élément.

FileContentChangeBehavior

Comportement de l'approbation lorsque le contenu du fichier change alors que l'approbation Status 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 avec un Response de APPROVED sera réinitialisé sur NO_DECISION lorsque le contenu du fichier changera alors que l'approbation aura un Status de IN_PROGRESS. Lorsque l'approbation a un Status de APPROVED 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

Récupère une approbation par ID.

list

Répertorie les approbations d'un fichier.

reassign

Réattribue les réviseurs d'une approbation.

start

Démarre une approbation sur un fichier.