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:
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
Ad | Kısa açıklama |
---|---|
Access | Herhangi 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 |
DriveApp | Komut dosyalarının Google Drive'da dosya ve klasör oluşturmasına, bulmasına ve değiştirmesine izin verir. |
File | Google Drive'da bir dosya. |
FileIterator | Komut dosyalarının, potansiyel olarak büyük bir dosya koleksiyonunda yineleme yapmasına olanak tanıyan bir yinelemedir. |
Folder | Google Drive'daki bir klasör. |
FolderIterator | Komut dosyalarının, potansiyel olarak büyük bir klasör koleksiyonunda yineleme yapmasına izin veren bir nesne. |
Permission | Bir 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. |
User | Google Drive'daki bir dosyayla ilişkilendirilmiş kullanıcı. |
Access
Özellikler
Özellik | Tür | Açıklama |
---|---|---|
ANYONE | Enum | İnternetteki herkes bulabilir ve erişebilir. |
ANYONE_WITH_LINK | Enum | Bağlantıya sahip olan herkes erişebilir. |
DOMAIN | Enum | Alanınızdaki kullanıcılar bulabilir ve erişebilir. |
DOMAIN_WITH_LINK | Enum | Alanınızda bulunan ve bağlantıya sahip olan kullanıcılar erişebilir. |
PRIVATE | Enum | Yalnızca açıkça izin verilen kişiler erişebilir. |
DriveApp
Özellikler
Özellik | Tür | Açıklama |
---|---|---|
Access | Access | Herhangi 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 |
Permission | Permission | Bir 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öntem | Dö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) | File | Belirli bir Blob rastgele veriden kullanıcının Drive'ının kök dizininde bir dosya oluşturur. |
createFile(name, content) | File | Kullanıcının Drive'ının kök dizininde belirtilen ad ve içerikle bir metin dosyası oluşturur. |
createFile(name, content, mimeType) | File | Belirtilen 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) | Folder | Kullanıcının Drive'ının kök dizininde verilen ada sahip bir klasör oluşturur. |
createShortcut(targetId) | File | Sağlanan Drive öğe kimliğine kısayol oluşturur ve bunu döndürür. |
createShortcutForTargetIdAndResourceKey(targetId, targetResourceKey) | File | Sağ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) | File | Verilen kimliğe sahip dosyayı alır. |
getFileByIdAndResourceKey(id, resourceKey) | File | Verilen kimliğe ve kaynak anahtarına sahip dosyayı alır. |
getFiles() | FileIterator | Kullanıcının Drive'ındaki tüm dosyaların bir koleksiyonunu alır. |
getFilesByName(name) | FileIterator | Kullanıcının Drive'ında belirtilen ada sahip tüm dosyaların bir koleksiyonunu alır. |
getFilesByType(mimeType) | FileIterator | Kullanıcının Drive'ında belirtilen MIME türüne sahip tüm dosyaların bir koleksiyonunu alır. |
getFolderById(id) | Folder | Verilen kimliğe sahip klasörü alır. |
getFolderByIdAndResourceKey(id, resourceKey) | Folder | Verilen kimliğe ve kaynak anahtarına sahip klasörü alır. |
getFolders() | FolderIterator | Kullanıcının Drive'ındaki tüm klasörlerin koleksiyonunu alır. |
getFoldersByName(name) | FolderIterator | Kullanıcının Drive'ında belirtilen ada sahip tüm klasörlerin koleksiyonunu alır. |
getRootFolder() | Folder | Kullanıcının Drive'ının kök dizininde bulunan klasörü alır. |
getStorageLimit() | Integer | Kullanıcının Drive'da depolamasına izin verilen bayt sayısını alır. |
getStorageUsed() | Integer | Kullanıcının Drive'da depoladığı bayt sayısını alır. |
getTrashedFiles() | FileIterator | Kullanıcının Drive'ının çöp kutusundaki tüm dosyaların bir koleksiyonunu alır. |
getTrashedFolders() | FolderIterator | Kullanıcının Drive'ının çöp kutusundaki tüm klasörlerin koleksiyonunu alır. |
searchFiles(params) | FileIterator | Kullanı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) | FolderIterator | Kullanı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öntem | Dönüş türü | Kısa açıklama |
---|---|---|
addCommenter(emailAddress) | File | Belirtilen kullanıcıyı File için yorum yapanlar listesine ekleyin. |
addCommenter(user) | File | Belirtilen kullanıcıyı File için yorum yapanlar listesine ekleyin. |
addCommenters(emailAddresses) | File | Belirtilen kullanıcı dizisini, File ile ilgili yorumcular listesine ekleyin. |
addEditor(emailAddress) | File | Belirtilen kullanıcıyı File için düzenleyenler listesine ekler. |
addEditor(user) | File | Belirtilen kullanıcıyı File için düzenleyenler listesine ekler. |
addEditors(emailAddresses) | File | Belirtilen kullanıcı dizisini, File için düzenleyenler listesine ekler. |
addViewer(emailAddress) | File | Belirtilen kullanıcıyı File için görüntüleyenler listesine ekler. |
addViewer(user) | File | Belirtilen kullanıcıyı File için görüntüleyenler listesine ekler. |
addViewers(emailAddresses) | File | Belirtilen kullanıcı dizisini, File için görüntüleyenler listesine ekler. |
getAccess(email) | Permission | Belirtilen kullanıcıya verilen izni alır. |
getAccess(user) | Permission | Belirtilen kullanıcıya verilen izni alır. |
getAs(contentType) | Blob | Bu nesnenin içindeki verileri, belirtilen içerik türüne dönüştürülmüş bir blob olarak döndürün. |
getBlob() | Blob | Bu nesnenin içindeki verileri blob olarak döndürün. |
getDateCreated() | Date | File öğesinin oluşturulduğu tarihi alır. |
getDescription() | String | File için açıklamayı alır. |
getDownloadUrl() | String | Dosyayı indirmek için kullanılabilecek URL'yi alır. |
getEditors() | User[] | Bu File için düzenleyenlerin listesini alır. |
getId() | String | File kimliğini alır. |
getLastUpdated() | Date | File öğesinin son güncellenme tarihini alır. |
getMimeType() | String | Dosyanın MIME türünü alır. |
getName() | String | File öğesinin adını alır. |
getOwner() | User | Dosya sahibini alır. |
getParents() | FolderIterator | File öğ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() | Boolean | Bu 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() | Boolean | Bu 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() | Access | Bireysel 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() | Permission | File uygulamasına erişebilen kullanıcılara verilen izni alır
(açıkça erişim izni verilen bireysel kullanıcılar hariç) |
getSize() | Integer | File öğesini Drive'da depolamak için kullanılan bayt sayısını alır. |
getTargetId() | String | Bu bir Kısayol ise işaret ettiği öğenin kimliğini döndürür. |
getTargetMimeType() | String | Bu bir Kısayol ise işaret ettiği öğenin MIME türünü döndürür. |
getTargetResourceKey() | String | Dosya bir kısayolsa işaret ettiği öğenin kaynak anahtarını döndürür. |
getThumbnail() | Blob | Dosya için küçük resim görüntüsü veya küçük resim yoksa null alır. |
getUrl() | String | File öğ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() | Boolean | File öğ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() | Boolean | File öğesinin, kullanıcının Drive'ında yıldızlı olup olmadığını belirler. |
isTrashed() | Boolean | File öğesinin, kullanıcının Drive'ının çöp kutusunda olup olmadığını belirler. |
makeCopy() | File | Dosyanın bir kopyasını oluşturur. |
makeCopy(destination) | File | Hedef dizinde dosyanın bir kopyasını oluşturur. |
makeCopy(name) | File | Dosyanın bir kopyasını oluşturur ve dosyayı verilen adla adlandırır. |
makeCopy(name, destination) | File | Hedef dizinde dosyanın bir kopyasını oluşturur ve dosyayı verilen adla adlandırır. |
moveTo(destination) | File | Bu öğeyi sağlanan hedef klasöre taşır. |
removeCommenter(emailAddress) | File | Belirtilen kullanıcıyı File için yorumcular listesinden kaldırır. |
removeCommenter(user) | File | Belirtilen kullanıcıyı File için yorumcular listesinden kaldırır. |
removeEditor(emailAddress) | File | Belirtilen kullanıcıyı File için düzenleyenler listesinden kaldırır. |
removeEditor(user) | File | Belirtilen kullanıcıyı File için düzenleyenler listesinden kaldırır. |
removeViewer(emailAddress) | File | Belirtilen kullanıcıyı File için görüntüleyenler ve yorumcular listesinden kaldırır. |
removeViewer(user) | File | Belirtilen kullanıcıyı File için görüntüleyenler ve yorumcular listesinden kaldırır. |
revokePermissions(emailAddress) | File | Belirtilen kullanıcıya verilen File erişimini iptal eder. |
revokePermissions(user) | File | Belirtilen kullanıcıya verilen File erişimini iptal eder. |
setContent(content) | File | Verilen değişikliği dosya içeriğinin üzerine yazar. |
setDescription(description) | File | File için açıklamayı ayarlar. |
setName(name) | File | File öğesinin adını ayarlar. |
setOwner(emailAddress) | File | File öğesinin sahibini değiştirir. |
setOwner(user) | File | File öğesinin sahibini değiştirir. |
setSecurityUpdateEnabled(enabled) | File | Aş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) | File | File öğ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) | File | Hangi 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) | File | Kullanıcının Drive'ında File öğesinin yıldızlı olup olmadığını belirler. |
setTrashed(trashed) | File | File öğesinin, kullanıcının Drive'ının çöp kutusunda olup olmadığını belirler. |
FileIterator
Yöntemler
Yöntem | Dönüş türü | Kısa açıklama |
---|---|---|
getContinuationToken() | String | Bu yinelemeyi daha sonra devam ettirmek için kullanılabilecek bir jeton alır. |
hasNext() | Boolean | next() işlevinin çağrılmasının bir öğeyi iade edip etmeyeceğini belirler. |
next() | File | Dosya veya klasör koleksiyonundaki sonraki öğeyi alır. |
Folder
Yöntemler
Yöntem | Dönüş türü | Kısa açıklama |
---|---|---|
addEditor(emailAddress) | Folder | Belirtilen kullanıcıyı Folder için düzenleyenler listesine ekler. |
addEditor(user) | Folder | Belirtilen kullanıcıyı Folder için düzenleyenler listesine ekler. |
addEditors(emailAddresses) | Folder | Belirtilen kullanıcı dizisini, Folder için düzenleyenler listesine ekler. |
addViewer(emailAddress) | Folder | Belirtilen kullanıcıyı Folder için görüntüleyenler listesine ekler. |
addViewer(user) | Folder | Belirtilen kullanıcıyı Folder için görüntüleyenler listesine ekler. |
addViewers(emailAddresses) | Folder | Belirtilen kullanıcı dizisini, Folder için görüntüleyenler listesine ekler. |
createFile(blob) | File | Belirli bir Blob rastgele veriden geçerli klasörde bir dosya oluşturur. |
createFile(name, content) | File | Geçerli klasörde verilen ad ve içeriğe sahip bir metin dosyası oluşturur. |
createFile(name, content, mimeType) | File | Geçerli klasörde belirtilen ad, içerik ve MIME türüne sahip bir dosya oluşturur. |
createFolder(name) | Folder | Verilen ada sahip mevcut klasörde bir klasör oluşturur. |
createShortcut(targetId) | File | Sağlanan Drive öğe kimliğine kısayol oluşturur ve bunu döndürür. |
createShortcutForTargetIdAndResourceKey(targetId, targetResourceKey) | File | Sağlanan Drive öğe kimliği ve kaynak anahtarına kısayol oluşturur ve bu kısayolu döndürür. |
getAccess(email) | Permission | Belirtilen kullanıcıya verilen izni alır. |
getAccess(user) | Permission | Belirtilen kullanıcıya verilen izni alır. |
getDateCreated() | Date | Folder öğesinin oluşturulduğu tarihi alır. |
getDescription() | String | Folder için açıklamayı alır. |
getEditors() | User[] | Bu Folder için düzenleyenlerin listesini alır. |
getFiles() | FileIterator | Geçerli klasörün alt öğesi olan tüm dosyaların koleksiyonunu alır. |
getFilesByName(name) | FileIterator | Geçerli klasörün alt öğeleri olan ve belirtilen ada sahip tüm dosyaların bir koleksiyonunu alır. |
getFilesByType(mimeType) | FileIterator | Geçerli klasörün alt öğeleri olan ve belirtilen MIME türüne sahip tüm dosyaların bir koleksiyonunu alır. |
getFolders() | FolderIterator | Geçerli klasörün alt öğeleri olan tüm klasörlerin koleksiyonunu alır. |
getFoldersByName(name) | FolderIterator | Geçerli klasörün alt öğeleri olan ve belirtilen ada sahip olan tüm klasörlerin koleksiyonunu alır. |
getId() | String | Folder kimliğini alır. |
getLastUpdated() | Date | Folder öğesinin son güncellenme tarihini alır. |
getName() | String | Folder öğesinin adını alır. |
getOwner() | User | Bu Folder öğesinin sahibini alır. |
getParents() | FolderIterator | Folder öğ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() | Boolean | Bu 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() | Boolean | Bu 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() | Access | Bireysel 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() | Permission | Folder uygulamasına erişebilen kullanıcılara verilen izni alır
(açıkça erişim izni verilen bireysel kullanıcılar hariç) |
getSize() | Integer | Folder öğesini Drive'da depolamak için kullanılan bayt sayısını alır. |
getUrl() | String | Folder öğ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() | Boolean | Folder öğ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() | Boolean | Folder öğesinin, kullanıcının Drive'ında yıldızlı olup olmadığını belirler. |
isTrashed() | Boolean | Folder öğesinin, kullanıcının Drive'ının çöp kutusunda olup olmadığını belirler. |
moveTo(destination) | Folder | Bu öğeyi sağlanan hedef klasöre taşır. |
removeEditor(emailAddress) | Folder | Belirtilen kullanıcıyı Folder için düzenleyenler listesinden kaldırır. |
removeEditor(user) | Folder | Belirtilen kullanıcıyı Folder için düzenleyenler listesinden kaldırır. |
removeViewer(emailAddress) | Folder | Belirtilen kullanıcıyı Folder için görüntüleyenler ve yorumcular listesinden kaldırır. |
removeViewer(user) | Folder | Belirtilen kullanıcıyı Folder için görüntüleyenler ve yorumcular listesinden kaldırır. |
revokePermissions(emailAddress) | Folder | Belirtilen kullanıcıya verilen Folder erişimini iptal eder. |
revokePermissions(user) | Folder | Belirtilen kullanıcıya verilen Folder erişimini iptal eder. |
searchFiles(params) | FileIterator | Geç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) | FolderIterator | Geç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) | Folder | Folder için açıklamayı ayarlar. |
setName(name) | Folder | Folder öğesinin adını ayarlar. |
setOwner(emailAddress) | Folder | Folder öğesinin sahibini değiştirir. |
setOwner(user) | Folder | Folder öğesinin sahibini değiştirir. |
setSecurityUpdateEnabled(enabled) | Folder | Aş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) | Folder | Folder öğ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) | Folder | Hangi 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) | Folder | Kullanıcının Drive'ında Folder öğesinin yıldızlı olup olmadığını belirler. |
setTrashed(trashed) | Folder | Folder öğesinin, kullanıcının Drive'ının çöp kutusunda olup olmadığını belirler. |
FolderIterator
Yöntemler
Yöntem | Dönüş türü | Kısa açıklama |
---|---|---|
getContinuationToken() | String | Bu yinelemeyi daha sonra devam ettirmek için kullanılabilecek bir jeton alır. |
hasNext() | Boolean | next() işlevinin çağrılmasının bir öğeyi iade edip etmeyeceğini belirler. |
next() | Folder | Dosya veya klasör koleksiyonundaki sonraki öğeyi alır. |
Permission
Özellikler
Özellik | Tür | Açıklama |
---|---|---|
VIEW | Enum | Dosyaya veya klasöre erişebilen kullanıcılar, dosyayı veya klasörü yalnızca görüntüleyebilir ya da kopyalayabilir. |
EDIT | Enum | Dosyaya veya klasöre erişebilen kullanıcılar, dosyayı veya klasöre erişebilir. |
COMMENT | Enum | Dosyaya 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. |
OWNER | Enum | Dosyanın veya klasörün sahibi kullanıcıya aittir. |
ORGANIZER | Enum | Bir ortak drive'daki dosyaları ve klasörleri organize edebilen kullanıcılar. |
FILE_ORGANIZER | Enum | Ortak drive'da içerik düzenleyebilen, çöp kutusuna gönderebilen ve taşıyabilen kullanıcılar. |
NONE | Enum | Kullanıcının bu dosya veya klasör için herhangi bir izni yok. |
User
Yöntemler
Yöntem | Dönüş türü | Kısa açıklama |
---|---|---|
getDomain() | String | Kullanıcının hesabıyla ilişkili alan adını alır. |
getEmail() | String | Kullanıcının e-posta adresini alır. |
getName() | String | Kullanıcının adını alır. |
getPhotoUrl() | String | Kullanıcının fotoğrafının URL'sini alır. |