Method: approvals.start

Memulai persetujuan pada file. Untuk mengetahui informasi selengkapnya, lihat Mengelola persetujuan.

Permintaan HTTP

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

URL ini menggunakan sintaksis gRPC Transcoding.

Parameter jalur

Parameter
fileId

string

Wajib. ID file tempat persetujuan dibuat.

Isi permintaan

Isi permintaan memuat data dengan struktur berikut:

Representasi JSON 
{
  "reviewerEmails": [
    string
  ],
  "dueTime": string,
  "lockFile": boolean,
  "message": string,
  "fileContentChangeBehavior": enum (FileContentChangeBehavior)
}
Kolom
reviewerEmails[]

string

Wajib. Email pengguna yang ditetapkan untuk meninjau persetujuan.
dueTime

string (Timestamp format)

Opsional. Waktu persetujuan jatuh tempo.

Menggunakan RFC 3339 yang outputnya akan selalu dinormalisasi Z dan menggunakan 0, 3, 6, atau 9 digit pecahan. Offset selain "Z" juga diterima. Contoh: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z", atau "2014-10-02T15:01:23+05:30".
lockFile

boolean

Opsional. Menentukan apakah akan mengunci file saat memulai persetujuan.
message

string

Opsional. Pesan yang akan dikirim ke peninjau saat memberi tahu mereka tentang permintaan persetujuan.
fileContentChangeBehavior

enum (FileContentChangeBehavior)

Opsional. Perilaku persetujuan saat konten file berubah.

Isi respons

Jika berhasil, isi respons memuat instance Approval.

Cakupan otorisasi

Memerlukan salah satu cakupan OAuth berikut:

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

Beberapa cakupan dibatasi dan memerlukan penilaian keamanan agar aplikasi Anda dapat menggunakannya. Untuk mengetahui informasi selengkapnya, lihat Panduan otorisasi.