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. Yerleşik Drive hizmetinin kullanımı daha kolay olsa da bazı sınırlamaları vardır. En güncel özellikler ve destekten yararlanmak, ortak Drive'lardaki dosya veya klasörlere erişmek için gelişmiş Drive hizmetini kullanın.

Komut dosyanızda varsayılan Cloud projesi yerine standart Cloud projesi kullanılıyorsa Drive API'yi manuel olarak etkinleştirmeniz 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
AccessBir dosyaya veya klasöre erişebilen kullanıcı sınıflarını temsil eden bir enum. Erişim izni açıkça verilen bireysel kullanıcılar bu sınıfa dahil değildir.
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 bir dosya koleksiyonunda yineleme yapmasına olanak tanıyan bir yineleyici.
FolderGoogle Drive'daki bir klasör.
FolderIteratorKomut dosyalarının, büyük bir klasör koleksiyonunda yineleme yapmasına olanak tanıyan bir nesne.
PermissionBir dosyaya veya klasöre erişebilen kullanıcılara verilen izinleri temsil eden bir enum. Bu enum, açıkça erişim verilen bireysel kullanıcıları kapsamaz.
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 bulunan ve 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
AccessAccessBir dosyaya veya klasöre erişebilen kullanıcı sınıflarını temsil eden bir enum. Erişim izni açıkça verilen bireysel kullanıcılar bu sınıfa dahil değildir.
PermissionPermissionBir dosyaya veya klasöre erişebilen kullanıcılara verilen izinleri temsil eden bir enum. Bu enum, açıkça erişim verilen bireysel kullanıcıları kapsamaz.

Yöntemler

