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:
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
Ad | Kısa açıklama |
---|---|
Access | Belirli 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. |
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'daki bir dosya. |
FileIterator | Komut dosyalarının büyük olasılıkla büyük bir dosya koleksiyonunda iterasyon yapmasına olanak tanıyan bir iteratör. |
Folder | Google Drive'daki bir klasör. |
FolderIterator | Komut dosyalarının büyük olasılıkla büyük bir klasör koleksiyonunda iterasyon yapmasına olanak tanıyan bir nesne. |
Permission | Açı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. |
User | Google Drive'daki bir dosyayla ilişkilendirilmiş kullanıcı. |
Access
Özellikler
Mülk | 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 bağlantıya sahip olan kişiler erişebilir. |
PRIVATE | Enum | Yalnızca açıkça izin verilen kişiler erişebilir. |
DriveApp
Özellikler
Mülk | Tür | Açıklama |
---|---|---|
Access | Access | Belirli 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. |
Permission | Permission | Açı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öntem | Dö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) | File | Belirli bir Blob rastgele verisinden kullanıcının Drive'ının kökünde bir dosya oluşturur. |
createFile(name, content) | File | Kullanı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) | File | Kullanı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) | Folder | Kullanıcının Drive'ının kökünde, belirtilen ada sahip bir klasör oluşturur. |
createShortcut(targetId) | File | Sağlanan Drive öğe kimliğinin kısayolunu oluşturur ve döndürür. |
createShortcutForTargetIdAndResourceKey(targetId, targetResourceKey) | File | Sağ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) | File | Belirtilen kimliğe sahip dosyayı alır. |
getFileByIdAndResourceKey(id, resourceKey) | File | Belirtilen kimliğe ve kaynak anahtarına sahip dosyayı alır. |
getFiles() | FileIterator | Kullanıcının Drive'ındaki tüm dosyaların koleksiyonunu alır. |
getFilesByName(name) | FileIterator | Kullanıcının Drive'ındaki, belirtilen ada sahip tüm dosyaların koleksiyonunu alır. |
getFilesByType(mimeType) | FileIterator | Kullanıcının Drive'ındaki belirli bir MIME türüne sahip tüm dosyaların koleksiyonunu alır. |
getFolderById(id) | Folder | Belirtilen kimliğe sahip klasörü alır. |
getFolderByIdAndResourceKey(id, resourceKey) | Folder | Belirtilen kimlik 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'ındaki, belirtilen ada sahip tüm klasörlerin koleksiyonunu alır. |
getRootFolder() | Folder | Kullanıcının Drive'ının kökündeki klasörü alır. |
getStorageLimit() | Integer | Kullanıcının Drive'da depolayabileceği bayt sayısını alır. |
getStorageUsed() | Integer | Kullanıcının şu anda Drive'da depoladığı bayt sayısını alır. |
getTrashedFiles() | FileIterator | Kullanıcının Drive'ındaki çöp kutusundaki tüm dosyaların koleksiyonunu alır. |
getTrashedFolders() | FolderIterator | Kullanıcının Drive'ındaki çöp kutusundaki tüm klasörlerin koleksiyonunu alır. |
searchFiles(params) | FileIterator | Kullanıcının Drive'ındaki, belirtilen arama ölçütleriyle eşleşen tüm dosyaların koleksiyonunu alır. |
searchFolders(params) | FolderIterator | Kullanıcının Drive'ındaki, belirtilen arama ölçütleriyle eşleşen tüm klasörlerin koleksiyonunu alır. |
File
Yöntemler
Yöntem | Dönüş türü | Kısa açıklama |
---|---|---|
addCommenter(emailAddress) | File | Belirtilen kullanıcıyı File için yorumcu listesine ekleyin. |
addCommenter(user) | File | Belirtilen kullanıcıyı File için yorumcu listesine ekleyin. |
addCommenters(emailAddresses) | File | Belirtilen kullanıcı dizisini File için yorumcuların listesine ekleyin. |
addEditor(emailAddress) | File | Belirtilen kullanıcıyı File için düzenleyiciler listesine ekler. |
addEditor(user) | File | Belirtilen kullanıcıyı File için düzenleyiciler listesine ekler. |
addEditors(emailAddresses) | File | Belirtilen kullanıcı dizisini File için düzenleyiciler listesine ekler. |
addViewer(emailAddress) | File | Belirtilen kullanıcıyı File için izleyiciler listesine ekler. |
addViewer(user) | File | Belirtilen kullanıcıyı File için izleyiciler listesine ekler. |
addViewers(emailAddresses) | File | Belirtilen kullanıcı dizisini File için izleyici listesine ekler. |
getAccess(email) | Permission | Belirli bir kullanıcıya verilen izni alır. |
getAccess(user) | Permission | Belirli bir 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ürme. |
getBlob() | Blob | Bu nesnenin içindeki verileri bir blob olarak döndürme. |
getDateCreated() | Date | File öğesinin oluşturulduğu tarihi alır. |
getDescription() | String | File öğesinin açıklamasını 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 öğesinin kimliğini alır. |
getLastUpdated() | Date | File öğesinin son güncellendiği tarihi alır. |
getMimeType() | String | Dosyanın MIME türünü alır. |
getName() | String | File öğesinin adını alır. |
getOwner() | User | Dosyanın sahibini alır. |
getParents() | FolderIterator | File klasörünün doğrudan üst klasörlerini içeren bir koleksiyon alır. |
getResourceKey() | String | Bağlantı kullanılarak paylaşılan öğelere erişmek için gereken File kaynağının anahtarını alır. |
getSecurityUpdateEligible() | Boolean | Bu 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() | Boolean | Bu File 'ün, bağlantı kullanılarak paylaşıldığında erişim için kaynak anahtarı gerektirip gerektirmediğini alır. |
getSharingAccess() | Access | Açı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() | Permission | Açı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() | Integer | File öğesini Drive'da depolamak için kullanılan bayt sayısını alır. |
getTargetId() | String | Bu bir kısayolsa işaret ettiği öğenin kimliğini döndürür. |
getTargetMimeType() | String | Bu bir kısayolsa 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 | Dosyanın küçük resmini alır veya küçük resim yoksa null değerini döndürür. |
getUrl() | String | File 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() | Boolean | File 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() | Boolean | File öğesinin kullanıcının Drive'ında yıldızla işaretlenip işaretlenmediğini belirler. |
isTrashed() | Boolean | File öğesinin, kullanıcının Drive'ındaki çöp kutusuna ait olup olmadığını belirler. |
makeCopy() | File | Dosyanın bir kopyasını oluşturur. |
makeCopy(destination) | File | Dosyanın hedef dizinde bir kopyasını oluşturur. |
makeCopy(name) | File | Dosyanın bir kopyasını oluşturur ve dosyayı sağlanan adla adlandırır. |
makeCopy(name, destination) | File | Hedef dizinde dosyanın bir kopyasını oluşturur ve dosyaya belirtilen adı verir. |
moveTo(destination) | File | Bu öğeyi, belirtilen hedef klasöre taşır. |
removeCommenter(emailAddress) | File | Belirtilen kullanıcıyı File için yorumcu listesinden kaldırır. |
removeCommenter(user) | File | Belirtilen kullanıcıyı File için yorumcu 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üleyen ve yorum yapanlar listesinden kaldırır. |
removeViewer(user) | File | Belirtilen kullanıcıyı File için görüntüleyen ve yorum yapanlar listesinden kaldırır. |
revokePermissions(emailAddress) | File | Belirli bir kullanıcıya verilen File erişimini iptal eder. |
revokePermissions(user) | File | Belirli bir kullanıcıya verilen File erişimini iptal eder. |
setContent(content) | File | Dosyanın içeriğinin üzerine belirli bir değiştirmeyle yazılır. |
setDescription(description) | File | File öğesinin açıklamasını belirler. |
setName(name) | File | File değerinin adını belirler. |
setOwner(emailAddress) | File | File öğesinin sahibini değiştirir. |
setOwner(user) | File | File öğesinin sahibini değiştirir. |
setSecurityUpdateEnabled(enabled) | File | File 'ün, bağlantı kullanılarak paylaşıldığında erişim için kaynak anahtarı gerektirip gerektirmeyeceğini belirler. |
setShareableByEditors(shareable) | File | File 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) | File | Açı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) | File | File öğesinin kullanıcının Drive'ında yıldızla işaretlenip işaretlenmeyeceğini belirler. |
setTrashed(trashed) | File | File öğesinin, kullanıcının Drive'ındaki çöp kutusuna ait olup olmadığını belirler. |
FileIterator
Yöntemler
Yöntem | Dönüş türü | Kısa açıklama |
---|---|---|
getContinuationToken() | String | Bu iterasyonu daha sonra devam ettirmek için kullanılabilecek bir jeton alır. |
hasNext() | Boolean | next() çağrısının bir öğeyi döndürüp döndürmeyeceğ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üzenleyiciler listesine ekler. |
addEditor(user) | Folder | Belirtilen kullanıcıyı Folder için düzenleyiciler listesine ekler. |
addEditors(emailAddresses) | Folder | Belirtilen kullanıcı dizisini Folder için düzenleyiciler listesine ekler. |
addViewer(emailAddress) | Folder | Belirtilen kullanıcıyı Folder için izleyiciler listesine ekler. |
addViewer(user) | Folder | Belirtilen kullanıcıyı Folder için izleyiciler listesine ekler. |
addViewers(emailAddresses) | Folder | Belirtilen kullanıcı dizisini Folder için izleyici listesine ekler. |
createFile(blob) | File | Belirli bir Blob rastgele verisinden geçerli klasörde bir dosya oluşturur. |
createFile(name, content) | File | Geçerli klasörde, belirtilen ada ve içeriğe sahip bir metin dosyası oluşturur. |
createFile(name, content, mimeType) | File | Geçerli klasörde, belirtilen ada, içeriğe ve MIME türüne sahip bir dosya oluşturur. |
createFolder(name) | Folder | Geçerli klasörde belirtilen ada sahip bir klasör oluşturur. |
createShortcut(targetId) | File | Sağlanan Drive öğe kimliğinin kısayolunu oluşturur ve döndürür. |
createShortcutForTargetIdAndResourceKey(targetId, targetResourceKey) | File | Sağlanan Drive öğe kimliğinin ve kaynak anahtarının kısayolunu oluşturup döndürür. |
getAccess(email) | Permission | Belirli bir kullanıcıya verilen izni alır. |
getAccess(user) | Permission | Belirli bir kullanıcıya verilen izni alır. |
getDateCreated() | Date | Folder öğesinin oluşturulduğu tarihi alır. |
getDescription() | String | Folder öğesinin açıklamasını alır. |
getEditors() | User[] | Bu Folder için düzenleyenlerin listesini alır. |
getFiles() | FileIterator | Geçerli klasörün alt öğeleri olan tüm dosyaların koleksiyonunu alır. |
getFilesByName(name) | FileIterator | Mevcut klasörün alt öğeleri olan ve belirtilen ada sahip tüm dosyaların koleksiyonunu alır. |
getFilesByType(mimeType) | FileIterator | Mevcut klasörün alt öğeleri olan ve belirtilen MIME türüne sahip tüm dosyaların koleksiyonunu alır. |
getFolders() | FolderIterator | Geçerli klasörün alt klasörlerinin tümünü içeren bir koleksiyon alır. |
getFoldersByName(name) | FolderIterator | Mevcut klasörün alt öğeleri olan ve belirtilen ada sahip tüm klasörlerin koleksiyonunu alır. |
getId() | String | Folder öğesinin kimliğini alır. |
getLastUpdated() | Date | Folder öğesinin son güncellendiği tarihi alır. |
getName() | String | Folder öğesinin adını alır. |
getOwner() | User | Bu Folder öğesinin sahibini alır. |
getParents() | FolderIterator | Folder klasörünün doğrudan üst klasörlerini içeren bir koleksiyon alır. |
getResourceKey() | String | Bağlantı kullanılarak paylaşılan öğelere erişmek için gereken Folder kaynağının anahtarını alır. |
getSecurityUpdateEligible() | Boolean | Bu 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() | Boolean | Bu Folder 'ün, bağlantı kullanılarak paylaşıldığında erişim için kaynak anahtarı gerektirip gerektirmediğini alır. |
getSharingAccess() | Access | Açı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() | Permission | Açı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() | Integer | Folder öğesini Drive'da depolamak için kullanılan bayt sayısını alır. |
getUrl() | String | Folder 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() | Boolean | Folder 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() | Boolean | Folder öğesinin kullanıcının Drive'ında yıldızla işaretlenip işaretlenmediğini belirler. |
isTrashed() | Boolean | Folder öğesinin, kullanıcının Drive'ındaki çöp kutusuna ait olup olmadığını belirler. |
moveTo(destination) | Folder | Bu öğeyi, belirtilen 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üleyen ve yorum yapanlar listesinden kaldırır. |
removeViewer(user) | Folder | Belirtilen kullanıcıyı Folder için görüntüleyen ve yorum yapanlar listesinden kaldırır. |
revokePermissions(emailAddress) | Folder | Belirli bir kullanıcıya verilen Folder erişimini iptal eder. |
revokePermissions(user) | Folder | Belirli bir kullanıcıya verilen Folder erişimini iptal eder. |
searchFiles(params) | FileIterator | Geçerli klasörün alt öğeleri olan ve belirtilen arama ölçütleriyle eşleşen tüm dosyaların koleksiyonunu alır. |
searchFolders(params) | FolderIterator | Geç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) | Folder | Folder öğesinin açıklamasını belirler. |
setName(name) | Folder | Folder değerinin adını belirler. |
setOwner(emailAddress) | Folder | Folder öğesinin sahibini değiştirir. |
setOwner(user) | Folder | Folder öğesinin sahibini değiştirir. |
setSecurityUpdateEnabled(enabled) | Folder | Folder 'ün, bağlantı kullanılarak paylaşıldığında erişim için kaynak anahtarı gerektirip gerektirmeyeceğini belirler. |
setShareableByEditors(shareable) | Folder | Folder 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) | Folder | Açı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) | Folder | Folder öğesinin kullanıcının Drive'ında yıldızla işaretlenip işaretlenmeyeceğini belirler. |
setTrashed(trashed) | Folder | Folder öğesinin, kullanıcının Drive'ındaki çöp kutusuna ait olup olmadığını belirler. |
FolderIterator
Yöntemler
Yöntem | Dönüş türü | Kısa açıklama |
---|---|---|
getContinuationToken() | String | Bu iterasyonu daha sonra devam ettirmek için kullanılabilecek bir jeton alır. |
hasNext() | Boolean | next() çağrısının bir öğeyi döndürüp döndürmeyeceğini belirler. |
next() | Folder | Dosya veya klasör koleksiyonundaki sonraki öğeyi alır. |
Permission
Özellikler
Mülk | Tür | Açıklama |
---|---|---|
VIEW | Enum | Dosyaya veya klasöre erişebilen kullanıcılar dosyayı yalnızca görüntüleyebilir ya da kopyalayabilir. |
EDIT | Enum | Dosyaya veya klasöre erişebilen kullanıcılar dosyayı düzenleyebilir. |
COMMENT | Enum | Dosyaya veya klasöre erişebilen kullanıcılar dosyayı yalnızca görüntüleyebilir, kopyalayabilir veya dosyaya yorum yapabilir. |
OWNER | Enum | Dosya veya klasörün sahibi kullanıcıdır. |
ORGANIZER | Enum | Ortak Drive'daki dosya ve klasörleri düzenleyebilecek 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 dosya veya klasör için 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. |