REST Resource: permissions

Kaynak: İzin

Bir dosyanın izni. İzinler, bir kullanıcıya, gruba, alana veya herkese bir dosyaya ya da klasör hiyerarşisine erişim olanağı tanır. Daha fazla bilgi için Dosya, klasör ve sürücü paylaşma başlıklı makaleyi inceleyin.

Varsayılan olarak, izin istekleri yalnızca alanların bir alt kümesini döndürür. kind, ID, �� ve role izinleri her zaman döndürülür.type Belirli alanları almak için Belirli alanları döndürme başlıklı makaleye bakın.

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

JSON gösterimi 
{
  "permissionDetails": [
    {
      "permissionType": string,
      "inheritedFrom": string,
      "role": string,
      "inherited": boolean
    }
  ],
  "teamDrivePermissionDetails": [
    {
      "teamDrivePermissionType": string,
      "inheritedFrom": string,
      "role": string,
      "inherited": boolean
    }
  ],
  "id": string,
  "displayName": string,
  "type": string,
  "kind": string,
  "photoLink": string,
  "emailAddress": string,
  "role": string,
  "allowFileDiscovery": boolean,
  "domain": string,
  "expirationTime": string,
  "deleted": boolean,
  "view": string,
  "pendingOwner": boolean,
  "inheritedPermissionsDisabled": boolean
}
Alanlar
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ü. Desteklenen değerler:

  • file
  • member
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[].role

string

Yalnızca çıkış. Bu kullanıcının birincil rolü. Desteklenen değerler:

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

Daha fazla bilgi için Roller ve izinler başlıklı makaleyi inceleyin.
permissionDetails[].inherited

boolean

Yalnızca çıkış. Bu iznin devralınıp devralınmadığı. Bu alan her zaman doldurulur. Bu, yalnızca çıkış alanıdır.
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.
id

string

Yalnızca çıkış. Bu iznin kimliği. Bu, izni verene ait benzersiz bir tanımlayıcıdır ve Kullanıcı kaynağında permissionId olarak yayınlanır. Kimlikler opak değerler olarak kabul edilmelidir.
displayName

string

Yalnızca çıkış. İzin değerinin "takma 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ımlanan tam adı (ör. "Deniz A.")
  • group: Google Grubu'nun adı (ör."Şirket Yöneticileri")
  • domain: "cymbalgroup.com" gibi dize alan adı.
  • anyone: displayName mevcut değil.
type

string

İzin verilenin türü. Desteklenen değerler:

  • user
  • group
  • domain
  • anyone

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

string

Yalnızca çıkış. Bunun ne tür bir kaynak olduğunu tanımlar. Değer: Sabit dize "drive#permission".
emailAddress

string

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

string

Bu izinle verilen rol. Desteklenen değerler:

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

Daha fazla bilgi için Roller ve izinler başlıklı makaleyi inceleyin.
allowFileDiscovery

boolean

İznin, dosyanın arama yoluyla bulunabilmesini sağlayıp sağlamadığı bilgisi. 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 geçerlilik süresinin dolacağı zaman (RFC 3339 tarih-saat). Son kullanma süreleriyle ilgili aşağıdaki kısıtlamalar geçerlidir:

  • Yalnızca kullanıcı ve grup izinlerinde ayarlanabilirler.
  • Zaman gelecekte olmalıdır.
  • Zaman, bir yıldan fazla gelecekte olamaz.
deleted

boolean

Yalnızca çıkış. Bu izinle ilişkili hesabın silinip silinmediği. Bu alan yalnızca user veya group türündeki izinlerle ilgilidir.
view

string

Bu iznin görünümünü belirtir. Yalnızca bir görünüme ait izinler için doldurulur.

Yalnızca published ve metadata değerleri desteklenir:

  • published: İznin rolü publishedReader.
  • metadata: Öğe, sınırlı erişime sahip olduğu ve kapsamın üst öğeye en azından okuma erişimi olduğu için yalnızca metadata görünümünde görünür. metadata görünümü yalnızca klasörlerde desteklenir.

Daha fazla bilgi için Görüntülemeler başlıklı makaleyi inceleyin.
pendingOwner

boolean

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

boolean

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

Yöntemler

create

 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

 Yama semantiğiyle bir izni günceller.