Method: permissions.list

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

HTTP isteği

GET https://www.googleapis.com/drive/v3/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
pageSize

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 liste isteğine devam etmek için kullanılan jeton. Bu, önceki yanıtın "nextPageToken" değerine ayarlanmalıdır.
supportsAllDrives

boolean

İstekte bulunan uygulamanın hem Drive'larım hem de ortak Drive'ları destekleyip desteklemediği.
supportsTeamDrives
(deprecated)

boolean

Kullanımdan kaldırıldı: Bunun yerine supportsAllDrives kullanın.
useDomainAdminAccess

boolean

İsteği alan yöneticisi olarak yayınlayın. True değerine ayarlanırsa, dosya kimliği parametresinin bir ortak Drive'a ait olması ve istekte bulunan kişinin ortak Drive'ın ait olduğu alanın yöneticisi olması halinde istekte bulunan kişiye erişim verilir.
includePermissionsForView

string

Yanıta hangi ek görünüm izinlerinin dahil edileceğini belirtir. Yalnızca "yayınlandı" değeri desteklenir.

İstek içeriği

İstek metni boş olmalıdır.

Yanıt gövdesi

Bir dosyaya ait 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,
  "permissions": [
    {
      object (Permission)
    }
  ]
}
Alanlar
nextPageToken

string

Sonraki izin sayfasının sayfa jetonu. İzin listesinin sonuna ulaşıldıysa bu alan gösterilmez. Jeton herhangi bir nedenle reddedilirse silinir ve sayfalara ayırma işlemi ilk sonuç sayfasından yeniden başlatılmalıdır. Sayfa jetonu genellikle birkaç saat boyunca geçerlidir. Ancak yeni öğeler eklenir veya kaldırılırsa beklenen sonuçlar farklı olabilir.
kind

string

Bunun ne tür bir kaynak olduğunu tanımlar. Değer: sabit dize "drive#permissionList".
permissions[]

object (Permission)

İzin listesi. nextPageToken doldurulursa bu liste eksik olabilir ve ek bir sonuç sayfası getirilmelidir.

Yetkilendirme kapsamları

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

  • 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.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 yapılması gerekir. Daha fazla bilgi için Yetkilendirme kılavuzuna göz atın.