Method: files.accessproposals.list

Cantumkan AccessProposals pada file. Catatan: Hanya pemberi persetujuan yang dapat mencantumkan AccessProposal di file. Jika pengguna bukan pemberi persetujuan, menampilkan 403.

Permintaan HTTP

GET https://www.googleapis.com/drive/v3/files/{fileId}/accessproposals

URL menggunakan sintaksis gRPC Transcoding.

Parameter jalur

Parameter
fileId

string

Wajib. ID item tempat permintaan berada.

Parameter kueri

Parameter
pageToken

string

Opsional. Token kelanjutan di daftar permintaan akses.
pageSize

integer

Opsional. Jumlah hasil per halaman

Isi permintaan

Isi permintaan harus kosong.

Isi respons

Respons untuk permintaan daftar Proposal Akses.

Jika berhasil, isi respons memuat data dengan struktur berikut:

Representasi JSON 
{
  "accessProposals": [
    {
      object (AccessProposal)
    }
  ],
  "nextPageToken": string
}
Kolom
accessProposals[]

object (AccessProposal)

Daftar Proposal Akses. Kolom ini hanya diisi di v3 dan v3beta.
nextPageToken

string

Token lanjutan untuk halaman hasil berikutnya. Fungsi ini tidak akan ada jika akhir daftar hasil telah tercapai. Jika ditolak karena alasan apa pun, token harus dihapus, dan penomoran halaman harus dimulai ulang dari halaman pertama hasil.

Cakupan otorisasi

Memerlukan salah satu cakupan OAuth berikut:

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

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

AccessProposal

Referensi Proposal Akses untuk proposal akses yang belum disetujui pada file

Representasi JSON 
{
  "fileId": string,
  "proposalId": string,
  "requesterEmailAddress": string,
  "recipientEmailAddress": string,
  "rolesAndViews": [
    {
      object (RoleAndView)
    }
  ],
  "requestMessage": string,
  "createTime": string
}
Kolom
fileId

string

ID file yang berisi proposal akses
proposalId

string

ID proposal akses
requesterEmailAddress

string

Alamat email pengguna yang meminta
recipientEmailAddress

string

Alamat email pengguna yang akan menerima izin jika diterima
rolesAndViews[]

object (RoleAndView)

Wrapper untuk peran dan tampilan proposal akses.
requestMessage

string

Pesan yang ditambahkan pemohon ke proposal
createTime

string (Timestamp format)

Waktu pembuatan

Stempel waktu dalam format RFC3339 UTC "Zulu", dengan resolusi nanodetik dan hingga sembilan digit pecahan. Contoh: "2014-10-02T15:01:23Z" dan "2014-10-02T15:01:23.045123456Z".

RoleAndView

Wrapper untuk peran dan tampilan proposal akses.

Representasi JSON 
{
  "role": string,
  "view": string
}
Kolom
role

string

Peran yang diusulkan oleh pemohon Nilai baru dapat ditambahkan pada masa mendatang, tetapi saat ini yang dapat digunakan adalah: * writer * commenter * reader
view

string

Menunjukkan tampilan untuk proposal akses ini. Hanya diisi untuk proposal yang termasuk dalam tampilan. published adalah satu-satunya nilai yang didukung.