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

Önceki liste isteğine sonraki sayfada devam etmek için kullanılan jeton. Bu parametre, önceki yanıttaki "nextPageToken" değerine ayarlanmalıdır.
supportsAllDrives

boolean

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

boolean

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

boolean

İsteği bir alan yöneticisi olarak gönderin. Doğru olarak ayarlanırsa dosya kimliği parametresi bir ortak Drive'ı ifade ediyorsa ve istek sahibi, ortak Drive'ın ait olduğu alanın yöneticisiyse istek sahibine erişim izni verilir.
includePermissionsForView

string

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

İstek içeriği

İstek metni boş olmalıdır.

Yanıt gövdesi

Bir dosyanın izinlerinin 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

İzinlerin bir sonraki sayfası için sayfa jetonu. İzinler listesinin sonuna ulaşıldıysa bu alan bulunmaz. Jeton herhangi bir nedenle reddedilirse atılmalıdır ve sayfalandırma, sonuçların ilk sayfasından yeniden başlatılmalıdır. Sayfa jetonu genellikle birkaç saat boyunca geçerlidir. Ancak yeni öğeler eklenirse veya kaldırılırsa beklediğiniz sonuçlar farklı olabilir.
kind

string

Bu kaynağın ne tür olduğunu tanımlar. Değer: "drive#permissionList" sabit dizesi.
permissions[]

object (Permission)

İzinlerin listesi. nextPageToken doldurulmuşsa 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.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ıtlıdır ve uygulamanızın bunları kullanabilmesi için güvenlik değerlendirmesi gerekir. Daha fazla bilgi için Yetkilendirme kılavuzuna bakın.