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.

İzin istekleri varsayılan olarak yalnızca alanların bir alt kümesini döndürür. İzin türü, kimliği, türü ve rolü her zaman döndürülür. Belirli alanları almak için https://developers.google.com/drive/api/guides/fields-parameter adresine bakın.

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,
  "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,
  "inheritedPermissionsDisabled": boolean
}
Alanlar
id

string

Yalnızca çıkış. Bu iznin kimliği. Bu, izin verilen kullanıcıya ait benzersiz bir tanımlayıcıdır ve kullanıcı kaynakları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."Cem Yılmaz")
  • group: Google Grubu'nun adı (ör. "Şirket Yöneticileri").
  • domain: "şirket.com" gibi dize alan adı
  • anyone: displayName yok.
type

string

Hak sahibinin türü. Geçerli değerler şunlardır:

  • user
  • group
  • domain
  • anyone

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

string

Yalnızca çıkış. Bu kaynağın ne tür olduğunu tanımlar. Değer: "drive#permission" sabit dizesi.
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ğıdakiler kullanılabilir:

  • 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ü. Gelecekte yeni değerler eklenebilecek olsa da şu anda aşağıdaki değerler kullanılabilir:

  • owner
  • organizer
  • fileOrganizer
  • writer
  • commenter
  • reader
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.
emailAddress

string

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

string

Bu izinle verilen rol. Gelecekte yeni değerler desteklenebilecek olsa da şu anda aşağıdakilere izin verilir:

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

boolean

İznin, dosyanın arama yoluyla bulunmasını 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 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.
  • Zaman gelecekte olmalıdır.
  • Zaman, bir yıldan daha ileri bir tarih olamaz.
teamDrivePermissionDetails[]
(deprecated)

object

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

string

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

string

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

string

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

boolean

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

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

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.