Drive Service

Drive

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ızda varsayılan Cloud projesi yerine standart bir Cloud projesi kullanılıyorsa Drive API'yi manuel olarak açmanız gerekir. Standart Cloud projenizde Drive API'yi etkinleştirin:

Drive API'yi etkinleştirme

Aşağıdaki kod örneğinde, kullanıcının Drive'ım klasöründeki her dosyanın adının nasıl günlüğe 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
AccessBelirli bir dosyaya veya klasöre erişimi açıkça verilmiş kullanıcıların yanı sıra dosyaya ya da 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'daki bir dosya.
FileIteratorKomut dosyalarının büyük olasılıkla büyük bir dosya koleksiyonunda iterasyon yapmasına olanak tanıyan bir iteratör.
FolderGoogle Drive'daki bir klasör.
FolderIteratorKomut dosyalarının büyük olasılıkla büyük bir klasör koleksiyonunda iterasyon yapmasına olanak tanıyan bir nesne.
PermissionAçıkça erişim izni verilen 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ı.

Access

Özellikler

MülkTü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

MülkTürAçıklama
AccessAccessBelirli bir dosyaya veya klasöre erişimi açıkça verilmiş kullanıcıların yanı sıra dosyaya ya da klasöre erişebilen kullanıcı sınıflarını temsil eden bir enum.
PermissionPermissionAçıkça erişim izni verilen 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 iteratörden alınan devam ettirme jetonunu kullanarak dosya iterasyonunu devam ettirir.
continueFolderIterator(continuationToken)FolderIteratorÖnceki bir iteratörden alınan bir devam ettirme jetonunu kullanarak klasör iterasyonunu devam ettirir.
createFile(blob)FileBelirli bir Blob rastgele verisinden kullanıcının Drive'ının kökünde bir dosya oluşturur.
createFile(name, content)FileKullanıcının Drive'ının kökünde, belirtilen adı ve içeriği içeren bir metin dosyası oluşturur.
createFile(name, content, mimeType)FileKullanıcının Drive'ının kökünde, belirtilen adı, içeriği ve MIME türünü içeren bir dosya oluşturur.
createFolder(name)FolderKullanıcının Drive'ının kökünde, belirtilen ada sahip bir klasör oluşturur.
createShortcut(targetId)FileSağlanan Drive öğe kimliğinin kısayolunu oluşturur ve döndürür.
createShortcutForTargetIdAndResourceKey(targetId, targetResourceKey)FileSağlanan Drive öğe kimliğinin ve kaynak anahtarının kısayolunu oluşturup döndürür.
enforceSingleParent(value)voidÖğe ebeveynlerini etkileyen tüm çağrılar için enforceSingleParent davranışını etkinleştirir veya devre dışı bırakır.
getFileById(id)FileBelirtilen 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 koleksiyonunu alır.
getFilesByName(name)FileIteratorKullanıcının Drive'ındaki, belirtilen ada sahip tüm dosyaların koleksiyonunu alır.
getFilesByType(mimeType)FileIteratorKullanıcının Drive'ındaki belirli bir MIME türüne sahip tüm dosyaların koleksiyonunu alır.
getFolderById(id)FolderBelirtilen kimliğe sahip klasörü alır.
getFolderByIdAndResourceKey(id, resourceKey)FolderBelirtilen kimlik ve kaynak anahtarına sahip klasörü alır.
getFolders()FolderIteratorKullanıcının Drive'ındaki tüm klasörlerin koleksiyonunu alır.
getFoldersByName(name)FolderIteratorKullanıcının Drive'ındaki, belirtilen ada sahip tüm klasörlerin koleksiyonunu alır.
getRootFolder()FolderKullanıcının Drive'ının kökündeki klasörü alır.
getStorageLimit()IntegerKullanıcının Drive'da depolayabileceği bayt sayısını alır.
getStorageUsed()IntegerKullanıcının şu anda Drive'da depoladığı bayt sayısını alır.
getTrashedFiles()FileIteratorKullanıcının Drive'ındaki çöp kutusundaki tüm dosyaların koleksiyonunu alır.
getTrashedFolders()FolderIteratorKullanıcının Drive'ındaki çöp kutusundaki tüm klasörlerin koleksiyonunu alır.
searchFiles(params)FileIteratorKullanıcının Drive'ındaki, belirtilen arama ölçütleriyle eşleşen tüm dosyaların koleksiyonunu alır.
searchFolders(params)FolderIteratorKullanıcının Drive'ındaki, 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 yorumcu listesine ekleyin.
addCommenter(user)FileBelirtilen kullanıcıyı File için yorumcu listesine ekleyin.
addCommenters(emailAddresses)FileBelirtilen kullanıcı dizisini File için yorumcuların listesine ekleyin.
addEditor(emailAddress)FileBelirtilen kullanıcıyı File için düzenleyiciler listesine ekler.
addEditor(user)FileBelirtilen kullanıcıyı File için düzenleyiciler listesine ekler.
addEditors(emailAddresses)FileBelirtilen kullanıcı dizisini File için düzenleyiciler listesine ekler.
addViewer(emailAddress)FileBelirtilen kullanıcıyı File için izleyiciler listesine ekler.
addViewer(user)FileBelirtilen kullanıcıyı File için izleyiciler listesine ekler.
addViewers(emailAddresses)FileBelirtilen kullanıcı dizisini File için izleyici 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ürme.
getBlob()BlobBu nesnenin içindeki verileri bir blob olarak döndürme.
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 öğesinin 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()UserDosyanın sahibini alır.
getParents()FolderIteratorFile klasörünün doğrudan üst klasörlerini içeren bir koleksiyon alır.
getResourceKey()StringBağlantı kullanılarak paylaşılan öğelere erişmek için gereken File kaynağının anahtarını alır.
getSecurityUpdateEligible()BooleanBu File'nin, 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'ün, bağlantı kullanılarak paylaşıldığında erişim için kaynak anahtarı gerektirip gerektirmediğini alır.
getSharingAccess()AccessAçıkça erişim izni verilen kullanıcıların yanı sıra File'ye hangi kullanıcı sınıfının erişebileceğini alır.
getSharingPermission()PermissionAçıkça erişim izni verilen kullanıcıların yanı sıra File'e erişebilen kullanıcılara verilen izni alır.
getSize()IntegerFile öğesini Drive'da depolamak için kullanılan bayt sayısını alır.
getTargetId()StringBu bir kısayolsa işaret ettiği öğenin kimliğini döndürür.
getTargetMimeType()StringBu bir kısayolsa işaret ettiği öğenin MIME türünü döndürür.
getTargetResourceKey()StringDosya bir kısayolsa işaret ettiği öğenin kaynak anahtarını döndürür.
getThumbnail()BlobDosyanın küçük resmini alır veya küçük resim yoksa null değerini döndürür.
getUrl()StringFile dosyasını 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 yorumcuların listesini alır.
isShareableByEditors()BooleanFile için düzenleme izinlerine sahip kullanıcıların diğer kullanıcılarla paylaşma veya izinleri değiştirme izni olup olmadığını belirler.
isStarred()BooleanFile öğesinin kullanıcının Drive'ında yıldızla işaretlenip işaretlenmediğini belirler.
isTrashed()BooleanFile öğesinin, kullanıcının Drive'ındaki çöp kutusuna ait olup olmadığını belirler.
makeCopy()FileDosyanın bir kopyasını oluşturur.
makeCopy(destination)FileDosyanın hedef dizinde bir kopyasını oluşturur.
makeCopy(name)FileDosyanın bir kopyasını oluşturur ve dosyayı sağlanan adla adlandırır.
makeCopy(name, destination)FileHedef dizinde dosyanın bir kopyasını oluşturur ve dosyaya belirtilen adı verir.
moveTo(destination)FileBu öğeyi, belirtilen hedef klasöre taşır.
removeCommenter(emailAddress)FileBelirtilen kullanıcıyı File için yorumcu listesinden kaldırır.
removeCommenter(user)FileBelirtilen kullanıcıyı File için yorumcu listesinden kaldırır.
removeEditor(emailAddress)FileBelirtilen kullanıcıyı File için düzenleyenler listesinden kaldırır.
removeEditor(user)FileBelirtilen kullanıcıyı File için düzenleyenler listesinden kaldırır.
removeViewer(emailAddress)FileBelirtilen kullanıcıyı File için görüntüleyen ve yorum yapanlar listesinden kaldırır.
removeViewer(user)FileBelirtilen kullanıcıyı File için görüntüleyen ve yorum yapanlar listesinden kaldırır.
revokePermissions(emailAddress)FileBelirli bir kullanıcıya verilen File erişimini iptal eder.
revokePermissions(user)FileBelirli bir kullanıcıya verilen File erişimini iptal eder.
setContent(content)FileDosyanın içeriğinin üzerine belirli bir değiştirmeyle yazılır.
setDescription(description)FileFile öğesinin açıklamasını belirler.
setName(name)FileFile değerinin adını belirler.
setOwner(emailAddress)FileFile öğesinin sahibini değiştirir.
setOwner(user)FileFile öğesinin sahibini değiştirir.
setSecurityUpdateEnabled(enabled)FileFile'ün, bağlantı kullanılarak paylaşıldığında erişim için kaynak anahtarı gerektirip gerektirmeyeceğini belirler.
setShareableByEditors(shareable)FileFile için düzenleme izinlerine sahip kullanıcıların diğer kullanıcılarla paylaşma veya izinleri değiştirme izni olup olmadığını belirler.
setSharing(accessType, permissionType)FileAçıkça erişim izni verilen kullanıcıların yanı sıra File'ye hangi kullanıcı sınıfının 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ızla işaretlenip işaretlenmeyeceğini belirler.
setTrashed(trashed)FileFile öğesinin, kullanıcının Drive'ındaki çöp kutusuna ait olup olmadığını belirler.

