Drive Service

Google Drive

Bu hizmet, komut dosyalarının Google Drive'da dosya ve klasör oluşturmasını, bulmasını ve değiştirmesini sağlar. Google Drive

Komut dosyanızda standart Cloud projesi bir Google Cloud projesinin Drive API'yi manuel olarak etkinleştirmelisiniz. 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ü:
// 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
AccessHerhangi bir şahıs dışında dosya veya klasöre erişebilen kullanıcı sınıflarını temsil eden bir sıralama Açıkça erişim verilen kullanıcılar
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 yineleme yapmasına olanak tanıyan bir yinelemedir.
FolderGoogle Drive'daki bir klasör.
FolderIteratorKomut dosyalarının, potansiyel olarak büyük bir klasör koleksiyonunda yineleme yapmasına izin veren bir nesne.
PermissionBir dosya veya klasöre erişebilen kullanıcılara verilen izinleri temsil eden bir sıralama açıkça erişim verilen tüm bireysel kullanıcılar.
UserGoogle Drive'daki bir dosyayla ilişkilendirilmiş kullanıcı.

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 bulunan ve bağlantıya sahip olan kullanıcılar erişebilir.
PRIVATEEnumYalnızca açıkça izin verilen kişiler erişebilir.

DriveApp

Özellikler

ÖzellikTürAçıklama
AccessAccessHerhangi bir şahıs dışında dosya veya klasöre erişebilen kullanıcı sınıflarını temsil eden bir sıralama Açıkça erişim verilen kullanıcılar
PermissionPermissionBir dosya veya klasöre erişebilen kullanıcılara verilen izinleri temsil eden bir sıralama açıkça erişim verilen tüm bireysel kullanıcılar.

Yöntemler

