REST Resource: permissions

Kaynak: İzin

Dosya için izin. İzin; bir kullanıcıya, gruba, alan adına ya da tüm dünyaya bir dosyaya veya klasör hiyerarşisine erişim verir.

Bazı kaynak yöntemleri (permissions.update gibi) permissionId gerektirir. Bir dosya, klasör veya ortak Drive'ın kimliğini almak için permissions.list yöntemini kullanın.

JSON gösterimi 
{
  "id": string,
  "name": string,
  "type": string,
  "role": string,
  "additionalRoles": [
    string
  ],
  "authKey": string,
  "value": string,
  "kind": string,
  "withLink": boolean,
  "photoLink": string,
  "selfLink": string,
  "emailAddress": string,
  "domain": string,
  "etag": string,
  "permissionDetails": [
    {
      "permissionType": string,
      "role": string,
      "additionalRoles": [
        string
      ],
      "inheritedFrom": string,
      "inherited": boolean
    }
  ],
  "expirationDate": string,
  "teamDrivePermissionDetails": [
    {
      "teamDrivePermissionType": string,
      "role": string,
      "additionalRoles": [
        string
      ],
      "inheritedFrom": string,
      "inherited": boolean
    }
  ],
  "deleted": boolean,
  "view": string,
  "pendingOwner": boolean
}
Alanlar
id

string

Bu iznin ait olduğu kullanıcının kimliğidir ve Hakkında ve Dosyalar kaynaklarındaki permissionId ile aynıdır. drive.permissions.insert isteğinde bulunurken izin türü anyone olmadığı sürece id veya value alanlarından tam olarak biri belirtilmelidir. Bu durumda hem id hem de value yoksayılır.
name

string

Yalnızca çıkış. Bu iznin adı.
type

string

Hesap türü. İzin verilen değerler:

  • user
  • group
  • domain
  • anyone
role

string

Bu kullanıcının birincil rolü. Gelecekte yeni değerler desteklenmekle birlikte şu anda aşağıdakilere izin verilmektedir:

  • owner
  • organizer
  • fileOrganizer
  • writer
  • reader
additionalRoles[]

string

Bu kullanıcıya ek roller. Şu anda yalnızca commenter için izin verilir ancak gelecekte daha fazla uygulama desteklenebilir.
authKey
(deprecated)

string

Yalnızca çıkış. Kullanımdan kaldırıldı.
value

string

Varlığın e-posta adresi veya alan adı. Bu ad, ekleme sırasında kullanılır ve yanıtlarda doldurulmaz. drive.permissions.insert isteğinde bulunurken izin türü anyone olmadığı sürece id veya value alanlarından tam olarak biri belirtilmelidir. Bu durumda hem id hem de value yoksayılır.
kind

string

Yalnızca çıkış. Bu her zaman drive#permission.
emailAddress

string

Yalnızca çıkış. Bu iznin belirttiği kullanıcı veya grubun e-posta adresi. Bu, izin türü user veya group olduğunda mevcut olan bir salt çıkış alanıdır.
domain

string

Yalnızca çıkış. Bu iznin ait olduğu tüzel kişinin alan adıdır. Bu, izin türü user, group veya domain olduğunda mevcut olan bir salt çıkış alanıdır.
etag

string

Yalnızca çıkış. İznin ETag'i.
permissionDetails[]

object

Yalnızca çıkış. Bu ortak Drive öğesindeki izinlerin devralındığı veya doğrudan bu öğe üzerinde mi alındığına dair ayrıntılar. Bu, sadece ortak drive öğeleri için mevcut olan bir salt çıkış alanıdır.
permissionDetails[].permissionType

string

Yalnızca çıkış. Bu kullanıcının izin türü. Gelecekte yeni değerler eklenebilir ancak şu anda aşağıdakiler kullanılabilir:

  • file
  • member
permissionDetails[].role

string

Yalnızca çıkış. Bu kullanıcının birincil rolü. Gelecekte yeni değerler eklenebilir ancak şu anda aşağıdakiler mümkündür:

  • organizer
  • fileOrganizer
  • writer
  • reader
permissionDetails[].additionalRoles[]

string

Yalnızca çıkış. Bu kullanıcıya ek roller. Şu anda yalnızca commenter kullanılabilir, ancak gelecekte daha fazla uygulama desteklenebilir.
permissionDetails[].inheritedFrom

string

Yalnızca çıkış. Bu iznin devralındığı öğenin kimliği. Bu yalnızca çıkış amaçlı bir alandır.
permissionDetails[].inherited

boolean

Yalnızca çıkış. Bu iznin devralınıp alınmadığını belirtir. Bu alan her zaman doldurulur. Bu yalnızca çıkış amaçlı bir alandır.
expirationDate

string

Bu iznin süresinin dolacağı zaman (RFC 3339 tarih-saat). Geçerlilik bitiş tarihleri için aşağıdaki kısıtlamalar geçerlidir:

  • Yalnızca kullanıcı ve grup izinlerinde ayarlanabilir
  • Bu tarih, gelecekteki bir tarih olmalıdır.
  • Tarih, en fazla bir yıl sonrası olabilir
teamDrivePermissionDetails[]
(deprecated)

object

Yalnızca çıkış. Desteği sonlandırıldı: Bunun yerine permissionDetails kullanın.
teamDrivePermissionDetails[]
(deprecated).teamDrivePermissionType
(deprecated)

string

Yalnızca çıkış. Desteği sonlandırıldı: Bunun yerine permissionDetails/permissionType kullanın.
teamDrivePermissionDetails[]
(deprecated).role
(deprecated)

string

Yalnızca çıkış. Desteği sonlandırıldı: Bunun yerine permissionDetails/role kullanın.
teamDrivePermissionDetails[]
(deprecated).additionalRoles[]
(deprecated)

string

Yalnızca çıkış. Desteği sonlandırıldı: Bunun yerine permissionDetails/additionalRoles kullanın.
teamDrivePermissionDetails[]
(deprecated).inheritedFrom
(deprecated)

string

Yalnızca çıkış. Desteği sonlandırıldı: Bunun yerine permissionDetails/inheritedFrom kullanın.
teamDrivePermissionDetails[]
(deprecated).inherited
(deprecated)

boolean

Yalnızca çıkış. Desteği sonlandırıldı: Bunun yerine permissionDetails/inherited kullanın.
deleted

boolean

Yalnızca çıkış. Bu izinle ilişkili hesabın silinip silinmediği. Bu alan yalnızca kullanıcı ve grup izinleriyle ilgilidir.
view

string

Bu iznin görünümünü belirtir. Yalnızca bir görünüme ait izinler için doldurulur. published desteklenen tek değerdir.
pendingOwner

boolean

Bu izinle ilişkili hesabın beklemede olan bir sahip olup olmadığı. Yalnızca ortak drive'da olmayan dosyalara ilişkin user türü izinleri için doldurulur.

Yöntemler

delete

 Bir dosyadan veya ortak Drive'dan izni siler.

get

 Kimliğe göre izin alır.

getIdForEmail

 Bir e-posta adresinin izin kimliğini döndürür.

insert

 Bir dosya veya ortak drive için izin ekler.

list

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

patch

 Yama anlamını kullanarak bir izni günceller.

update

 Bir izni günceller.