REST Resource: drives

Kaynak: Drive

Ortak Drive'ı temsil eder.

Bazı kaynak yöntemleri (ör. drives.update) için driveId gerekir. Bir ortak Drive'ın kimliğini almak için drives.list yöntemini kullanın.

JSON gösterimi
{
  "id": string,
  "name": string,
  "colorRgb": string,
  "kind": string,
  "backgroundImageLink": string,
  "capabilities": {
    "canAddChildren": boolean,
    "canComment": boolean,
    "canCopy": boolean,
    "canDeleteDrive": boolean,
    "canDownload": boolean,
    "canEdit": boolean,
    "canListChildren": boolean,
    "canManageMembers": boolean,
    "canReadRevisions": boolean,
    "canRename": boolean,
    "canRenameDrive": boolean,
    "canChangeDriveBackground": boolean,
    "canShare": boolean,
    "canChangeCopyRequiresWriterPermissionRestriction": boolean,
    "canChangeDomainUsersOnlyRestriction": boolean,
    "canChangeDriveMembersOnlyRestriction": boolean,
    "canChangeSharingFoldersRequiresOrganizerPermissionRestriction": boolean,
    "canResetDriveRestrictions": boolean,
    "canDeleteChildren": boolean,
    "canTrashChildren": boolean
  },
  "themeId": string,
  "backgroundImageFile": {
    "id": string,
    "xCoordinate": number,
    "yCoordinate": number,
    "width": number
  },
  "createdTime": string,
  "hidden": boolean,
  "restrictions": {
    "copyRequiresWriterPermission": boolean,
    "domainUsersOnly": boolean,
    "driveMembersOnly": boolean,
    "adminManagedRestrictions": boolean,
    "sharingFoldersRequiresOrganizerPermission": boolean
  },
  "orgUnitId": string
}
Alanlar
id

string

Yalnızca çıkış. Bu ortak Drive'ın kimliği. Aynı zamanda bu ortak Drive'ın üst düzey klasörünün kimliğidir.

name

string

Bu ortak Drive'ın adı.

colorRgb

string

Bu ortak Drive'ın RGB onaltılık dizesi olarak rengi. Yalnızca themeId ayarını yapmayan bir drive.drives.update isteğinde ayarlanabilir.

kind

string

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

capabilities

object

Yalnızca çıkış. Geçerli kullanıcının bu ortak Drive'da sahip olduğu özellikler.

capabilities.canAddChildren

boolean

Yalnızca çıkış. Geçerli kullanıcının bu ortak Drive'daki klasörlere çocuk ekleyip ekleyemeyeceğini belirtir.

capabilities.canComment

boolean

Yalnızca çıkış. Geçerli kullanıcının bu ortak drive'daki dosyalara yorum yapıp yapamayacağı.

capabilities.canCopy

boolean

Yalnızca çıkış. Geçerli kullanıcının bu ortak Drive'daki dosyaları kopyalayıp kopyalayamayacağı.

capabilities.canDeleteDrive

boolean

Yalnızca çıkış. Geçerli kullanıcının bu ortak Drive'ı silip silemeyeceği. Ortak Drive içinde çöp kutusuna gönderilmemiş öğeler varsa ortak Drive'ı silme girişimi yine de başarısız olabilir.

capabilities.canDownload

boolean

Yalnızca çıkış. Geçerli kullanıcının bu ortak Drive'daki dosyaları indirip indiremeyeceği.

capabilities.canEdit

boolean

Yalnızca çıkış. Geçerli kullanıcının bu ortak drive'daki dosyaları düzenleyip düzenleyemeyeceği

capabilities.canListChildren

boolean

Yalnızca çıkış. Geçerli kullanıcının bu ortak Drive'daki klasörlerin alt öğelerini listeleyip listeleyemeyeceğini belirtir.

capabilities.canManageMembers

boolean