FileIterator

Yöntemler

YöntemDönüş türüKısa açıklama
getContinuationToken()StringBu iterasyonu 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)FolderBelirtilen kullanıcıyı Folder için düzenleyiciler listesine ekler.
addEditor(user)FolderBelirtilen kullanıcıyı Folder için düzenleyiciler listesine ekler.
addEditors(emailAddresses)FolderBelirtilen kullanıcı dizisini Folder için düzenleyiciler listesine ekler.
addViewer(emailAddress)FolderBelirtilen kullanıcıyı Folder için izleyiciler listesine ekler.
addViewer(user)FolderBelirtilen kullanıcıyı Folder için izleyiciler listesine ekler.
addViewers(emailAddresses)FolderBelirtilen kullanıcı dizisini Folder için izleyici listesine ekler.
createFile(blob)FileBelirli bir Blob rastgele verisinden geçerli klasörde bir dosya oluşturur.
createFile(name, content)FileGeçerli klasörde, belirtilen ada ve içeriğe sahip 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 ada sahip bir klasör oluşturur.
createShortcut(targetId)FileSağlanan Drive öğe kimliğinin kısayolunu oluşturur ve döndürür.
createShortcutForTargetIdAndResourceKey(targetId, targetResourceKey)FileSağlanan Drive öğe kimliğinin ve kaynak anahtarının kısayolunu oluşturup 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 koleksiyonunu alır.
getFilesByName(name)FileIteratorMevcut klasörün alt öğeleri olan ve belirtilen ada sahip tüm dosyaların koleksiyonunu alır.
getFilesByType(mimeType)FileIteratorMevcut klasörün alt öğeleri olan ve belirtilen MIME türüne sahip tüm dosyaların koleksiyonunu alır.
getFolders()FolderIteratorGeçerli klasörün alt klasörlerinin tümünü içeren bir koleksiyon alır.
getFoldersByName(name)FolderIteratorMevcut klasörün alt öğeleri olan ve belirtilen ada sahip tüm klasörlerin koleksiyonunu alır.
getId()StringFolder öğesinin 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 klasörünün doğrudan üst klasörlerini içeren bir koleksiyon alır.
getResourceKey()StringBağlantı kullanılarak paylaşılan öğelere erişmek için gereken Folder kaynağının anahtarını alır.
getSecurityUpdateEligible()BooleanBu Folder'nin, 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'ün, bağlantı kullanılarak paylaşıldığında erişim için kaynak anahtarı gerektirip gerektirmediğini alır.
getSharingAccess()AccessAçıkça erişim izni verilen kullanıcıların yanı sıra Folder'ye hangi kullanıcı sınıfının erişebileceğini alır.
getSharingPermission()PermissionAçıkça erişim izni verilen kullanıcıların yanı sıra Folder'e erişebilen kullanıcılara verilen izni alır.
getSize()IntegerFolder öğesini Drive'da depolamak için kullanılan bayt sayısını alır.
getUrl()StringFolder dosyasını 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 yorumcuların listesini alır.
isShareableByEditors()BooleanFolder için düzenleme izinlerine sahip kullanıcıların diğer kullanıcılarla paylaşma veya izinleri değiştirme izni olup olmadığını belirler.
isStarred()BooleanFolder öğesinin kullanıcının Drive'ında yıldızla işaretlenip işaretlenmediğini belirler.
isTrashed()BooleanFolder öğesinin, kullanıcının Drive'ındaki çöp kutusuna ait olup olmadığını belirler.
moveTo(destination)FolderBu öğeyi, belirtilen hedef klasöre taşır.
removeEditor(emailAddress)FolderBelirtilen kullanıcıyı Folder için düzenleyenler listesinden kaldırır.
removeEditor(user)FolderBelirtilen kullanıcıyı Folder için düzenleyenler listesinden kaldırır.
removeViewer(emailAddress)FolderBelirtilen kullanıcıyı Folder için görüntüleyen ve yorum yapanlar listesinden kaldırır.
removeViewer(user)FolderBelirtilen kullanıcıyı Folder için görüntüleyen ve yorum yapanlar listesinden kaldırır.
revokePermissions(emailAddress)FolderBelirli bir kullanıcıya verilen Folder erişimini iptal eder.
revokePermissions(user)FolderBelirli bir 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 koleksiyonunu alır.
searchFolders(params)FolderIteratorGeçerli klasörün alt klasörü olan ve belirtilen arama ölçütleriyle eşleşen tüm klasörlerin koleksiyonunu alır.
setDescription(description)FolderFolder öğesinin açıklamasını belirler.
setName(name)FolderFolder değerinin adını belirler.
setOwner(emailAddress)FolderFolder öğesinin sahibini değiştirir.
setOwner(user)FolderFolder öğesinin sahibini değiştirir.
setSecurityUpdateEnabled(enabled)FolderFolder'ün, bağlantı kullanılarak paylaşıldığında erişim için kaynak anahtarı gerektirip gerektirmeyeceğini belirler.
setShareableByEditors(shareable)FolderFolder için düzenleme izinlerine sahip kullanıcıların diğer kullanıcılarla paylaşma veya izinleri değiştirme izni olup olmadığını belirler.
setSharing(accessType, permissionType)FolderAçıkça erişim izni verilen kullanıcıların yanı sıra Folder'ye hangi kullanıcı sınıfının 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ızla işaretlenip işaretlenmeyeceğini belirler.
setTrashed(trashed)FolderFolder öğesinin, kullanıcının Drive'ındaki çöp kutusuna ait olup olmadığını belirler.

FolderIterator

Yöntemler

YöntemDönüş türüKısa açıklama
getContinuationToken()StringBu iterasyonu 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

MülkTürAçıklama
VIEWEnumDosyaya veya klasöre erişebilen kullanıcılar dosyayı yalnızca görüntüleyebilir ya da kopyalayabilir.
EDITEnumDosyaya veya klasöre erişebilen kullanıcılar dosyayı düzenleyebilir.
COMMENTEnumDosyaya veya klasöre erişebilen kullanıcılar dosyayı yalnızca görüntüleyebilir, kopyalayabilir veya dosyaya yorum yapabilir.
OWNEREnumDosya veya klasörün sahibi kullanıcıdır.
ORGANIZEREnumOrtak Drive'daki dosya ve klasörleri düzenleyebilecek kullanıcılar.
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 izni yok.

User

Yöntemler

YöntemDönüş türüKısa açıklama
getDomain()StringKullanıcının hesabıyla ilişkili 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.