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ız, varsayılan Cloud projesi yerine standart bir Cloud projesi kullanıyorsa Drive API'yi manuel olarak etkinleştirmeniz gerekir. Standart Cloud projenizde Drive API'yi etkinleştirin:
Aşağıdaki kod örneğinde, her bir dosyanın adının, kullanıcının Drive'ım klasörüne nasıl 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 | Açıkça erişim izni verilen bireysel kullanıcıların yanı sıra bir dosyaya veya 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'da bir dosya. |
FileIterator | Komut dosyalarının potansiyel olarak büyük bir dosya koleksiyonunda iterasyon yapmasına olanak tanıyan bir iterasyon öğesi. |
Folder | Google Drive'daki bir klasör. |
FolderIterator | Komut dosyalarının potansiyel olarak büyük bir klasör koleksiyonunda iterasyon yapmasına olanak tanıyan bir nesne. |
Permission | Açıkça erişim verilen bireysel 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ılar. |
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 bağlantıya sahip olan kişiler erişebilir. |
PRIVATE | Enum | Yalnızca açıkça izin verilen kişiler erişebilir. |
DriveApp
Özellikler
Özellik | Tür | Açıklama |
---|---|---|
Access | Access | Açıkça erişim izni verilen bireysel kullanıcıların yanı sıra bir dosyaya veya klasöre erişebilen kullanıcı sınıflarını temsil eden bir enum. |
Permission | Permission | Açıkça erişim verilen bireysel 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 iterasyonun devam jetonundan yararlanarak dosya yinelemesini devam ettirir. |
continueFolderIterator(continuationToken) | FolderIterator | Önceki bir yinelemeden devam jetonu 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çeriğe sahip bir metin dosyası oluşturur. |
createFile(name, content, mimeType) | File | Kullanıcının Drive'ının kök dizininde belirtilen ada, içeriğe ve MIME türüne sahip bir dosya oluşturur. |
createFolder(name) | Folder | Kullanıcının Drive'ının kök dizininde belirtilen adla bir klasör oluşturur. |
createShortcut(targetId) | File | Sağlanan Drive öğesi kimliğine kısayol oluşturur ve bu kimliği döndürür. |
createShortcutForTargetIdAndResourceKey(targetId, targetResourceKey) | File | Sağlanan Drive öğesi kimliği ve kaynak anahtarı için 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 forceSingleParent davranışını etkinleştirir veya devre dışı bırakır. |
getFileById(id) | File | Verilen 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 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 | Belirtilen kimliğe sahip klasörü alır. |
getFolderByIdAndResourceKey(id, resourceKey) | Folder | Belirtilen kimliğe ve kaynak anahtarına sahip klasörü alır. |
getFolders() | FolderIterator | Kullanıcının Drive'ındaki tüm klasörlerin bir 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 dizinindeki 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 bir koleksiyonunu alır. |
searchFiles(params) | FileIterator | Kullanıcının Drive'ında belirtilen arama ölçütleriyle eşleşen tüm dosyaların bir koleksiyonunu alır. |
searchFolders(params) | FolderIterator | Kullanıcının Drive'ında 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 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 için yorum yapanlar listesine ekleyin. |
addEditor(emailAddress) | File | Kullanıcıyı File düzenleyici listesine ekler. |
addEditor(user) | File | Kullanıcıyı File düzenleyici listesine ekler. |
addEditors(emailAddresses) | File | Belirtilen kullanıcı dizisini, File düzenleyicisi listesine ekler. |
addViewer(emailAddress) | File | Kullanıcıyı File öğesini görüntüleyenler listesine ekler. |
addViewer(user) | File | Kullanıcıyı File öğesini görüntüleyenler listesine ekler. |
addViewers(emailAddresses) | File | Belirtilen kullanıcı dizisini, File için görüntüleyen 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ü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 öğ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 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 | Dosya sahibini getirir. |
getParents() | FolderIterator | File öğesinin doğrudan üst öğeleri olan klasör koleksiyonunu alır. |
getResourceKey() | String | Bir bağlantı kullanılarak paylaşılan öğelere erişmek için gerekli olan File öğesinin kaynak anahtarını alır. |
getSecurityUpdateEligible() | Boolean | Bu File cihazının, bir 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 öğesinin bir bağlantı kullanılarak paylaşıldığında erişim için kaynak anahtarı gerektirip gerektirmediğini belirtir. |
getSharingAccess() | Access | Açıkça erişim izni verilen bireysel kullanıcıların yanı sıra hangi kullanıcı sınıflarının File öğesine erişebileceğini belirtir. |
getSharingPermission() | Permission | Açıkça erişim verilen bireysel kullanıcıların yanı sıra File erişimi olan kullanıcılara da 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ısayol ise yönlendirdiğ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, yönlendirdiği öğenin kaynak anahtarını döndürür. |
getThumbnail() | Blob | Dosya için bir küçük resim alır veya küçük resim yoksa null . |
getUrl() | String | File öğesini 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 yorum yapanların listesini alır. |
isShareableByEditors() | Boolean | File üzerinde düzenleme izinlerine sahip olan kullanıcıların diğer kullanıcılarla paylaşımda bulunmasına veya izinleri değiştirmesine izin verilip verilmeyeceğini belirler. |
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 verilen adla adlandırır. |
makeCopy(name, destination) | File | Hedef dizinde dosyanın bir kopyasını oluşturur ve verilen adla adlandırır. |
moveTo(destination) | File | Bu öğeyi sağlanan hedef klasöre taşır. |
removeCommenter(emailAddress) | File | İlgili kullanıcıyı File için yorum yapanlar listesinden kaldırır. |
removeCommenter(user) | File | İlgili kullanıcıyı File için yorum yapanlar listesinden kaldırır. |
removeEditor(emailAddress) | File | Kullanıcıyı, File düzenleyici listesinden kaldırır. |
removeEditor(user) | File | Kullanıcıyı, File düzenleyici listesinden kaldırır. |
removeViewer(emailAddress) | File | İlgili kullanıcıyı, File için görüntüleyenler ve yorum yapanlar listesinden kaldırır. |
removeViewer(user) | File | İlgili kullanıcıyı, File için görüntüleyenler ve yorum yapanlar 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 | Belirtilen bir yenisiyle dosya içeriğinin üzerine yazılır. |
setDescription(description) | File | File öğesinin açıklamasını ayarlar. |
setName(name) | File | File öğesinin 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 bir bağlantı kullanılarak paylaşıldığında erişim için kaynak anahtarı gerektirip gerektirmediğini belirler. |
setShareableByEditors(shareable) | File | File üzerinde düzenleme izinlerine sahip olan kullanıcıların diğer kullanıcılarla paylaşımda bulunmasına veya izinleri değiştirmesine izin verilip verilmeyeceğini belirler. |
setSharing(accessType, permissionType) | File | Açıkça erişim verilen bireysel kullanıcıların yanı sıra hangi kullanıcı sınıflarının File ürününe 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ı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() ç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 | Kullanıcıyı Folder düzenleyici listesine ekler. |
addEditor(user) | Folder | Kullanıcıyı Folder düzenleyici listesine ekler. |
addEditors(emailAddresses) | Folder | Belirtilen kullanıcı dizisini, Folder düzenleyicisi listesine ekler. |
addViewer(emailAddress) | Folder | Kullanıcıyı Folder öğesini görüntüleyenler listesine ekler. |
addViewer(user) | Folder | Kullanıcıyı Folder öğesini görüntüleyenler listesine ekler. |
addViewers(emailAddresses) | Folder | Belirtilen kullanıcı dizisini, Folder için görüntüleyen 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 belirtilen ad ve içeriklerle 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 adla bir klasör oluşturur. |
createShortcut(targetId) | File | Sağlanan Drive öğesi kimliğine kısayol oluşturur ve bu kimliği döndürür. |
createShortcutForTargetIdAndResourceKey(targetId, targetResourceKey) | File | Sağlanan Drive öğesi kimliği ve kaynak anahtarı için kısayol oluşturur ve bu kısayolu 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 bir koleksiyonunu alır. |
getFilesByName(name) | FileIterator | Geçerli klasörün alt öğeleri olan ve belirtilen ada sahip olan 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 bir koleksiyonunu alır. |
getFoldersByName(name) | FolderIterator | Geçerli klasörün alt öğeleri olan ve belirtilen ada sahip olan tüm klasörlerin bir koleksiyonunu alır. |
getId() | String | Folder 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 öğesinin doğrudan üst öğeleri olan klasör koleksiyonunu alır. |
getResourceKey() | String | Bir bağlantı kullanılarak paylaşılan öğelere erişmek için gerekli olan Folder öğesinin kaynak anahtarını alır. |
getSecurityUpdateEligible() | Boolean | Bu Folder cihazının, bir 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 öğesinin bir bağlantı kullanılarak paylaşıldığında erişim için kaynak anahtarı gerektirip gerektirmediğini belirtir. |
getSharingAccess() | Access | Açıkça erişim izni verilen bireysel kullanıcıların yanı sıra hangi kullanıcı sınıflarının Folder öğesine erişebileceğini belirtir. |
getSharingPermission() | Permission | Açıkça erişim verilen bireysel kullanıcıların yanı sıra Folder erişimi olan kullanıcılara da verilen izni alır. |
getSize() | Integer | Folder öğesini Drive'da depolamak için kullanılan bayt sayısını alır. |
getUrl() | String | Folder öğesini 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 yorum yapanların listesini alır. |
isShareableByEditors() | Boolean | Folder üzerinde düzenleme izinlerine sahip olan kullanıcıların diğer kullanıcılarla paylaşımda bulunmasına veya izinleri değiştirmesine izin verilip verilmeyeceğini belirler. |
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 | Kullanıcıyı, Folder düzenleyici listesinden kaldırır. |
removeEditor(user) | Folder | Kullanıcıyı, Folder düzenleyici listesinden kaldırır. |
removeViewer(emailAddress) | Folder | İlgili kullanıcıyı, Folder için görüntüleyenler ve yorum yapanlar listesinden kaldırır. |
removeViewer(user) | Folder | İlgili kullanıcıyı, Folder için görüntüleyenler ve yorum yapanlar 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 arama ölçütleriyle eşleşen tüm dosyaların bir koleksiyonunu alır. |
searchFolders(params) | FolderIterator | Geçerli klasörün alt öğeleri olan ve belirtilen arama ölçütleriyle eşleşen tüm klasörlerin bir koleksiyonunu alır. |
setDescription(description) | Folder | Folder öğesinin açıklamasını ayarlar. |
setName(name) | Folder | Folder öğesinin 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 bir bağlantı kullanılarak paylaşıldığında erişim için kaynak anahtarı gerektirip gerektirmediğini belirler. |
setShareableByEditors(shareable) | Folder | Folder üzerinde düzenleme izinlerine sahip olan kullanıcıların diğer kullanıcılarla paylaşımda bulunmasına veya izinleri değiştirmesine izin verilip verilmeyeceğini belirler. |
setSharing(accessType, permissionType) | Folder | Açıkça erişim verilen bireysel kullanıcıların yanı sıra hangi kullanıcı sınıflarının Folder ürününe 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ı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() ç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
Özellik | Tür | Açıklama |
---|---|---|
VIEW | Enum | Dosya veya klasöre erişebilen kullanıcılar dosyayı veya klasörü yalnızca görüntüleyebilir ya da kopyalayabilir. |
EDIT | Enum | Dosya veya klasöre erişebilen kullanıcılar dosyayı veya klasöre erişimi düzenleyebilir. |
COMMENT | Enum | Dosya veya klasöre erişebilen kullanıcılar onu yalnızca görüntüleyebilir, kopyalayabilir veya üzerinde yorum yapabilir. |
OWNER | Enum | Dosyanın veya klasörün sahibi kullanıcı. |
ORGANIZER | Enum | Ortak Drive içindeki dosya ve klasörleri düzenleyebilen kullanıcılardır. |
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 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şkilendirilen 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. |