YöntemDönüş türüKısa açıklama
continueFileIterator(continuationToken)FileIteratorÖnceki bir iteratörden gelen devamlılık jetonunu kullanarak dosya yinelemesini devam ettirir.
continueFolderIterator(continuationToken)FolderIteratorÖnceki bir iteratörün devamlılık jetonunu 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çerikle bir metin dosyası oluşturur.
createFile(name, content, mimeType)FileBelirtilen ad, içerik ve MIME türüne sahip kullanıcının Drive'ının kök dizininde bir dosya oluşturur.
createFolder(name)FolderKullanıcının Drive'ının kök dizininde verilen ada sahip bir klasör oluşturur.
createShortcut(targetId)FileSağlanan Drive öğe kimliğine kısayol oluşturur ve bunu döndürür.
createShortcutForTargetIdAndResourceKey(targetId, targetResourceKey)FileSağlanan Drive öğe kimliği ve kaynak anahtarına 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 tekli ebeveyn davranışını zorunlu kılar veya devre dışı bırakır.
getFileById(id)FileVerilen kimliğe sahip dosyayı alır.
getFileByIdAndResourceKey(id, resourceKey)FileVerilen 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)FolderVerilen kimliğe sahip klasörü alır.
getFolderByIdAndResourceKey(id, resourceKey)FolderVerilen 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'ında belirtilen ada sahip tüm klasörlerin koleksiyonunu alır.
getRootFolder()FolderKullanıcının Drive'ının kök dizininde bulunan 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 koleksiyonunu alır.
searchFiles(params)FileIteratorKullanıcının Drive'ında, belirtilen aramayla eşleşen tüm dosyaların bir koleksiyonunu alır ölçütlerine bağlıdır.
searchFolders(params)FolderIteratorKullanıcının Drive'ında, belirtilen aramayla eşleşen tüm klasörlerin koleksiyonunu alır ölçütlerine bağlıdı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 ile ilgili 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üleyenler listesine ekler.
addViewer(user)FileBelirtilen kullanıcıyı File için görüntüleyenler listesine ekler.
addViewers(emailAddresses)FileBelirtilen kullanıcı dizisini, File için görüntüleyenler listesine ekler.
getAccess(email)PermissionBelirtilen kullanıcıya verilen izni alır.
getAccess(user)PermissionBelirtilen 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 için açıklamayı 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üncellenme tarihini 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 üst öğesi olan klasörlerden oluşan bir koleksiyon alır.
getResourceKey()StringŞu öğelere erişmek için gereken File kaynak anahtarını alır: bir bağlantı kullanılarak paylaşıldı.
getSecurityUpdateEligible()BooleanBu File cihazının, aşağıdaki güvenlik güncellemesini uygulayıp uygulamayacağını belirler: bir bağlantı kullanılarak paylaşıldığında erişim için kaynak anahtarı gerektirir.
getSecurityUpdateEnabled()BooleanBu File öğesinin, aşağıdaki durumlarda erişim için kaynak anahtarı gerektirip gerektirmediğini alır: bir bağlantı kullanılarak paylaşıldı.
getSharingAccess()AccessBireysel olanlar dışında hangi kullanıcı sınıflarının File uygulamasına erişebileceğini belirler Açıkça erişim verilen kullanıcılar
getSharingPermission()PermissionFile uygulamasına erişebilen kullanıcılara verilen izni alır (açıkça erişim izni verilen bireysel kullanıcılar hariç)
getSize()IntegerFile öğesini Drive'da depolamak için kullanılan bayt sayısını alır.
getTargetId()StringBu bir Kısayol ise işaret ettiğ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 işaret ettiği öğenin kaynak anahtarını döndürür.
getThumbnail()BlobDosya için küçük resim görüntüsü veya küçük resim yoksa null alır.
getUrl()StringFile öğesini şunun gibi bir Google uygulamasında açmak için kullanılabilecek URL'yi alır: Drive veya Dokümanlar.
getViewers()User[]Bu File için görüntüleyenlerin ve yorumcuların listesini alır.
isShareableByEditors()BooleanFile öğesinde düzenleme izinlerine sahip kullanıcıların şunları yapmasına izin verilip verilmediğini belirler: diğer kullanıcılarla paylaşabilir veya izinleri değiştirebilirsiniz.
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 dosyayı verilen adla adlandırır.
makeCopy(name, destination)FileHedef dizinde dosyanın bir kopyasını oluşturur ve dosyayı verilen adla adlandırır.
moveTo(destination)FileBu öğeyi sağlanan hedef klasöre taşır.
removeCommenter(emailAddress)FileBelirtilen kullanıcıyı File için yorumcular listesinden kaldırır.
removeCommenter(user)FileBelirtilen kullanıcıyı File için yorumcular 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üleyenler ve yorumcular listesinden kaldırır.
removeViewer(user)FileBelirtilen kullanıcıyı File için görüntüleyenler ve yorumcular 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)FileVerilen değişikliği dosya içeriğinin üzerine yazar.
setDescription(description)FileFile için açıklamayı ayarlar.
setName(name)FileFile öğesinin adını ayarlar.
setOwner(emailAddress)FileFile öğesinin sahibini değiştirir.
setOwner(user)FileFile öğesinin sahibini değiştirir.
setSecurityUpdateEnabled(enabled)FileAşağıdaki durumlarda File öğesinin, erişim için bir kaynak anahtarı gerektirip gerektirmeyeceğini belirler bir bağlantı kullanılarak paylaşıldı.
setShareableByEditors(shareable)FileFile öğesinde düzenleme izinlerine sahip kullanıcıların öğe paylaşmasına izin verilip verilmeyeceğini belirler veya izinleri değiştirebilirsiniz.
setSharing(accessType, permissionType)FileHangi kullanıcı sınıfının File uygulamasına erişebileceğini ve hangi izinleri belirler Açık şekilde erişim verilen bireysel kullanıcıların yanı sıra bu kullanıcılara da izin verilir.
setStarred(starred)FileKullanıcının Drive'ında File öğesinin 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() işlevinin çağrılmasının bir öğeyi iade edip etmeyeceğ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ü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üleyenler listesine ekler.
addViewer(user)FolderBelirtilen kullanıcıyı Folder için görüntüleyenler listesine ekler.
addViewers(emailAddresses)FolderBelirtilen kullanıcı dizisini, Folder için görüntüleyenler listesine ekler.
createFile(blob)FileBelirli bir Blob rastgele veriden geçerli klasörde bir dosya oluşturur.
createFile(name, content)FileGeçerli klasörde verilen ad ve içeriğe sahip bir metin dosyası oluşturur.
createFile(name, content, mimeType)FileGeçerli klasörde belirtilen ad, içerik ve MIME türüne sahip bir dosya oluşturur.
createFolder(name)FolderVerilen ada sahip mevcut klasörde bir klasör oluşturur.
createShortcut(targetId)FileSağlanan Drive öğe kimliğine kısayol oluşturur ve bunu döndürür.
createShortcutForTargetIdAndResourceKey(targetId, targetResourceKey)FileSağlanan Drive öğe kimliği ve kaynak anahtarına kısayol oluşturur ve bu kısayolu döndürür.
getAccess(email)PermissionBelirtilen kullanıcıya verilen izni alır.
getAccess(user)PermissionBelirtilen kullanıcıya verilen izni alır.
getDateCreated()DateFolder öğesinin oluşturulduğu tarihi alır.
getDescription()StringFolder için açıklamayı 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 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 koleksiyonunu alır.
getFoldersByName(name)FolderIteratorGeçerli klasörün alt öğeleri olan ve belirtilen ada sahip olan tüm klasörlerin koleksiyonunu alır.
getId()StringFolder kimliğini alır.
getLastUpdated()DateFolder öğesinin son güncellenme tarihini alır.
getName()StringFolder öğesinin adını alır.
getOwner()UserBu Folder öğesinin sahibini alır.
getParents()FolderIteratorFolder öğesinin üst öğesi olan klasörlerden oluşan bir koleksiyon alır.
getResourceKey()StringŞu öğelere erişmek için gereken Folder kaynak anahtarını alır: bir bağlantı kullanılarak paylaşıldı.
getSecurityUpdateEligible()BooleanBu Folder cihazının, aşağıdaki güvenlik güncellemesini uygulayıp uygulamayacağını belirler: bir bağlantı kullanılarak paylaşıldığında erişim için kaynak anahtarı gerektirir.
getSecurityUpdateEnabled()BooleanBu Folder öğesinin, aşağıdaki durumlarda erişim için kaynak anahtarı gerektirip gerektirmediğini alır: bir bağlantı kullanılarak paylaşıldı.
getSharingAccess()AccessBireysel olanlar dışında hangi kullanıcı sınıflarının Folder uygulamasına erişebileceğini belirler Açıkça erişim verilen kullanıcılar
getSharingPermission()PermissionFolder uygulamasına erişebilen kullanıcılara verilen izni alır (açıkça erişim izni verilen bireysel kullanıcılar hariç)
getSize()IntegerFolder öğesini Drive'da depolamak için kullanılan bayt sayısını alır.
getUrl()StringFolder öğesini şunun gibi bir Google uygulamasında açmak için kullanılabilecek URL'yi alır: Drive veya Dokümanlar.
getViewers()User[]Bu Folder için görüntüleyenlerin ve yorumcuların listesini alır.
isShareableByEditors()BooleanFolder öğesinde düzenleme izinlerine sahip kullanıcıların şunları yapmasına izin verilip verilmediğini belirler: diğer kullanıcılarla paylaşabilir veya izinleri değiştirebilirsiniz.
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)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üleyenler ve yorumcular listesinden kaldırır.
removeViewer(user)FolderBelirtilen kullanıcıyı Folder için görüntüleyenler ve yorumcular 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 aramayla eşleşen tüm dosyaların koleksiyonunu alır ölçütlerine bağlıdır.
searchFolders(params)FolderIteratorGeçerli klasörün alt öğeleri olan ve belirtilen aramayla eşleşen tüm klasörlerin koleksiyonunu alır ölçütlerine bağlıdır.
setDescription(description)FolderFolder için açıklamayı ayarlar.
setName(name)FolderFolder öğesinin adını ayarlar.
setOwner(emailAddress)FolderFolder öğesinin sahibini değiştirir.
setOwner(user)FolderFolder öğesinin sahibini değiştirir.
setSecurityUpdateEnabled(enabled)FolderAşağıdaki durumlarda Folder öğesinin, erişim için bir kaynak anahtarı gerektirip gerektirmeyeceğini belirler bir bağlantı kullanılarak paylaşıldı.
setShareableByEditors(shareable)FolderFolder öğesinde düzenleme izinlerine sahip kullanıcıların öğe paylaşmasına izin verilip verilmeyeceğini belirler veya izinleri değiştirebilirsiniz.
setSharing(accessType, permissionType)FolderHangi kullanıcı sınıfının Folder uygulamasına erişebileceğini ve hangi izinleri belirler Açık şekilde erişim verilen bireysel kullanıcıların yanı sıra bu kullanıcılara da izin verilir.
setStarred(starred)FolderKullanıcının Drive'ında Folder öğesinin 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() işlevinin çağrılmasının bir öğeyi iade edip etmeyeceğini belirler.
next()FolderDosya veya klasör koleksiyonundaki sonraki öğeyi alır.

Permission

Özellikler

ÖzellikTürAçıklama
VIEWEnumDosyaya veya klasöre erişebilen kullanıcılar, dosyayı veya klasörü yalnızca görüntüleyebilir ya da kopyalayabilir.
EDITEnumDosyaya veya klasöre erişebilen kullanıcılar, dosyayı veya klasöre erişebilir.
COMMENTEnumDosyaya veya klasöre erişebilen kullanıcılar, dosyayı veya klasörü yalnızca görüntüleyebilir, kopyalayabilir veya dosya veya klasör üzerinde yorum yapabilir.
OWNEREnumDosyanın veya klasörün sahibi kullanıcıya aittir.
ORGANIZEREnumBir ortak drive'daki dosyaları ve klasörleri organize edebilen 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 bu 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ş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.