Yalnızca çıkış. Geçerli kullanıcının bu ortak Drive'a üye ekleyip ekleyemeyeceği, üye kaldırıp kaldıramayacağı veya rolünü değiştirip değiştiremeyeceği.

capabilities.canReadRevisions

boolean

Yalnızca çıkış. Geçerli kullanıcının bu ortak Drive'daki dosyaların düzeltme kaynağını okuyup okuyamayacağını belirtir.

capabilities.canRename

boolean

Yalnızca çıkış. Geçerli kullanıcının bu ortak Drive'daki dosyaları veya klasörleri yeniden adlandırıp yeniden adlandıramayacağını belirtir.

capabilities.canRenameDrive

boolean

Yalnızca çıkış. Geçerli kullanıcının bu ortak Drive'ı yeniden adlandırıp yeniden adlandıramayacağını belirtir.

capabilities.canChangeDriveBackground

boolean

Yalnızca çıkış. Geçerli kullanıcının bu ortak Drive'ın arka planını değiştirip değiştiremeyeceğini belirtir.

capabilities.canShare

boolean

Yalnızca çıkış. Geçerli kullanıcının bu ortak Drive'da dosya veya klasör paylaşıp paylaşamayacağını belirtir.

capabilities.canChangeCopyRequiresWriterPermissionRestriction

boolean

Yalnızca çıkış. Geçerli kullanıcının bu ortak Drive'a ait copyRequiresWriterPermission kısıtlamasını değiştirip değiştiremeyeceği.

capabilities.canChangeDomainUsersOnlyRestriction

boolean

Yalnızca çıkış. Geçerli kullanıcının bu ortak Drive'a ait domainUsersOnly kısıtlamasını değiştirip değiştiremeyeceği.

capabilities.canChangeDriveMembersOnlyRestriction

boolean

Yalnızca çıkış. Geçerli kullanıcının bu ortak Drive'a ait driveMembersOnly kısıtlamasını değiştirip değiştiremeyeceği.

capabilities.canChangeSharingFoldersRequiresOrganizerPermissionRestriction

boolean

Yalnızca çıkış. Geçerli kullanıcının bu ortak Drive'a ait sharingFoldersRequiresOrganizerPermission kısıtlamasını değiştirip değiştiremeyeceği.

capabilities.canResetDriveRestrictions

boolean

Yalnızca çıkış. Geçerli kullanıcının ortak Drive kısıtlamalarını varsayılanlara sıfırlayıp sıfırlayamayacağı.

capabilities.canDeleteChildren

boolean

Yalnızca çıkış. Geçerli kullanıcının bu ortak Drive'daki klasörlerden çocukları silip silemeyeceği.

capabilities.canTrashChildren

boolean

Yalnızca çıkış. Geçerli kullanıcının bu ortak Drive'daki klasörlerde bulunan alt öğeleri çöp kutusuna taşıyıp taşıyamayacağı.

themeId

string

Arka plan resminin ve renginin ayarlandığı temanın kimliği. Olası driveThemes kümesi, bir drive.about.get yanıtından alınabilir. Bir drive.drives.create isteğinde belirtilmediğinde, arka plan resminin ve renginin ayarlandığı rastgele bir tema seçilir. Bu, salt okunur bir alandır; yalnızca colorRgb veya backgroundImageFile ayarlanmayan isteklerde ayarlanabilir.

backgroundImageFile

object

Bu ortak Drive için arka plan resminin ayarlandığı bir resim dosyası ve kırpma parametreleri. Bu, salt okunur bir alandır; yalnızca themeId ayarlaması yapılmayan drive.drives.update isteklerinde ayarlanabilir. Belirtildiğinde, backgroundImageFile öğesinin tüm alanları ayarlanmalıdır.

backgroundImageFile.id

string

Arka plan resmi için kullanılacak resim dosyasının Google Drive'daki kimliği.

backgroundImageFile.xCoordinate

number

