REST Resource: permissions

Kaynak: İzin

Bir dosya için izin. İzin bir dosyaya veya klasör hiyerarşisine bir kullanıcı, grup, alan veya tüm dünyadan erişim sağlar.

Bazı kaynak yöntemleri (ör. permissions.update) için permissionId gerekir. Bir dosyanın, klasörün 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 ifade ettiği 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. İzin türü anyone değilse 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ı için birincil rol. Gelecekte yeni değerler desteklense de şu anda aşağıdakilere izin verilmektedir:

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

string

Bu kullanıcı için ek roller. Şu anda yalnızca commenter için izin veriliyor, ancak gelecekte daha fazlası desteklenebilir.
authKey
(deprecated)

string

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

string

Varlığın e-posta adresi veya alan adı. Bu alan, ekleme işlemi 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. İzin türü anyone değilse hem id hem de value yoksayılır.
kind

string

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

string

Yalnızca çıkış. Bu iznin ifade ettiği kullanıcı veya grubun e-posta adresi. Bu, izin türü user veya group olduğunda bulunan yalnızca çıkışlı bir alandır.
domain

string

Yalnızca çıkış. Bu iznin ifade ettiği varlığın alan adı. Bu, izin türü user, group veya domain olduğunda bulunan ve yalnızca çıkış yapılabilen bir alandır.
etag

string

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

object

Yalnızca çıkış. Bu ortak Drive öğesindeki izinlerin mi doğrudan bu öğede mi devralındığıyla ilgili ayrıntılar. Bu, yalnızca ortak Drive öğeleri için bulunan ve yalnızca çıkış yapılabilen bir alandır.
permissionDetails[].permissionType

string

Yalnızca çıkış. Bu kullanıcı için izin türü. Gelecekte yeni değerler eklenebilir, ancak şu anda aşağıdakiler mümkündür:

  • file
  • member
permissionDetails[].role

string

Yalnızca çıkış. Bu kullanıcı için 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ı için ek roller. Şu anda yalnızca commenter kullanılabilir ancak gelecekte daha fazlası 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ığı. Bu alan her zaman doldurulur. Bu yalnızca çıkış amaçlı bir alandır.
expirationDate

string

Bu iznin süresinin dolacağı saat (RFC 3339 tarih ve saat). Son kullanma tarihleri aşağıdaki kısıtlamalara sahiptir:

  • Yalnızca kullanıcı ve grup izinlerinde ayarlanabilir
  • Tarih, gelecekteki bir tarih olmalıdır
  • Tarih bir yıldan daha sonrası olamaz
teamDrivePermissionDetails[]
(deprecated)

object

Yalnızca çıkış. Kullanımdan kaldırıldı: Bunun yerine permissionDetails kullanın.
teamDrivePermissionDetails[]
(deprecated).teamDrivePermissionType
(deprecated)

string

Yalnızca çıkış. Kullanımdan kaldırıldı: Bunun yerine permissionDetails/permissionType kullanın.
teamDrivePermissionDetails[]
(deprecated).role
(deprecated)

string

Yalnızca çıkış. Kullanımdan kaldırıldı: Bunun yerine permissionDetails/role kullanın.
teamDrivePermissionDetails[]
(deprecated).additionalRoles[]
(deprecated)

string

Yalnızca çıkış. Kullanımdan kaldırıldı: Bunun yerine permissionDetails/additionalRoles kullanın.
teamDrivePermissionDetails[]
(deprecated).inheritedFrom
(deprecated)

string

Yalnızca çıkış. Kullanımdan kaldırıldı: Bunun yerine permissionDetails/inheritedFrom kullanın.
teamDrivePermissionDetails[]
(deprecated).inherited
(deprecated)

boolean

Yalnızca çıkış. Kullanımdan kaldı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 beklemedeki bir sahip olup olmadığı. Yalnızca ortak Drive'da olmayan dosyalara yönelik user türü izinleri için doldurulur.

Yöntemler

delete

 İzni dosyadan veya ortak Drive'dan 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 semantiği kullanarak bir izni günceller.

update

 Bir izni günceller.