REST Resource: approvals

Ressource: Genehmigung

Metadaten für eine Genehmigung. Eine Genehmigung ist ein Überprüfungs- oder Genehmigungsprozess für ein Drive-Element.

JSON-Darstellung 
{
  "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)
}
Felder
kind

string

Dies ist immer drive#approval.
approvalId

string

Die Genehmigungs-ID.
targetFileId

string

Die ID der Zieldatei der Genehmigung.
createTime

string (Timestamp format)

Nur Ausgabe. Der Zeitpunkt, zu dem die Genehmigung erstellt wurde.

Verwendet RFC 3339, wobei die generierte Ausgabe immer Z-normalisiert ist und 0, 3, 6 oder 9 Nachkommastellen verwendet. Andere Offsets als „Z“ werden ebenfalls akzeptiert. Beispiele: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" oder "2014-10-02T15:01:23+05:30"
modifyTime

string (Timestamp format)

Nur Ausgabe. Der Zeitpunkt der letzten Änderung der Genehmigung.

Verwendet RFC 3339, wobei die generierte Ausgabe immer Z-normalisiert ist und 0, 3, 6 oder 9 Nachkommastellen verwendet. Andere Offsets als „Z“ werden ebenfalls akzeptiert. Beispiele: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" oder "2014-10-02T15:01:23+05:30"
completeTime

string (Timestamp format)

Nur Ausgabe. Der Zeitpunkt, zu dem die Genehmigung abgeschlossen wurde.

Verwendet RFC 3339, wobei die generierte Ausgabe immer Z-normalisiert ist und 0, 3, 6 oder 9 Nachkommastellen verwendet. Andere Offsets als „Z“ werden ebenfalls akzeptiert. Beispiele: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" oder "2014-10-02T15:01:23+05:30".
dueTime

string (Timestamp format)

Der Zeitpunkt, zu dem die Genehmigung fällig ist.

Verwendet RFC 3339, wobei die generierte Ausgabe immer Z-normalisiert ist und 0, 3, 6 oder 9 Nachkommastellen verwendet. Andere Offsets als „Z“ werden ebenfalls akzeptiert. Beispiele: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" oder "2014-10-02T15:01:23+05:30"
status

enum (Status)

Nur Ausgabe. Der Status der Genehmigung zum Zeitpunkt der Anforderung dieser Ressource.
initiator

object (User)

Der Nutzer, der die Genehmigung angefordert hat.
reviewerResponses[]

object (ReviewerResponse)

Die Antworten der Überprüfer auf die Genehmigung.
fileContentChangeBehavior

enum (FileContentChangeBehavior)

Nur Ausgabe. Das Verhalten der Genehmigung bei Änderungen am Dateiinhalt.

Status

Mögliche Status einer Genehmigung.

Enums
STATUS_UNSPECIFIED Der Freigabestatus wurde nicht festgelegt oder auf einen ungültigen Wert gesetzt.
IN_PROGRESS Der Genehmigungsprozess wurde gestartet und ist noch nicht abgeschlossen.
APPROVED Der Genehmigungsprozess ist abgeschlossen und das Ziel wurde genehmigt.
CANCELLED Der Genehmigungsprozess wurde vor Abschluss abgebrochen.
DECLINED Der Genehmigungsprozess ist abgeschlossen und das Ziel wurde abgelehnt.

ReviewerResponse

Eine Antwort eines bestimmten Überprüfers auf eine Genehmigung.

JSON-Darstellung 
{
  "kind": string,
  "reviewer": {
    object (User)
  },
  "response": enum (Response)
}
Felder
kind

string

Dies ist immer drive#reviewerResponse.
reviewer

object (User)

Der Nutzer, der für diese Antwort verantwortlich ist.
response

enum (Response)

Die Antwort eines Überprüfers auf die Genehmigung.

Antwort

Mögliche Antworten für eine Genehmigung.

Enums
RESPONSE_UNSPECIFIED Die Antwort wurde auf einen nicht erkannten Wert gesetzt.
NO_RESPONSE Der Überprüfer hat nicht geantwortet.
APPROVED Der Überprüfer hat das Element genehmigt.
DECLINED Der Überprüfer hat das Element abgelehnt.

FileContentChangeBehavior

Das Verhalten der Genehmigung bei Änderungen am Dateiinhalt, während der [Status][] der Genehmigung IN_PROGRESS ist. Dieses Verhalten tritt nicht mehr auf, sobald die Genehmigung abgeschlossen ist.

Enums
FILE_CONTENT_CHANGE_BEHAVIOR_UNSPECIFIED Das Verhalten ist nicht angegeben.
RESET_APPROVAL Jede ReviewerResponse mit einer Response von APPROVED wird auf NO_DECISION zurückgesetzt, wenn der Dateiinhalt geändert wird, während die Genehmigung den [Status][] IN_PROGRESS hat. Wenn die Genehmigung den [Status][] APPROVED hat und RESET_APPROVAL ausgewählt ist, wird die Datei gesperrt.
NO_APPROVAL_ACTION Bei Änderungen am Dateiinhalt wird keine Aktion ausgeführt.

Methoden

approve

 Genehmigt eine Genehmigung.

cancel

 Bricht eine Genehmigung ab.

comment

 Kommentiert eine Genehmigung.

decline

 Lehnt eine Genehmigung ab.

get

 Ruft eine Genehmigung anhand der ID ab.

list

 Listet die Genehmigungen für eine Datei auf.

reassign

 Weist die Überprüfer für eine Genehmigung neu zu.

start

 Startet eine Genehmigung für eine Datei.