Drive Service

Sürüş

Bu hizmet, komut dosyalarının Google Drive'da dosya ve klasör oluşturmasına, bulmasına ve değiştirmesine olanak tanır.

Komut dosyanız, varsayılan Cloud projesi yerine standart bir Cloud projesi kullanıyorsa Drive API'yi manuel olarak etkinleştirmeniz gerekir. Standart Cloud projenizde Drive API'yi etkinleştirin:

Drive API'yi etkinleştir

Aşağıdaki kod örneğinde, her bir dosyanın adının, kullanıcının Drive'ım klasörüne nasıl kaydedileceği gösterilmektedir:
// Logs the name of every file in the user's Drive.
var files = DriveApp.getFiles();
while (files.hasNext()) {
  var file = files.next();
  console.log(file.getName());
}

Sınıflar

AdKısa açıklama
AccessAçıkça erişim izni verilen bireysel kullanıcıların yanı sıra bir dosyaya veya klasöre erişebilen kullanıcı sınıflarını temsil eden bir enum.
DriveAppKomut dosyalarının Google Drive'da dosya ve klasör oluşturmasına, bulmasına ve değiştirmesine izin verir.
FileGoogle Drive'da bir dosya.
FileIteratorKomut dosyalarının potansiyel olarak büyük bir dosya koleksiyonunda iterasyon yapmasına olanak tanıyan bir iterasyon öğesi.
FolderGoogle Drive'daki bir klasör.
FolderIteratorKomut dosyalarının potansiyel olarak büyük bir klasör koleksiyonunda iterasyon yapmasına olanak tanıyan bir nesne.
PermissionAçıkça erişim verilen bireysel kullanıcıların yanı sıra bir dosyaya veya klasöre erişebilen kullanıcılara verilen izinleri temsil eden bir enum.
UserGoogle Drive'daki bir dosyayla ilişkilendirilmiş kullanıcılar.

Access

Özellikler

ÖzellikTürAçıklama
ANYONEEnumİnternetteki herkes bulabilir ve erişebilir.
ANYONE_WITH_LINKEnumBağlantıya sahip olan herkes erişebilir.
DOMAINEnumAlanınızdaki kullanıcılar bulabilir ve erişebilir.
DOMAIN_WITH_LINKEnumAlanınızda bağlantıya sahip olan kişiler erişebilir.
PRIVATEEnumYalnızca açıkça izin verilen kişiler erişebilir.

DriveApp

Özellikler

ÖzellikTürAçıklama
AccessAccessAçıkça erişim izni verilen bireysel kullanıcıların yanı sıra bir dosyaya veya klasöre erişebilen kullanıcı sınıflarını temsil eden bir enum.
PermissionPermissionAçıkça erişim verilen bireysel kullanıcıların yanı sıra bir dosyaya veya klasöre erişebilen kullanıcılara verilen izinleri temsil eden bir enum.

Yöntemler

