Method: approvals.reassign

Weist die Prüfer für eine Genehmigung neu zu. Fügt Prüfer in der ReviewerResponse der Genehmigung hinzu oder ersetzt sie.

Diese Methode kann von jedem Nutzer mit der Berechtigung writer für die Datei aufgerufen werden, solange der Status der Genehmigung IN_PROGRESS ist und die Response für den neu zugewiesenen Prüfer NO_RESPONSE lautet. Ein Nutzer mit der Berechtigung reader kann nur eine Genehmigung neu zuweisen, die ihm zugewiesen wurde.

Das Entfernen eines Prüfers ist nicht zulässig.

HTTP-Anfrage

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

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 neu zuzuweisenden Genehmigung.

Anfragetext

Der Anfragetext enthält Daten mit folgender Struktur:

JSON-Darstellung
{
  "addReviewers": [
    {
      object (AddReviewer)
    }
  ],
  "replaceReviewers": [
    {
      object (ReplaceReviewer)
    }
  ],
  "message": string
}
Felder
addReviewers[]

object (AddReviewer)

Optional. Die Liste der hinzuzufügenden Prüfer.

replaceReviewers[]

object (ReplaceReviewer)

Optional. Die Liste der Prüfer, die ersetzt werden sollen.

message

string

Optional. Eine Nachricht, die an die neuen Prüfer gesendet werden soll. Diese Nachricht wird in Benachrichtigungen für die Aktion und im Aktivitätsprotokoll der Genehmigung 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.

AddReviewer

Darstellung einer Prüferhinzufügung.

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

string

Erforderlich. Die E‑Mail-Adresse des hinzuzufügenden Prüfers.

ReplaceReviewer

Darstellung eines Prüferaustauschs.

JSON-Darstellung
{
  "addedReviewerEmail": string,
  "removedReviewerEmail": string
}
Felder
addedReviewerEmail

string

Erforderlich. Die E‑Mail-Adresse des hinzuzufügenden Prüfers.

removedReviewerEmail

string

Erforderlich. Die E‑Mail-Adresse des zu entfernenden Prüfers.