YöntemDönüş türüKısa açıklama
continueFileIterator(continuationToken)FileIteratorÖnceki bir yineleyiciden alınan devam ettirme jetonunu kullanarak bir dosya yinelemesini devam ettirir.
continueFolderIterator(continuationToken)FolderIteratorÖnceki yineleyiciden alınan devam ettirme jetonunu kullanarak klasör yinelemesini devam ettirir.
createFile(blob)FileKullanıcının Drive'ının kök dizininde, rastgele verilerden oluşan belirli bir Blob ile dosya oluşturur.
createFile(name, content)FileKullanıcının Drive'ının kök dizininde, belirtilen ad ve içeriklere sahip bir metin dosyası oluşturur.
createFile(name, content, mimeType)FileKullanıcının Drive'ının kök dizininde, belirtilen ad, içerik ve MIME türüyle bir dosya oluşturur.
createFolder(name)FolderKullanıcının Drive'ının kök dizininde, belirtilen ada sahip bir klasör oluşturur.
createShortcut(targetId)FileBelirtilen Drive öğesi kimliğinin kısayolunu oluşturur ve döndürür.
createShortcutForTargetIdAndResourceKey(targetId, targetResourceKey)FileBelirtilen Drive öğesi kimliği ve kaynak anahtarı için kısayol oluşturur ve döndürür.
enforceSingleParent(value)voidÖğe üstlerini 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'ında belirtilen ada sahip tüm dosyaların koleksiyonunu alır.
getFilesByType(mimeType)FileIteratorKullanıcının Drive'ında, belirtilen 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 kimliğe 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 depolamasına izin verilen bayt sayısını alır.
getStorageUsed()IntegerKullanıcının Drive'da şu anda depoladığı bayt sayısını alır.
getTrashedFiles()FileIteratorKullanıcının Drive çöp kutusundaki tüm dosyaların koleksiyonunu alır.
getTrashedFolders()FolderIteratorKullanıcının Drive'ındaki çöp kutusunda bulunan tüm klasörlerin koleksiyonunu alır.
searchFiles(params)FileIteratorKullanıcının Drive'ında belirtilen arama ölçütleriyle eşleşen tüm dosyaların 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 yorumcular listesine ekleyin.
addCommenter(user)FileBelirtilen kullanıcıyı File için yorumcular listesine ekleyin.
addCommenters(emailAddresses)FileBelirtilen kullanıcı dizisini File için yorumcular listesine ekleyin.
addEditor(emailAddress)FileBelirtilen kullanıcıyı File için düzenleyenler listesine ekler.
addEditor(user)FileBelirtilen kullanıcıyı File için düzenleyenler listesine ekler.
addEditors(emailAddresses)FileBelirtilen kullanıcı dizisini File için düzenleyenler listesine ekler.
addViewer(emailAddress)FileBelirtilen kullanıcıyı File için görüntüleyiciler listesine ekler.
addViewer(user)FileBelirtilen kullanıcıyı File için görüntüleyiciler listesine ekler.
addViewers(emailAddresses)FileBelirtilen kullanıcı dizisini File için görüntüleyiciler 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ür.
getBlob()BlobBu nesnenin içindeki verileri blob olarak döndürür.
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 alır.
getParents()FolderIteratorFile öğesinin doğrudan üst öğeleri olan klasörlerin koleksiyonunu 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 öğesinin, 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()BooleanBağlantı kullanılarak paylaşıldığında bu File için erişim amacıyla kaynak anahtarı gerekip gerekmediğini alır.
getSharingAccess()AccessErişim izni açıkça verilmiş bireysel kullanıcıların yanı sıra File'ya hangi kullanıcı sınıfının erişebileceğini alır.
getSharingPermission()PermissionFile erişebilen kullanıcılara verilen izni alır. Ayrıca, açıkça erişim izni verilen bireysel kullanıcılar da bu izni alır.
getSize()IntegerDrive'da File öğesini 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()Blob|nullDosyanın küçük resmini veya küçük resim yoksa null değerini alır.
getUrl()StringFile simgesini 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 üzerinde düzenleme izni olan kullanıcıların diğer kullanıcılarla paylaşmasına veya izinleri değiştirmesine izin verilip verilmeyeceğini belirler.
isStarred()BooleanFile öğesinin, kullanıcının Drive'ında yıldızlanıp yıldızlanmadığını belirler.
isTrashed()BooleanFile öğesinin, kullanıcının Drive çö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 belirtilen adla adlandırır.
makeCopy(name, destination)FileHedef dizinde dosyanın bir kopyasını oluşturur ve sağlanan adla adlandırır.
moveTo(destination)FileBu öğeyi belirtilen hedef klasöre taşır.
removeCommenter(emailAddress)FileBelirtilen kullanıcıyı File için yorum yapanlar listesinden kaldırır.
removeCommenter(user)FileBelirtilen kullanıcıyı File için yorum yapanlar 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 izleyici ve yorumcu listesinden kaldırır.
removeViewer(user)FileBelirtilen kullanıcıyı File için izleyici ve yorumcu 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ğini belirli bir değiştirme işlemiyle üzerine yazar.
setDescription(description)FileFile için açıklamayı ayarlar.
setName(name)FileFile adını ayarlar.
setOwner(emailAddress)FileFile öğesinin sahibini değiştirir.
setOwner(user)FileFile öğesinin sahibini değiştirir.
setSecurityUpdateEnabled(enabled)FileFile, bağlantı kullanılarak paylaşıldığında erişim için kaynak anahtarı gerektirip gerektirmediğini ayarlar.
setShareableByEditors(shareable)FileFile üzerinde düzenleme izni olan kullanıcıların diğer kullanıcılarla paylaşım yapmasına veya izinleri değiştirmesine izin verilip verilmeyeceğini belirler.
setSharing(accessType, permissionType)FileFile'a hangi kullanıcı sınıfının erişebileceğini ve açıkça erişim izni verilen bireysel kullanıcıların yanı sıra bu kullanıcılara hangi izinlerin verileceğini belirler.
setStarred(starred)FileFile öğesinin kullanıcının Drive'ında yıldızlanıp yıldızlanmayacağını ayarlar.
setTrashed(trashed)FileFile öğesinin, kullanıcının Drive çöp kutusunda olup olmayacağını ayarlar.

FileIterator

Yöntemler

