Method: approvals.start

Startet einen Genehmigungsprozess für eine Datei. Weitere Informationen finden Sie unter Genehmigungen verwalten.

HTTP-Anfrage

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

Die URL verwendet die Syntax der gRPC-Transcodierung.

Pfadparameter

Parameter
fileId

string

Erforderlich. Die ID der Datei, für die die Genehmigung erstellt wird.

Anfragetext

Der Anfragetext enthält Daten mit folgender Struktur:

JSON-Darstellung 
{
  "reviewerEmails": [
    string
  ],
  "dueTime": string,
  "lockFile": boolean,
  "message": string,
  "fileContentChangeBehavior": enum (FileContentChangeBehavior)
}
Felder
reviewerEmails[]

string

Erforderlich. Die E‑Mail-Adressen der Nutzer, die die Genehmigung prüfen sollen.
dueTime

string (Timestamp format)

Optional. 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".
lockFile

boolean

Optional. Gibt an, ob die Datei beim Start der Genehmigung gesperrt werden soll.
message

string

Optional. Eine Nachricht, die an Prüfer gesendet wird, wenn sie über die Genehmigungsanfrage benachrichtigt werden.
fileContentChangeBehavior

enum (FileContentChangeBehavior)

Optional. Das Verhalten der Genehmigung, wenn sich der Dateiinhalt ändert.

Antworttext

Wenn der Vorgang erfolgreich abgeschlossen wurde, enthält der Antworttext eine Instanz von Approval.

Autorisierungsbereiche

Erfordert einen der folgenden OAuth-Bereiche:

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

Einige Bereiche sind eingeschränkt und erfordern eine Sicherheitsprüfung, damit Ihre App sie verwenden kann. Weitere Informationen finden Sie im Autorisierungsleitfaden.