YöntemDönüş türüKısa açıklama
continueFileIterator(continuationToken)FileIteratorÖnceki bir iterasyonun devam jetonundan yararlanarak dosya yinelemesini devam ettirir.
continueFolderIterator(continuationToken)FolderIteratorÖnceki bir yinelemeden devam jetonu kullanarak klasör yinelemesini devam ettirir.
createFile(blob)FileBelirli bir Blob rastgele veriden, kullanıcının Drive'ının kök dizininde bir dosya oluşturur.
createFile(name, content)FileKullanıcının Drive'ının kök dizininde, belirtilen ad ve içeriğe sahip bir metin dosyası oluşturur.
createFile(name, content, mimeType)FileKullanıcının Drive'ının kök dizininde belirtilen ada, içeriğe ve MIME türüne sahip bir dosya oluşturur.
createFolder(name)FolderKullanıcının Drive'ının kök dizininde belirtilen adla bir klasör oluşturur.
createShortcut(targetId)FileSağlanan Drive öğesi kimliğine kısayol oluşturur ve bu kimliği döndürür.
createShortcutForTargetIdAndResourceKey(targetId, targetResourceKey)FileSağlanan Drive öğesi kimliği ve kaynak anahtarı için kısayol oluşturur ve bu kısayolu döndürür.
enforceSingleParent(value)voidÖğe üst öğelerini etkileyen tüm çağrılar için forceSingleParent davranışını etkinleştirir veya devre dışı bırakır.
getFileById(id)FileVerilen kimliğe sahip dosyayı alır.
getFileByIdAndResourceKey(id, resourceKey)FileBelirtilen kimliğe ve kaynak anahtarına sahip dosyayı alır.
getFiles()FileIteratorKullanıcının Drive'ındaki tüm dosyaların bir koleksiyonunu alır.
getFilesByName(name)FileIteratorKullanıcının Drive'ında belirtilen ada sahip tüm dosyaların bir koleksiyonunu alır.
getFilesByType(mimeType)FileIteratorKullanıcının Drive'ında belirtilen MIME türüne sahip tüm dosyaların bir koleksiyonunu alır.
getFolderById(id)FolderBelirtilen kimliğe sahip klasörü alır.
getFolderByIdAndResourceKey(id, resourceKey)FolderBelirtilen kimliğe ve kaynak anahtarına sahip klasörü alır.
getFolders()FolderIteratorKullanıcının Drive'ındaki tüm klasörlerin bir koleksiyonunu alır.
getFoldersByName(name)FolderIteratorKullanıcının Drive'ında belirtilen ada sahip tüm klasörlerin koleksiyonunu alır.
getRootFolder()FolderKullanıcının Drive'ının kök dizinindeki klasörü alır.
getStorageLimit()IntegerKullanıcının Drive'da depolamasına izin verilen bayt sayısını alır.
getStorageUsed()IntegerKullanıcının Drive'da depoladığı bayt sayısını alır.
getTrashedFiles()FileIteratorKullanıcının Drive'ının çöp kutusundaki tüm dosyaların bir koleksiyonunu alır.
getTrashedFolders()FolderIteratorKullanıcının Drive'ının çöp kutusundaki tüm klasörlerin bir koleksiyonunu alır.
searchFiles(params)FileIteratorKullanıcının Drive'ında belirtilen arama ölçütleriyle eşleşen tüm dosyaların bir koleksiyonunu alır.
searchFolders(params)FolderIteratorKullanıcının Drive'ında belirtilen arama ölçütleriyle eşleşen tüm klasörlerin koleksiyonunu alır.

File

Yöntemler

