Method: approvals.start

Memulai Persetujuan pada file.

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 akan dibuat.

Isi permintaan

Isi permintaan memuat data dengan struktur berikut:

Representasi JSON
{
  "reviewerEmails": [
    string
  ],
  "dueTime": string,
  "lockFile": boolean,
  "message": string
}
Kolom
reviewerEmails[]

string

Wajib. Email pengguna yang ditetapkan untuk meninjau persetujuan.

dueTime

string (Timestamp format)

Opsional. Waktu persetujuan berakhir.

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. Apakah akan mengunci file saat memulai Persetujuan.

message

string

Opsional. Pesan yang akan dikirim kepada peninjau saat memberi tahu mereka tentang Permintaan persetujuan.

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.