REST Resource: permissions

Kaynak: İzin

Bir dosya için izin. İzinler, bir kullanıcıya, gruba, alana veya herkese bir dosya ya da klasör hiyerarşisine erişim izni verir.

Bazı kaynak yöntemleri (permissions.update gibi) permissionId gerektirir. 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,
  "inheritedPermissionsDisabled": boolean
}
Alanlar
id

string

Bu iznin atıfta bulunduğu kullanıcının kimliğidir ve Hakkında ve Dosyalar kaynaklarındaki permissionId ile aynıdır. drive.permissions.insert isteği yapılırken, izin türü anyone olmadığı sürece id veya value alanlarından tam olarak biri belirtilmelidir. Aksi takdirde 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 desteklenebilecek olsa da şu anda aşağıdakilere izin verilir:

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

string

Bu kullanıcının ek rolleri. Şu anda yalnızca commenter desteklenmektedir ancak gelecekte daha fazlası desteklenmeye başlayabilir.
authKey
(deprecated)

string

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

string

Öğenin e-posta adresi veya alan adı. Bu, eklemeler sırasında kullanılır ve yanıtlarda doldurulmaz. drive.permissions.insert isteği yapılırken izin türü anyone olmadığı sürece id veya value alanlarından tam olarak biri belirtilmelidir. Aksi takdirde hem id hem de value yoksayılır.
kind

string

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

string

Yalnızca çıkış. Bu iznin ait olduğu kullanıcı veya grubun e-posta adresi. Bu, izin türü user veya group olduğunda gösterilen yalnızca çıkış alanıdır.
domain

string

Yalnızca çıkış. Bu iznin ait olduğu gerçek veya tüzel kişinin alan adıdır. Bu, izin türü user, group veya domain olduğunda gösterilen yalnızca çıkış alanıdır.
etag

string

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

object

Yalnızca çıkış. Bu öğedeki izinlerin devralınıp devralınmadığı veya doğrudan bu öğede olup olmadığıyla ilgili ayrıntılar.
permissionDetails[].permissionType

string

Yalnızca çıkış. Bu kullanıcının izin türü. Gelecekte yeni değerler eklenebilecek olsa da şu anda aşağıdaki değerler kullanılabilir:

  • file
  • member
permissionDetails[].role

string

Yalnızca çıkış. Bu kullanıcının birincil rolü. Gelecekte yeni değerler eklenebilecek olsa da şu anda aşağıdaki değerler kullanılabilir:

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

string

Yalnızca çıkış. Bu kullanıcının ek rolleri. Şu anda yalnızca commenter desteklenmektedir ancak gelecekte daha fazlası desteklenebilecektir.
permissionDetails[].inheritedFrom

string

Yalnızca çıkış. Bu iznin devralındığı öğenin kimliği. Bu alan yalnızca ortak Drive'lardaki öğeler için doldurulur.
permissionDetails[].inherited

boolean

Yalnızca çıkış. Bu iznin devralınıp devralınmadığı. Bu alan her zaman doldurulur.
expirationDate

string

Bu iznin süresinin dolan zamanı (RFC 3339 tarih-saat biçiminde). Süre sonu tarihleriyle ilgili aşağıdaki kısıtlamalar vardır:

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

object

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

string

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

string

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

string

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

string

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

boolean

Yalnızca çıkış. Desteği sonlandırıldı: Bunun yerine permissionDetails/inherited politikasını 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

ve

metadata

desteklenir.

  • published

    : İznin rolü published_reader.

  • metadata

    : Öğenin sınırlı erişimi ve kapsamın üst öğeye en az okuma erişimi olması nedeniyle öğe yalnızca meta veri görünümünde görünür. Not:

    metadata

    görünümü şu anda yalnızca klasörlerde desteklenmektedir.

pendingOwner

boolean

Bu izinle ilişkili hesabın bekleyen bir sahip olup olmadığı. Yalnızca ortak Drive'da bulunmayan dosyalar için user türündeki izinler doldurulur.
inheritedPermissionsDisabled

boolean

Doğru olduğunda öğeye yalnızca düzenleyenler, sahipler ve doğrudan öğeye eklenen izinlere sahip kullanıcılar erişebilir.

Yöntemler

delete

 Bir dosyada veya ortak Drive'da izinleri 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ğini kullanarak bir izni günceller.

update

 Bir izni günceller.