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,
  "displayName": string,
  "type": string,
  "kind": string,
  "permissionDetails": [
    {
      "permissionType": string,
      "inheritedFrom": string,
      "role": string,
      "inherited": boolean
    }
  ],
  "photoLink": string,
  "emailAddress": string,
  "role": string,
  "allowFileDiscovery": boolean,
  "domain": string,
  "expirationTime": string,
  "teamDrivePermissionDetails": [
    {
      "teamDrivePermissionType": string,
      "inheritedFrom": string,
      "role": string,
      "inherited": boolean
    }
  ],
  "deleted": boolean,
  "view": string,
  "pendingOwner": boolean
}
Alanlar
id

string

Yalnızca çıkış. Bu iznin kimliği. Bu, bağış alan için benzersiz bir tanımlayıcıdır ve Kullanıcı kaynaklarında permissionId olarak yayınlanır. Kimlikler opak değer olarak kabul edilmelidir.
displayName

string

Yalnızca çıkış. "Güzel" izin değerinin adı. Aşağıda, her izin türüne ilişkin örnek listesi verilmiştir:

  • user - Kullanıcının Google Hesabı için tanımlandığı şekilde tam adı (ör. "Can Yılmaz").
  • group - Google Grubunun adı (ör. "Şirket Yöneticileri").
  • domain: "sirket.com" gibi dize alan adı.
  • anyone - displayName yok.
type

string

Bağış alan tarafın türü. Geçerli değerler şunlardır:

  • user
  • group
  • domain
  • anyone

İzin oluştururken type değeri user veya group ise kullanıcı ya da grup için emailAddress sağlamanız gerekir. type değeri domain olduğunda domain sağlamanız gerekir. anyone türü için ek bilgi gerekmez.
kind

string

Yalnızca çıkış. Bunun ne tür bir kaynak olduğunu tanımlar. Değer: sabit "drive#permission" dizesi.
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[].inheritedFrom

string

Yalnızca çıkış. Bu iznin devralındığı öğenin kimliği. Bu yalnızca çıkış amaçlı bir alandır.
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
  • commenter
  • reader
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.
emailAddress

string

Bu iznin ait olduğu kullanıcı veya grubun e-posta adresi.
role

string

Bu izinle verilen rol. Gelecekte yeni değerler desteklenmekle birlikte şu anda aşağıdakilere izin verilmektedir:

  • owner
  • organizer
  • fileOrganizer
  • writer
  • commenter
  • reader
allowFileDiscovery

boolean

İznin, dosyanın arama yoluyla keşfedilmesine izin verip vermediği. Bu yalnızca domain veya anyone türündeki izinler için geçerlidir.
domain

string

Bu iznin ait olduğu alan.
expirationTime

string

Bu iznin süresinin dolacağı zaman (RFC 3339 tarih-saat). Sona erme zamanları aşağıdaki kısıtlamalara tabidir:

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

object

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

string

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

string

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

string

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

boolean

Desteği sonlandırıldı: Yalnızca çıkış. 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. "yayınlandı" 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

create

 Bir dosya veya ortak drive için izin oluşturur.

delete

 Bir izni siler.

get

 Kimliğe göre izin alır.

list

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

update

 İzni yama anlamıyla günceller.