Mengelola persetujuan

Dokumen ini menjelaskan cara mengelola persetujuan di Google Drive API.

Anda dapat menemukan persetujuan konten Anda di Google Drive. Google Drive API menyediakan resource approvals sehingga Anda dapat mendapatkan dan mencantumkan status persetujuan Anda. Metode approvals resource berfungsi pada item dalam Drive, Google Dokumen, dan editor Google Workspace lainnya.

Anda dapat menggunakan proses ini untuk menemukan persetujuan dalam situasi peninjauan formal, seperti peninjauan kontrak atau dokumen resmi sebelum dipublikasikan. Persetujuan melacak status peninjauan (seperti Dalam Proses, Disetujui, atau Ditolak) dan peninjau yang terlibat. Persetujuan adalah cara yang sangat baik untuk memvalidasi konten dan menyimpan catatan peninjau.

Untuk melihat persetujuan pada file, Anda harus memiliki izin untuk membaca metadata file tersebut. Untuk mengetahui informasi selengkapnya, lihat Peran dan izin.

Menggunakan parameter kolom

Jika ingin menentukan kolom yang akan ditampilkan dalam respons, Anda dapat menyetel parameter sistem fields dengan metode apa pun dari resource approvals. Jika Anda menghapus parameter fields, server akan menampilkan kumpulan kolom default yang khusus untuk metode tersebut. Untuk menampilkan kolom yang berbeda, lihat Menampilkan kolom tertentu.

Mendapatkan persetujuan

Untuk mendapatkan persetujuan pada file, gunakan metode get pada resource approvals dengan parameter jalur fileId dan approvalId. Jika Anda tidak mengetahui ID persetujuan, Anda dapat mencantumkan persetujuan menggunakan metode list.

Isi respons berisi instance resource approvals.

Mencantumkan persetujuan

Untuk mencantumkan persetujuan pada file, panggil metode list pada resource approvals dan sertakan parameter jalur fileId.

Isi respons terdiri dari daftar persetujuan pada file. Kolom items mencakup informasi tentang setiap persetujuan dalam bentuk resource approvals.

Resource approvals juga mencakup objek Status yang menjelaskan status persetujuan, serta objek ReviewerResponse yang menjelaskan respons terhadap persetujuan yang diberikan oleh peninjau tertentu. Respons peninjau ini diwakili oleh objek Response.

Anda juga dapat meneruskan parameter kueri berikut untuk menyesuaikan penomoran halaman atau memfilter persetujuan:

  • pageSize: Jumlah maksimum persetujuan yang akan ditampilkan per halaman. Jika Anda tidak menetapkan pageSize, server akan menampilkan hingga 100 persetujuan.

  • pageToken: Token halaman, yang diterima dari panggilan daftar sebelumnya. Token ini digunakan untuk mengambil halaman berikutnya. Nilai ini harus ditetapkan ke nilai nextPageToken dari respons sebelumnya.