YöntemDönüş türüKısa açıklama
getContinuationToken()StringBu yinelemeye daha sonra devam etmek için kullanılabilecek bir jeton alır.
hasNext()Booleannext() işlevinin çağrılmasının bir öğe döndürüp döndürmeyeceğini belirler.
next()FileDosya veya klasör koleksiyonundaki bir 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üzenleyenler listesine ekler.
addEditor(user)FolderBelirtilen kullanıcıyı Folder için düzenleyenler listesine ekler.
addEditors(emailAddresses)FolderBelirtilen kullanıcı dizisini Folder için düzenleyenler listesine ekler.
addViewer(emailAddress)FolderBelirtilen kullanıcıyı Folder için görüntüleyiciler listesine ekler.
addViewer(user)FolderBelirtilen kullanıcıyı Folder için görüntüleyiciler listesine ekler.
addViewers(emailAddresses)FolderBelirtilen kullanıcı dizisini Folder için görüntüleyiciler listesine ekler.
createFile(blob)FileGeçerli klasörde, rastgele verilerden oluşan belirli bir Blob ile dosya oluşturur.
createFile(name, content)FileGeçerli klasörde, belirtilen ad ve içeriklere sahip bir metin dosyası oluşturur.
createFile(name, content, mimeType)FileGeçerli klasörde, belirtilen ad, içerik ve MIME türüyle bir dosya oluşturur.
createFolder(name)FolderGeçerli klasörde, belirtilen ada sahip bir klasör oluşturur.
createShortcut(targetId)FileBelirtilen Drive öğesi kimliğinin kısayolunu oluşturur ve döndürür.
createShortcutForTargetIdAndResourceKey(targetId, targetResourceKey)FileBelirtilen Drive öğesi kimliği ve kaynak anahtarı için kısayol oluşturur ve 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 öğesi olan tüm dosyaların koleksiyonunu alır.
getFilesByName(name)FileIteratorGeçerli klasörün alt öğeleri olan ve belirtilen ada sahip tüm dosyaların koleksiyonunu alır.
getFilesByType(mimeType)FileIteratorGeçerli klasörün alt öğesi olan ve belirtilen MIME türüne sahip tüm dosyaların koleksiyonunu alır.
getFolders()FolderIteratorGeçerli klasörün alt öğeleri olan tüm klasörlerin koleksiyonunu alır.
getFoldersByName(name)FolderIteratorGeçerli klasörün alt öğesi olan ve belirtilen ada sahip tüm klasörlerin 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örlerin koleksiyonunu 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 öğesinin, 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()BooleanBağlantı kullanılarak paylaşıldığında bu Folder için erişim amacıyla kaynak anahtarı gerekip gerekmediğini alır.
getSharingAccess()AccessErişim izni açıkça verilmiş bireysel kullanıcıların yanı sıra Folder'ya hangi kullanıcı sınıfının erişebileceğini alır.
getSharingPermission()PermissionFolder erişebilen kullanıcılara verilen izni alır. Ayrıca, açıkça erişim izni verilen bireysel kullanıcılar da bu izni alır.
getSize()IntegerDrive'da Folder öğesini depolamak için kullanılan bayt sayısını alır.
getUrl()StringFolder simgesini 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 üzerinde düzenleme izni olan kullanıcıların diğer kullanıcılarla paylaşmasına veya izinleri değiştirmesine izin verilip verilmeyeceğini belirler.
isStarred()BooleanFolder öğesinin, kullanıcının Drive'ında yıldızlanıp yıldızlanmadığını belirler.
isTrashed()BooleanFolder öğesinin, kullanıcının Drive çöp kutusunda 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 izleyici ve yorumcu listesinden kaldırır.
removeViewer(user)FolderBelirtilen kullanıcıyı Folder için izleyici ve yorumcu 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 öğesi olan ve belirtilen arama ölçütleriyle eşleşen tüm klasörlerin koleksiyonunu alır.
setDescription(description)FolderFolder için açıklamayı ayarlar.
setName(name)FolderFolder adını ayarlar.
setOwner(emailAddress)FolderFolder öğesinin sahibini değiştirir.
setOwner(user)FolderFolder öğesinin sahibini değiştirir.
setSecurityUpdateEnabled(enabled)FolderFolder, bağlantı kullanılarak paylaşıldığında erişim için kaynak anahtarı gerektirip gerektirmediğini ayarlar.
setShareableByEditors(shareable)FolderFolder üzerinde düzenleme izni olan kullanıcıların diğer kullanıcılarla paylaşım yapmasına veya izinleri değiştirmesine izin verilip verilmeyeceğini belirler.
setSharing(accessType, permissionType)FolderFolder'a hangi kullanıcı sınıfının erişebileceğini ve açıkça erişim izni verilen bireysel kullanıcıların yanı sıra bu kullanıcılara hangi izinlerin verileceğini belirler.
setStarred(starred)FolderFolder öğesinin kullanıcının Drive'ında yıldızlanıp yıldızlanmayacağını ayarlar.
setTrashed(trashed)FolderFolder öğesinin, kullanıcının Drive çöp kutusunda olup olmayacağını ayarlar.

FolderIterator

Yöntemler

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

Permission

Özellikler

MülkTürAçıklama
VIEWEnumDosyaya veya klasöre erişebilen kullanıcılar yalnızca görüntüleme veya kopyalama işlemi yapabilir.
EDITEnumDosyaya veya klasöre erişebilen kullanıcılar dosyayı ya da klasörü düzenleyebilir.
COMMENTEnumDosyaya veya klasöre erişebilen kullanıcılar yalnızca görüntüleme, kopyalama ya da yorum yapma işlemlerini gerçekleştirebilir.
OWNEREnumKullanıcı, dosyanın veya klasörün sahibidir.
ORGANIZEREnumOrtak Drive'da dosya ve klasörleri düzenleyebilen kullanıcılar
FILE_ORGANIZEREnumOrtak Drive'da içerik düzenleyebilen, çöp kutusuna taşıyabilen 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()String|nullKullanıcı hesabıyla ilişkili alan adını alır.
getEmail()String|nullKullanıcının e-posta adresini alır.
getName()String|nullKullanıcının adını alır.
getPhotoUrl()String|nullKullanıcının fotoğrafının URL'sini alır.