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
}
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

İzin 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 ortak Drive öğesindeki izinlerin devralınıp devralınmadığıyla ilgili ayrıntılar. Bu, yalnızca ortak Drive öğeleri için bulunan ve yalnızca çıkışa yönelik bir alandır.
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, yalnızca çıkış alanıdır.
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
  • 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 verilmektedir:

  • 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 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. Yalnızca "published" değeri desteklenir.
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.

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 semantikleriyle günceller.