- HTTP isteği
- Yol parametreleri
- Sorgu parametreleri
- İstek metni
- Yanıt metni
- Yetkilendirme kapsamları
- AccessProposal
- RoleAndView
- Deneyin.
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 | |
---|---|
file |
Zorunlu. İsteğin bulunduğu öğenin kimliği. |
Sorgu parametreleri
Parametreler | |
---|---|
page |
İsteğe bağlı. Erişim istekleri listesindeki devamlılık jetonu. |
page |
İ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 ( |
Alanlar | |
---|---|
access |
Erişim teklifleri listesi. Bu alan yalnızca v3 ve v3beta'da doldurulur. |
next |
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 ( |
Alanlar | |
---|---|
file |
Erişim teklifinin bulunduğu dosya kimliği |
proposal |
Erişim teklifinin kimliği |
requester |
İstekte bulunan kullanıcının e-posta adresi |
recipient |
Kabul edilirse izinleri alacak kullanıcının e-posta adresi |
roles |
Bir erişim teklifinin rolü ve görünümü için sarmalayıcı. |
request |
Talep edenin teklife eklediği mesaj |
create |
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: |
RoleAndView
Bir erişim teklifinin rolü ve görünümü için sarmalayıcı.
JSON gösterimi |
---|
{ "role": string, "view": string } |
Alanlar | |
---|---|
role |
İstek sahibi tarafından önerilen rol Gelecekte yeni değerler eklenebilir, ancak şu anda aşağıdakiler mümkündür: * |
view |
Bu erişim teklifinin görünümünü belirtir. Yalnızca bir görünüme ait teklifler için doldurulur. |