Method: approvals.cancel

Bricht eine Genehmigung ab. Aktualisiert die Genehmigung Status auf CANCELLED.

Diese Funktion kann von jedem Nutzer mit der Berechtigung writer für die Datei aufgerufen werden, solange der Genehmigungsstatus Status IN_PROGRESS ist.

HTTP-Anfrage

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

Die URL verwendet die Syntax der gRPC-Transcodierung.

Pfadparameter

Parameter
fileId

string

Erforderlich. Die ID der Datei, für die die Genehmigung gilt.
approvalId

string

Erforderlich. Die ID der Genehmigung, die abgebrochen werden soll.

Anfragetext

Der Anfragetext enthält Daten mit folgender Struktur:

JSON-Darstellung 
{
  "message": string
}
Felder
message

string

Optional. Eine Nachricht zur Begründung der Kündigung der Genehmigung. Diese Nachricht wird in Benachrichtigungen für die Aktion und im Genehmigungsaktivitätslog angezeigt.

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.