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,
  "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ın benzersiz tanımlayıcısıdır ve Kullanıcı kaynaklarında permissionId adıyla yayınlanır. Kimlikler, opak değerler olarak ele alınmalıdır.
displayName

string

Yalnızca çıkış. İzin değerinin "güzel" adı. Her bir izin türüyle ilgili örnekleri aşağıda bulabilirsiniz:

  • user - Kullanıcının Google Hesabı için tanımlandığı şekliyle tam adı (ör. "Ali Demir").
  • group: Google Grubu'nun adı (ör. "Şirket Yöneticileri").
  • domain: "sirket.com" gibi bir dize alan adı.
  • anyone - displayName yok.
type

string

Bağış alanın türü. Valid values are:

  • user
  • group
  • domain
  • anyone

Bir izin oluştururken type değeri user veya group ise kullanıcı veya grup için bir emailAddress sağlamanız gerekir. type, 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 dize "drive#permission".
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[].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ı için 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ığı. Bu alan her zaman doldurulur. Bu yalnızca çıkış amaçlı bir alandır.
emailAddress

string

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

string

Bu izin tarafından verilen rol. Gelecekte yeni değerler desteklense de ş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ğini belirtir. 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ğı saat (RFC 3339 tarih ve saat). Sona erme süreleri için aşağıdaki kısıtlamalar geçerlidir:

  • Bunlar yalnızca kullanıcı ve grup izinlerinde ayarlanabilir.
  • Saat gelecekte olmalıdır.
  • Zaman, gelecekte bir yıldan fazla olamaz.
teamDrivePermissionDetails[]
(deprecated)

object

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

string

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

string

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

string

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

boolean

Kullanımdan kaldı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 beklemedeki bir sahip olup olmadığı. Yalnızca ortak Drive'da olmayan dosyalara yönelik 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

 Bir izni yama semantiğiyle günceller.