YöntemDönüş türüKısa açıklama
addCommenter(emailAddress)FileBelirtilen kullanıcıyı File için yorum yapanlar listesine ekleyin.
addCommenter(user)FileBelirtilen kullanıcıyı File için yorum yapanlar listesine ekleyin.
addCommenters(emailAddresses)FileBelirtilen kullanıcı dizisini, File için yorum yapanlar listesine ekleyin.
addEditor(emailAddress)FileKullanıcıyı File düzenleyici listesine ekler.
addEditor(user)FileKullanıcıyı File düzenleyici listesine ekler.
addEditors(emailAddresses)FileBelirtilen kullanıcı dizisini, File düzenleyicisi listesine ekler.
addViewer(emailAddress)FileKullanıcıyı File öğesini görüntüleyenler listesine ekler.
addViewer(user)FileKullanıcıyı File öğesini görüntüleyenler listesine ekler.
addViewers(emailAddresses)FileBelirtilen kullanıcı dizisini, File için görüntüleyen listesine ekler.
getAccess(email)PermissionBelirli bir kullanıcıya verilen izni alır.
getAccess(user)PermissionBelirli bir kullanıcıya verilen izni alır.
getAs(contentType)BlobBu nesnenin içindeki verileri, belirtilen içerik türüne dönüştürülmüş bir blob olarak döndürün.
getBlob()BlobBu nesnenin içindeki verileri blob olarak döndürün.
getDateCreated()DateFile öğesinin oluşturulduğu tarihi alır.
getDescription()StringFile öğesinin açıklamasını alır.
getDownloadUrl()StringDosyayı indirmek için kullanılabilecek URL'yi alır.
getEditors()User[]Bu File için düzenleyenlerin listesini alır.
getId()StringFile kimliğini alır.
getLastUpdated()DateFile öğesinin son güncellendiği tarihi alır.
getMimeType()StringDosyanın MIME türünü alır.
getName()StringFile öğesinin adını alır.
getOwner()UserDosya sahibini getirir.
getParents()FolderIteratorFile öğesinin doğrudan üst öğeleri olan klasör koleksiyonunu alır.
getResourceKey()StringBir bağlantı kullanılarak paylaşılan öğelere erişmek için gerekli olan File öğesinin kaynak anahtarını alır.
getSecurityUpdateEligible()BooleanBu File cihazının, bir bağlantı kullanılarak paylaşıldığında erişim için kaynak anahtarı gerektiren güvenlik güncellemesini uygulamaya uygun olup olmadığını alır.
getSecurityUpdateEnabled()BooleanBu File öğesinin bir bağlantı kullanılarak paylaşıldığında erişim için kaynak anahtarı gerektirip gerektirmediğini belirtir.
getSharingAccess()AccessAçıkça erişim izni verilen bireysel kullanıcıların yanı sıra hangi kullanıcı sınıflarının File öğesine erişebileceğini belirtir.
getSharingPermission()PermissionAçıkça erişim verilen bireysel kullanıcıların yanı sıra File erişimi olan kullanıcılara da verilen izni alır.
getSize()IntegerFile öğesini Drive'da depolamak için kullanılan bayt sayısını alır.
getTargetId()StringBu bir Kısayol ise yönlendirdiği öğenin kimliğini döndürür.
getTargetMimeType()StringBu bir Kısayol ise işaret ettiği öğenin MIME türünü döndürür.
getTargetResourceKey()StringDosya bir kısayolsa, yönlendirdiği öğenin kaynak anahtarını döndürür.
getThumbnail()BlobDosya için bir küçük resim alır veya küçük resim yoksa null.
getUrl()StringFile öğesini Drive veya Dokümanlar gibi bir Google uygulamasında açmak için kullanılabilecek URL'yi alır.
getViewers()User[]Bu File için görüntüleyenlerin ve yorum yapanların listesini alır.
isShareableByEditors()BooleanFile üzerinde düzenleme izinlerine sahip olan kullanıcıların diğer kullanıcılarla paylaşımda bulunmasına veya izinleri değiştirmesine izin verilip verilmeyeceğini belirler.
isStarred()BooleanFile öğesinin, kullanıcının Drive'ında yıldızlı olup olmadığını belirler.
isTrashed()BooleanFile öğesinin, kullanıcının Drive'ının çöp kutusunda olup olmadığını belirler.
makeCopy()FileDosyanın bir kopyasını oluşturur.
makeCopy(destination)FileHedef dizinde dosyanın bir kopyasını oluşturur.
makeCopy(name)FileDosyanın bir kopyasını oluşturur ve verilen adla adlandırır.
makeCopy(name, destination)FileHedef dizinde dosyanın bir kopyasını oluşturur ve verilen adla adlandırır.
moveTo(destination)FileBu öğeyi sağlanan hedef klasöre taşır.
removeCommenter(emailAddress)Fileİlgili kullanıcıyı File için yorum yapanlar listesinden kaldırır.
removeCommenter(user)Fileİlgili kullanıcıyı File için yorum yapanlar listesinden kaldırır.
removeEditor(emailAddress)FileKullanıcıyı, File düzenleyici listesinden kaldırır.
removeEditor(user)FileKullanıcıyı, File düzenleyici listesinden kaldırır.
removeViewer(emailAddress)Fileİlgili kullanıcıyı, File için görüntüleyenler ve yorum yapanlar listesinden kaldırır.
removeViewer(user)Fileİlgili kullanıcıyı, File için görüntüleyenler ve yorum yapanlar listesinden kaldırır.
revokePermissions(emailAddress)FileBelirtilen kullanıcıya verilen File erişimini iptal eder.
revokePermissions(user)FileBelirtilen kullanıcıya verilen File erişimini iptal eder.
setContent(content)FileBelirtilen bir yenisiyle dosya içeriğinin üzerine yazılır.
setDescription(description)FileFile öğesinin açıklamasını ayarlar.
setName(name)FileFile öğesinin adını belirler.
setOwner(emailAddress)FileFile öğesinin sahibini değiştirir.
setOwner(user)FileFile öğesinin sahibini değiştirir.
setSecurityUpdateEnabled(enabled)FileFile bir bağlantı kullanılarak paylaşıldığında erişim için kaynak anahtarı gerektirip gerektirmediğini belirler.
setShareableByEditors(shareable)FileFile üzerinde düzenleme izinlerine sahip olan kullanıcıların diğer kullanıcılarla paylaşımda bulunmasına veya izinleri değiştirmesine izin verilip verilmeyeceğini belirler.
setSharing(accessType, permissionType)FileAçıkça erişim verilen bireysel kullanıcıların yanı sıra hangi kullanıcı sınıflarının File ürününe erişebileceğini ve bu kullanıcılara hangi izinlerin verileceğini belirler.
setStarred(starred)FileFile öğesinin, kullanıcının Drive'ında yıldızlı olup olmadığını belirler.
setTrashed(trashed)FileFile öğesinin, kullanıcının Drive'ının çöp kutusunda olup olmadığını belirler.

FileIterator

Yöntemler

YöntemDönüş türüKısa açıklama
getContinuationToken()StringBu yinelemeyi daha sonra devam ettirmek için kullanılabilecek bir jeton alır.
hasNext()Booleannext() çağrısının bir öğeyi döndürüp döndürmeyeceğini belirler.
next()FileDosya veya klasör koleksiyonundaki sonraki öğeyi alır.

