Method: permissions.list

Bir dosyanın veya ortak Drive'ın izinlerini listeler. Daha fazla bilgi için Dosya, klasör ve sürücü paylaşma başlıklı makaleyi inceleyin.

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

Döndürülecek maksimum izin sayısı. Hizmet, bu değerden daha az sonuç döndürebilir.

Belirtilmemişse ortak Drive'lar için en fazla 100 izin, ortak Drive olmayanlar için ise izinlerin tamamı döndürülür.

Maksimum değer 100'dür. 100'den yüksek değerler 100'e zorlanır.
pageToken

string

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

boolean

İstek gönderen uygulamanın hem Drive'ım hem de ortak Drive'ları destekleyip desteklemediği
supportsTeamDrives
(deprecated)

boolean

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

boolean

İsteği alan yöneticisi olarak gönderin.

true olarak ayarlanırsa ve aşağıdaki ek koşullar karşılanırsa istekte bulunan kullanıcıya erişim izni verilir:

  1. Dosya kimliği parametresi, ortak drive'ı ifade eder.
  2. İsteği gönderen, ortak Drive'ın ait olduğu alanın yöneticisidir.

Daha fazla bilgi için Ortak Drive'ları alan yöneticisi olarak yönetme başlıklı makaleyi inceleyin.
includePermissionsForView

string

Yanıtın hangi ek görünüm izinlerini içereceğini belirtir. Yalnızca published desteklenir.

İstek metni

İstek metni boş olmalıdır.

Yanıt metni

Bir dosyanın izinlerinin listesi.

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

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

object (Permission)

İzinlerin listesi. nextPageToken alanı doldurulmuşsa bu liste eksik olabilir ve ek bir sonuç sayfası getirilmelidir.
nextPageToken

string

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

string

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

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ı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ılavuzu'na bakın.