Method: approvals.start

Startet eine Genehmigung für eine Datei.

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
}
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 gesperrt werden soll, wenn die Genehmigung gestartet wird.
message

string

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

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 für Ihre App, damit sie verwendet werden können. Weitere Informationen finden Sie im Autorisierungsleitfaden.