Arka plan resminde kırpma alanının sol üst köşesinin X koordinatı. Bu, 0 ile 1 arasındaki kapalı aralıkta bir değerdir. Bu değer, tüm resmin sol tarafından kırpma alanının sol tarafına doğru olan yatay mesafenin tüm resmin genişliğine bölünmesiyle elde edilir.

backgroundImageFile.yCoordinate

number

Arka plan resminde kırpma alanının sol üst köşesinin Y koordinatı. Bu, 0 ile 1 arasındaki kapalı aralıkta bir değerdir. Bu değer, tüm resmin üst tarafından kırpma alanının üst tarafına dikey mesafenin tüm resmin yüksekliğine bölünmesiyle elde edilir.

backgroundImageFile.width

number

0 ile 1 arasında kapalı aralıktaki kırpılmış resmin genişliği. Bu değer, kırpılan resmin genişliğinin, tüm resmin genişliğine bölünmesiyle elde edilir. Yükseklik, 80'e 9'luk bir genişlik-yükseklik en boy oranı uygulanarak hesaplanır. Oluşturulan resim en az 1280 piksel genişliğinde ve 144 piksel yüksekliğinde olmalıdır.

createdTime

string

Yalnızca çıkış. Ortak Drive'ın oluşturulduğu saat (RFC 3339 tarih/saat).

hidden

boolean

Ortak Drive'ın varsayılan görünümde gizlenip gizlenmediği.

restrictions

object

Bu ortak Drive veya bu ortak Drive'daki öğeler için geçerli olan bir dizi kısıtlama. Ortak Drive oluştururken kısıtlamaların ayarlanamayacağını unutmayın. Kısıtlama eklemek için önce ortak Drive oluşturun. Ardından drives.update kullanarak kısıtlama ekleyin.

restrictions.copyRequiresWriterPermission

boolean

Bu ortak Drive'daki dosyaları kopyalama, yazdırma veya indirme seçeneklerinin okuyucular ve yorumcular için devre dışı bırakılıp bırakılmayacağı. Bu kısıtlama true olarak ayarlanırsa, bu ortak Drive'daki tüm dosyalarda benzer şekilde adlandırılmış alan true olarak geçersiz kılınır.

restrictions.domainUsersOnly

boolean

Bu ortak Drive'a ve bu ortak Drive'daki öğelere erişimin, bu ortak Drive'ın ait olduğu alandaki kullanıcılarla kısıtlı olup olmadığı. Bu kısıtlama, bu ortak Drive'ın dışında denetlenen diğer paylaşım politikaları tarafından geçersiz kılınabilir.

restrictions.driveMembersOnly

boolean

Bu ortak Drive'daki öğelere erişimin, ortak Drive'ın üyeleriyle kısıtlı olup olmadığı.

restrictions.adminManagedRestrictions

boolean

Kısıtlamaları değiştirmek için bu ortak Drive'da yönetici ayrıcalıklarının gerekip gerekmediği.

restrictions.sharingFoldersRequiresOrganizerPermission

boolean

Değer true ise yalnızca düzenleyen rolüne sahip kullanıcılar klasörleri paylaşabilir. Politika, yanlış değerine ayarlanırsa düzenleyen rolüne veya dosyayı düzenleyen rolüne sahip kullanıcılar klasörleri paylaşabilir.

orgUnitId

string

Yalnızca çıkış. Bu ortak Drive'ın kuruluş birimi. Bu alan yalnızca useDomainAdminAccess parametresi true olarak ayarlandığında drives.list yanıtlarında doldurulur.

Yöntemler

create

Ortak Drive oluşturur.

delete

Kullanıcının organizer olduğu bir ortak Drive kalıcı olarak silinir.

get

Ortak Drive'ın meta verilerini kimliğe göre alır.

hide

Bir ortak drive'ı varsayılan görünümde gizler.

list

Kullanıcının ortak Drive'larını listeler.

unhide

Bir ortak Drive'ı varsayılan görünüme geri yükler.

update

Bir ortak Drive'ın meta verilerini günceller.