Folder

Yöntemler

YöntemDönüş türüKısa açıklama
addEditor(emailAddress)FolderKullanıcıyı Folder düzenleyici listesine ekler.
addEditor(user)FolderKullanıcıyı Folder düzenleyici listesine ekler.
addEditors(emailAddresses)FolderBelirtilen kullanıcı dizisini, Folder düzenleyicisi listesine ekler.
addViewer(emailAddress)FolderKullanıcıyı Folder öğesini görüntüleyenler listesine ekler.
addViewer(user)FolderKullanıcıyı Folder öğesini görüntüleyenler listesine ekler.
addViewers(emailAddresses)FolderBelirtilen kullanıcı dizisini, Folder için görüntüleyen listesine ekler.
createFile(blob)FileBelirli bir Blob rastgele veriden geçerli klasörde bir dosya oluşturur.
createFile(name, content)FileGeçerli klasörde belirtilen ad ve içeriklerle bir metin dosyası oluşturur.
createFile(name, content, mimeType)FileGeçerli klasörde belirtilen ada, içeriğe ve MIME türüne sahip bir dosya oluşturur.
createFolder(name)FolderGeçerli klasörde belirtilen adla bir klasör oluşturur.
createShortcut(targetId)FileSağlanan Drive öğesi kimliğine kısayol oluşturur ve bu kimliği döndürür.
createShortcutForTargetIdAndResourceKey(targetId, targetResourceKey)FileSağlanan Drive öğesi kimliği ve kaynak anahtarı için kısayol oluşturur ve bu kısayolu döndürür.
getAccess(email)PermissionBelirli bir kullanıcıya verilen izni alır.
getAccess(user)PermissionBelirli bir kullanıcıya verilen izni alır.
getDateCreated()DateFolder öğesinin oluşturulduğu tarihi alır.
getDescription()StringFolder öğesinin açıklamasını alır.
getEditors()User[]Bu Folder için düzenleyenlerin listesini alır.
getFiles()FileIteratorGeçerli klasörün alt öğeleri olan tüm dosyaların bir koleksiyonunu alır.
getFilesByName(name)FileIteratorGeçerli klasörün alt öğeleri olan ve belirtilen ada sahip olan tüm dosyaların bir koleksiyonunu alır.
getFilesByType(mimeType)FileIteratorGeçerli klasörün alt öğeleri olan ve belirtilen MIME türüne sahip tüm dosyaların bir koleksiyonunu alır.
getFolders()FolderIteratorGeçerli klasörün alt öğeleri olan tüm klasörlerin bir koleksiyonunu alır.
getFoldersByName(name)FolderIteratorGeçerli klasörün alt öğeleri olan ve belirtilen ada sahip olan tüm klasörlerin bir koleksiyonunu alır.
getId()StringFolder kimliğini alır.
getLastUpdated()DateFolder öğesinin son güncellendiği tarihi alır.
getName()StringFolder öğesinin adını alır.
getOwner()UserBu Folder öğesinin sahibini alır.
getParents()FolderIteratorFolder öğesinin doğrudan üst öğeleri olan klasör koleksiyonunu alır.
getResourceKey()StringBir bağlantı kullanılarak paylaşılan öğelere erişmek için gerekli olan Folder öğesinin kaynak anahtarını alır.
getSecurityUpdateEligible()BooleanBu Folder cihazının, bir bağlantı kullanılarak paylaşıldığında erişim için kaynak anahtarı gerektiren güvenlik güncellemesini uygulamaya uygun olup olmadığını alır.
getSecurityUpdateEnabled()BooleanBu Folder öğesinin bir bağlantı kullanılarak paylaşıldığında erişim için kaynak anahtarı gerektirip gerektirmediğini belirtir.
getSharingAccess()AccessAçıkça erişim izni verilen bireysel kullanıcıların yanı sıra hangi kullanıcı sınıflarının Folder öğesine erişebileceğini belirtir.
getSharingPermission()PermissionAçıkça erişim verilen bireysel kullanıcıların yanı sıra Folder erişimi olan kullanıcılara da verilen izni alır.
getSize()IntegerFolder öğesini Drive'da depolamak için kullanılan bayt sayısını alır.
getUrl()StringFolder öğesini Drive veya Dokümanlar gibi bir Google uygulamasında açmak için kullanılabilecek URL'yi alır.
getViewers()User[]Bu Folder için görüntüleyenlerin ve yorum yapanların listesini alır.
isShareableByEditors()BooleanFolder üzerinde düzenleme izinlerine sahip olan kullanıcıların diğer kullanıcılarla paylaşımda bulunmasına veya izinleri değiştirmesine izin verilip verilmeyeceğini belirler.
isStarred()BooleanFolder öğesinin, kullanıcının Drive'ında yıldızlı olup olmadığını belirler.
isTrashed()BooleanFolder öğesinin, kullanıcının Drive'ının çöp kutusunda olup olmadığını belirler.
moveTo(destination)FolderBu öğeyi sağlanan hedef klasöre taşır.
removeEditor(emailAddress)FolderKullanıcıyı, Folder düzenleyici listesinden kaldırır.
removeEditor(user)FolderKullanıcıyı, Folder düzenleyici listesinden kaldırır.
removeViewer(emailAddress)Folderİlgili kullanıcıyı, Folder için görüntüleyenler ve yorum yapanlar listesinden kaldırır.
removeViewer(user)Folderİlgili kullanıcıyı, Folder için görüntüleyenler ve yorum yapanlar listesinden kaldırır.
revokePermissions(emailAddress)FolderBelirtilen kullanıcıya verilen Folder erişimini iptal eder.
revokePermissions(user)FolderBelirtilen kullanıcıya verilen Folder erişimini iptal eder.
searchFiles(params)FileIteratorGeçerli klasörün alt öğeleri olan ve belirtilen arama ölçütleriyle eşleşen tüm dosyaların bir koleksiyonunu alır.
searchFolders(params)FolderIteratorGeçerli klasörün alt öğeleri olan ve belirtilen arama ölçütleriyle eşleşen tüm klasörlerin bir koleksiyonunu alır.
setDescription(description)FolderFolder öğesinin açıklamasını ayarlar.
setName(name)FolderFolder öğesinin adını belirler.
setOwner(emailAddress)FolderFolder öğesinin sahibini değiştirir.
setOwner(user)FolderFolder öğesinin sahibini değiştirir.
setSecurityUpdateEnabled(enabled)FolderFolder bir bağlantı kullanılarak paylaşıldığında erişim için kaynak anahtarı gerektirip gerektirmediğini belirler.
setShareableByEditors(shareable)FolderFolder üzerinde düzenleme izinlerine sahip olan kullanıcıların diğer kullanıcılarla paylaşımda bulunmasına veya izinleri değiştirmesine izin verilip verilmeyeceğini belirler.
setSharing(accessType, permissionType)FolderAçıkça erişim verilen bireysel kullanıcıların yanı sıra hangi kullanıcı sınıflarının Folder ürününe erişebileceğini ve bu kullanıcılara hangi izinlerin verileceğini belirler.
setStarred(starred)FolderFolder öğesinin, kullanıcının Drive'ında yıldızlı olup olmadığını belirler.
setTrashed(trashed)FolderFolder öğesinin, kullanıcının Drive'ının çöp kutusunda olup olmadığını belirler.

