Method: files.accessproposals.list

Bir dosyada Access Bidding'leri listeleme. Not: Yalnızca onaylayanlar bir dosyada Access Bidding'leri listeleyebilir. Kullanıcı onaylayan değilse 403 döndürülür.

HTTP isteği

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

URL, gRPC Kod Dönüştürme söz dizimini kullanır.

Yol parametreleri

Parametreler
fileId

string

Zorunlu. İsteğin bulunduğu öğenin kimliği.

Sorgu parametreleri

Parametreler
pageToken

string

İsteğe bağlı. Erişim istekleri listesindeki devamlılık jetonu.

pageSize

integer

İsteğe bağlı. Sayfa başına sonuç sayısı

İstek içeriği

İstek metni boş olmalıdır.

Yanıt gövdesi

Erişim teklifi listesi isteğine verilen yanıt.

Başarılı olursa yanıt metni aşağıdaki yapıyla birlikte verileri içerir:

JSON gösterimi
{
  "accessProposals": [
    {
      object (AccessProposal)
    }
  ],
  "nextPageToken": string
}
Alanlar
accessProposals[]

object (AccessProposal)

Erişim teklifleri listesi. Bu alan yalnızca v3 ve v3beta'da doldurulur.

nextPageToken

string

Sonuçların sonraki sayfası için devam jetonu. Sonuç listesinin sonuna ulaşıldığında bu adım eksik olacaktır. Jeton herhangi bir nedenle reddedilirse silinmeli ve sayfalara ayırma işlemi sonuçların ilk sayfasından yeniden başlatılmalıdır.

Yetkilendirme kapsamları

Aşağıdaki OAuth kapsamlarından birini gerektirir:

  • 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

Bazı kapsamlar kısıtlanmıştır ve uygulamanızın bunları kullanabilmesi için güvenlik değerlendirmesi gerekir. Daha fazla bilgi için Yetkilendirme kılavuzuna bakın.

AccessProposal

Bir dosyadaki bekleyen erişim teklifleri için Erişim Teklifi kaynağı

JSON gösterimi
{
  "fileId": string,
  "proposalId": string,
  "requesterEmailAddress": string,
  "recipientEmailAddress": string,
  "rolesAndViews": [
    {
      object (RoleAndView)
    }
  ],
  "requestMessage": string,
  "createTime": string
}
Alanlar
fileId

string

Erişim teklifinin bulunduğu dosya kimliği

proposalId

string

Erişim teklifinin kimliği

requesterEmailAddress

string

İstekte bulunan kullanıcının e-posta adresi

recipientEmailAddress

string

Kabul edilirse izinleri alacak kullanıcının e-posta adresi

rolesAndViews[]

object (RoleAndView)

Bir erişim teklifinin rolü ve görünümü için sarmalayıcı.

requestMessage

string

Talep edenin teklife eklediği mesaj

createTime

string (Timestamp format)

Oluşturma zamanı

Nanosaniye çözünürlüğüne sahip ve en fazla dokuz kesirli basamak içeren RFC3339 UTC "Zulu" biçiminde bir zaman damgası. Örnekler: "2014-10-02T15:01:23Z" ve "2014-10-02T15:01:23.045123456Z".

RoleAndView

Bir erişim teklifinin rolü ve görünümü için sarmalayıcı.

JSON gösterimi
{
  "role": string,
  "view": string
}
Alanlar
role

string

İstek sahibi tarafından önerilen rol Gelecekte yeni değerler eklenebilir, ancak şu anda aşağıdakiler mümkündür: * writer * commenter * reader

view

string

Bu erişim teklifinin görünümünü belirtir. Yalnızca bir görünüme ait teklifler için doldurulur. published desteklenen tek değerdir.