Method: permissions.list

Bir dosyanın veya ortak drive'ın izinlerini listeler.

HTTP isteği

GET https://www.googleapis.com/drive/v2/files/{fileId}/permissions

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

Yol parametreleri

Parametreler
fileId

string

Dosyanın veya ortak drive'ın kimliği.

Sorgu parametreleri

Parametreler
maxResults

integer

Sayfa başına döndürülecek maksimum izin sayısı. Ortak Drive'daki dosyalar için ayarlanmadığında en fazla 100 sonuç döndürülür. Ortak Drive'da olmayan dosyalar için ayarlanmadığında listenin tamamı döndürülür.

pageToken

string

Sonraki sayfada önceki bir liste isteğini devam ettirmek için kullanılan jeton. Bu, önceki yanıttaki nextPageToken değerine ayarlanmalıdır.

supportsAllDrives

boolean

İstekte bulunan uygulamanın hem Drive'ım klasörlerini hem de ortak drive'ları destekleyip desteklemediği.

supportsTeamDrives
(deprecated)

boolean

Desteği sonlandırıldı: Bunun yerine supportsAllDrives kullanın.

useDomainAdminAccess

boolean

Alan yöneticisi olarak isteği gönderme; Doğru değerine ayarlanırsa, dosya kimliği parametresi bir ortak Drive'a işaret ediyorsa ve istekte bulunan kişi, ortak Drive'ın ait olduğu alanın yöneticisiyse istekte bulunan kişiye erişim izni verilir.

includePermissionsForView

string

Yanıta hangi ek görünümün izinlerinin dahil edileceğini belirtir. Yalnızca published desteklenir.

İstek içeriği

İstek metni boş olmalıdır.

Yanıt gövdesi

Bir dosyayla ilişkilendirilmiş izinlerin listesi.

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

JSON gösterimi
{
  "nextPageToken": string,
  "kind": string,
  "etag": string,
  "selfLink": string,
  "items": [
    {
      object (Permission)
    }
  ]
}
Alanlar
nextPageToken

string

Bir sonraki izin sayfasının sayfa jetonu. İzin listesinin sonuna ulaşıldıysa bu alan 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.

kind

string

Bu her zaman drive#permissionList.

etag

string

Listenin ETag'i.

items[]

object (Permission)

İzin listesi.

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.meet.readonly
  • https://www.googleapis.com/auth/drive.metadata
  • https://www.googleapis.com/auth/drive.metadata.readonly
  • https://www.googleapis.com/auth/drive.photos.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ılavuzunu inceleyin.