FolderIterator

Yöntemler

YöntemDönüş türüKısa açıklama
getContinuationToken()StringBu yinelemeyi daha sonra devam ettirmek için kullanılabilecek bir jeton alır.
hasNext()Booleannext() çağrısının bir öğeyi döndürüp döndürmeyeceğini belirler.
next()FolderDosya veya klasör koleksiyonundaki sonraki öğeyi alır.

Permission

Özellikler

ÖzellikTürAçıklama
VIEWEnumDosya veya klasöre erişebilen kullanıcılar dosyayı veya klasörü yalnızca görüntüleyebilir ya da kopyalayabilir.
EDITEnumDosya veya klasöre erişebilen kullanıcılar dosyayı veya klasöre erişimi düzenleyebilir.
COMMENTEnumDosya veya klasöre erişebilen kullanıcılar onu yalnızca görüntüleyebilir, kopyalayabilir veya üzerinde yorum yapabilir.
OWNEREnumDosyanın veya klasörün sahibi kullanıcı.
ORGANIZEREnumOrtak Drive içindeki dosya ve klasörleri düzenleyebilen kullanıcılardır.
FILE_ORGANIZEREnumOrtak Drive'da içerik düzenleyebilen, çöp kutusuna gönderebilen ve taşıyabilen kullanıcılar
NONEEnumKullanıcının dosya veya klasör için herhangi bir izni yok.

User

Yöntemler

YöntemDönüş türüKısa açıklama
getDomain()StringKullanıcının hesabıyla ilişkilendirilen alan adını alır.
getEmail()StringKullanıcının e-posta adresini alır.
getName()StringKullanıcının adını alır.
getPhotoUrl()StringKullanıcının fotoğrafının URL'sini alır.