Method: approvals.start

Rozpoczyna proces zatwierdzania pliku.

Żądanie HTTP

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

Adres URL używa składni transkodowania gRPC.

Parametry ścieżki

Parametry
fileId

string

Wymagane. Identyfikator pliku, w którym zostanie utworzone zatwierdzenie.

Treść żądania

Treść żądania zawiera dane o następującej strukturze:

Zapis JSON 
{
  "reviewerEmails": [
    string
  ],
  "dueTime": string,
  "lockFile": boolean,
  "message": string
}
Pola
reviewerEmails[]

string

Wymagane. Adresy e-mail użytkowników, którzy mają sprawdzić zatwierdzenie.
dueTime

string (Timestamp format)

Opcjonalnie. Czas, w którym należy zatwierdzić prośbę.

Korzysta ze standardu RFC 3339, w którym wygenerowane dane wyjściowe są zawsze znormalizowane do formatu Z i zawierają 0, 3, 6 lub 9 cyfr po przecinku. Akceptowane są też przesunięcia inne niż „Z”. Przykłady: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" lub "2014-10-02T15:01:23+05:30".
lockFile

boolean

Opcjonalnie. Określa, czy zablokować plik podczas rozpoczynania procesu zatwierdzania.
message

string

Opcjonalnie. Wiadomość do wysłania do recenzentów, gdy powiadamiasz ich o prośbie o zatwierdzenie.

Treść odpowiedzi

W przypadku powodzenia treść odpowiedzi obejmuje wystąpienie elementu Approval.

Zakresy autoryzacji

Wymaga jednego z tych zakresów OAuth:

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

Niektóre zakresy są ograniczone i wymagają oceny bezpieczeństwa, aby aplikacja mogła ich używać. Więcej informacji znajdziesz w przewodniku po autoryzacji.