Method: permissions.list
Koleksiyonlar ile düzeninizi koruyun
İçeriği tercihlerinize göre kaydedin ve kategorilere ayırın.
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
Ö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 politikasını kullanın.
|
useDomainAdminAccess |
boolean
İsteği alan yöneticisi olarak gönderin. Doğru olarak ayarlanırsa dosya kimliği parametresi bir ortak Drive'ı ifade 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ıtın hangi ek görünüm izinlerini içereceğini belirtir. Yalnızca published desteklenir.
|
İstek içeriği
İstek metni boş olmalıdır.
Yanıt gövdesi
Bir dosyayla ilişkili izinlerin listesi.
Başarılı olursa yanıt metni aşağıdaki yapıyla birlikte verileri içerir:
| JSON gösterimi |
{
"items": [
{
object (Permission)
}
],
"nextPageToken": string,
"kind": string,
"etag": string,
"selfLink": string
} |
| Alanlar |
items[] |
object (Permission)
İzinlerin listesi.
|
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.
|
kind |
string
Bu her zaman drive#permissionList olur.
|
etag |
string
Listenin ETag'i.
|
selfLink |
string
Bu listeye geri dönen bir bağlantı.
|
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 yapılması gerekir. Daha fazla bilgi için Yetkilendirme kılavuzu'na bakın.
Aksi belirtilmediği sürece bu sayfanın içeriği Creative Commons Atıf 4.0 Lisansı altında ve kod örnekleri Apache 2.0 Lisansı altında lisanslanmıştır. Ayrıntılı bilgi için Google Developers Site Politikaları'na göz atın. Java, Oracle ve/veya satış ortaklarının tescilli ticari markasıdır.
Son güncelleme tarihi: 2025-07-25 UTC.
[null,null,["Son güncelleme tarihi: 2025-07-25 UTC."],[],[],null,["# Method: permissions.list\n\n- [HTTP request](#body.HTTP_TEMPLATE)\n- [Path parameters](#body.PATH_PARAMETERS)\n- [Query parameters](#body.QUERY_PARAMETERS)\n- [Request body](#body.request_body)\n- [Response body](#body.response_body)\n - [JSON representation](#body.PermissionList.SCHEMA_REPRESENTATION)\n- [Authorization scopes](#body.aspect)\n- [Try it!](#try-it)\n\nLists a file's or shared drive's permissions.\n\n### HTTP request\n\n`GET https://www.googleapis.com/drive/v2/files/{fileId}/permissions`\n\nThe URL uses [gRPC Transcoding](https://google.aip.dev/127) syntax.\n\n### Path parameters\n\n| Parameters ||\n|----------|-----------------------------------------------|\n| `fileId` | `string` The ID for the file or shared drive. |\n\n### Query parameters\n\n| Parameters ||\n|---------------------------------------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `maxResults` | `integer` The maximum number of permissions to return per page. When not set for files in a shared drive, at most 100 results will be returned. When not set for files that are not in a shared drive, the entire list will be returned. |\n| `pageToken` | `string` The token for continuing a previous list request on the next page. This should be set to the value of `nextPageToken` from the previous response. |\n| `supportsAllDrives` | `boolean` Whether the requesting application supports both My Drives and shared drives. |\n| `supportsTeamDrives` **(deprecated)** | `boolean` Deprecated: Use `supportsAllDrives` instead. |\n| `useDomainAdminAccess` | `boolean` Issue the request as a domain administrator; if set to true, then the requester will be granted access if the file ID parameter refers to a shared drive and the requester is an administrator of the domain to which the shared drive belongs. |\n| `includePermissionsForView` | `string` Specifies which additional view's permissions to include in the response. Only `published` is supported. |\n\n### Request body\n\nThe request body must be empty.\n\n### Response body\n\nA list of permissions associated with a file.\n\nIf successful, the response body contains data with the following structure:\n\n| JSON representation |\n|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| ``` { \"items\": [ { object (/workspace/drive/api/reference/rest/v2/permissions#Permission) } ], \"nextPageToken\": string, \"kind\": string, \"etag\": string, \"selfLink\": string } ``` |\n\n| Fields ||\n|-----------------|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `items[]` | `object (`[Permission](/workspace/drive/api/reference/rest/v2/permissions#Permission)`)` The list of permissions. |\n| `nextPageToken` | `string` The page token for the next page of permissions. This field will be absent if the end of the permissions list has been reached. If the token is rejected for any reason, it should be discarded, and pagination should be restarted from the first page of results. |\n| `kind` | `string` This is always `drive#permissionList`. |\n| `etag` | `string` The ETag of the list. |\n| `selfLink` | `string` A link back to this list. |\n\n### Authorization scopes\n\nRequires one of the following OAuth scopes:\n\n- `https://www.googleapis.com/auth/docs`\n- `\n https://www.googleapis.com/auth/drive`\n- `\n https://www.googleapis.com/auth/drive.file`\n- `\n https://www.googleapis.com/auth/drive.meet.readonly`\n- `\n https://www.googleapis.com/auth/drive.metadata`\n- `\n https://www.googleapis.com/auth/drive.metadata.readonly`\n- `\n https://www.googleapis.com/auth/drive.photos.readonly`\n- `\n https://www.googleapis.com/auth/drive.readonly`\n\nSome scopes are restricted and require a security assessment for your app to use them. For more information, see the [Authorization guide](/workspace/guides/configure-oauth-consent)."]]
