Google Drive'daki bir dosya Dosyalara Drive üzerinden erişilebilir veya dosyalar oluşturulabilir.
// Trash every untitled spreadsheet that hasn't been updated in a week. const files = DriveApp.getFilesByName('Untitled spreadsheet'); while (files.hasNext()) { const file = files.next(); if (new Date() - file.getLastUpdated() > 7 * 24 * 60 * 60 * 1000) { file.setTrashed(true); } }
Yöntemler
| Yöntem | Dönüş türü | Kısa açıklama |
|---|---|---|
add | File | Belirtilen kullanıcıyı File için yorumcular listesine ekleyin. |
add | File | Belirtilen kullanıcıyı File için yorumcular listesine ekleyin. |
add | File | Belirtilen kullanıcı dizisini File için yorumcular listesine ekleyin. |
add | File | Belirtilen kullanıcıyı File için düzenleyenler listesine ekler. |
add | File | Belirtilen kullanıcıyı File için düzenleyenler listesine ekler. |
add | File | Belirtilen kullanıcı dizisini File için düzenleyenler listesine ekler. |
add | File | Belirtilen kullanıcıyı File için görüntüleyiciler listesine ekler. |
add | File | Belirtilen kullanıcıyı File için görüntüleyiciler listesine ekler. |
add | File | Belirtilen kullanıcı dizisini File için görüntüleyiciler listesine ekler. |
get | Permission | Belirli bir kullanıcıya verilen izni alır. |
get | Permission | Belirli bir kullanıcıya verilen izni alır. |
get | Blob | Bu nesnenin içindeki verileri, belirtilen içerik türüne dönüştürülmüş bir blob olarak döndürür. |
get | Blob | Bu nesnenin içindeki verileri blob olarak döndürür. |
get | Date | File öğesinin oluşturulduğu tarihi alır. |
get | String | File öğesinin açıklamasını alır. |
get | String | Dosyayı indirmek için kullanılabilecek URL'yi alır. |
get | User[] | Bu File için düzenleyenlerin listesini alır. |
get | String | File kimliğini alır. |
get | Date | File öğesinin son güncellendiği tarihi alır. |
get | String | Dosyanın MIME türünü alır. |
get | String | File öğesinin adını alır. |
get | User | Dosya sahibini alır. |
get | Folder | File öğesinin doğrudan üst öğeleri olan klasörlerin koleksiyonunu alır. |
get | String | Bağlantı kullanılarak paylaşılan öğelere erişmek için gereken File kaynağının anahtarını alır. |
get | Boolean | Bu 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. |
get | Boolean | Bağlantı kullanılarak paylaşıldığında bu File için erişim amacıyla kaynak anahtarı gerekip gerekmediğini alır. |
get | Access | Eriş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. |
get | Permission | File 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. |
get | Integer | Drive'da File öğesini depolamak için kullanılan bayt sayısını alır. |
get | String | Bu bir kısayolsa işaret ettiği öğenin kimliğini döndürür. |
get | String | Bu bir kısayolsa işaret ettiği öğenin MIME türünü döndürür. |
get | String | Dosya bir kısayolsa işaret ettiği öğenin kaynak anahtarını döndürür. |
get | Blob|null | Dosyanın küçük resmini veya küçük resim yoksa null değerini alır. |
get | String | File simgesini Drive veya Dokümanlar gibi bir Google uygulamasında açmak için kullanılabilecek URL'yi alır. |
get | User[] | Bu File için görüntüleyenlerin ve yorumcuların listesini alır. |
is | Boolean | File ü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. |
is | Boolean | File öğesinin, kullanıcının Drive'ında yıldızlanıp yıldızlanmadığını belirler. |
is | Boolean | File öğesinin, kullanıcının Drive çöp kutusunda olup olmadığını belirler. |
make | File | Dosyanın bir kopyasını oluşturur. |
make | File | Hedef dizinde dosyanın bir kopyasını oluşturur. |
make | File | Dosyanın bir kopyasını oluşturur ve belirtilen adla adlandırır. |
make | File | Hedef dizinde dosyanın bir kopyasını oluşturur ve sağlanan adla adlandırır. |
move | File | Bu öğeyi belirtilen hedef klasöre taşır. |
remove | File | Belirtilen kullanıcıyı File için yorum yapanlar listesinden kaldırır. |
remove | File | Belirtilen kullanıcıyı File için yorum yapanlar listesinden kaldırır. |
remove | File | Belirtilen kullanıcıyı File için düzenleyenler listesinden kaldırır. |
remove | File | Belirtilen kullanıcıyı File için düzenleyenler listesinden kaldırır. |
remove | File | Belirtilen kullanıcıyı File için izleyici ve yorumcu listesinden kaldırır. |
remove | File | Belirtilen kullanıcıyı File için izleyici ve yorumcu listesinden kaldırır. |
revoke | File | Belirli bir kullanıcıya verilen File erişimini iptal eder. |
revoke | File | Belirli bir kullanıcıya verilen File erişimini iptal eder. |
set | File | Dosyanın içeriğini belirli bir değiştirme işlemiyle üzerine yazar. |
set | File | File için açıklamayı ayarlar. |
set | File | File adını ayarlar. |
set | File | File öğesinin sahibini değiştirir. |
set | File | File öğesinin sahibini değiştirir. |
set | File | File, bağlantı kullanılarak paylaşıldığında erişim için kaynak anahtarı gerektirip gerektirmediğini ayarlar. |
set | File | File ü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. |
set | File | File'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. |
set | File | File öğesinin kullanıcının Drive'ında yıldızlanıp yıldızlanmayacağını ayarlar. |
set | File | File öğesinin, kullanıcının Drive çöp kutusunda olup olmayacağını ayarlar. |
Ayrıntılı belgeler
add Commenter(emailAddress)
Belirtilen kullanıcıyı File için yorumcular listesine ekleyin. Kullanıcı zaten izleyiciler listesindeyse bu yöntem, kullanıcının izleyiciler listesinden çıkarılmasını sağlar.
const files = DriveApp.getFilesByName('Test'); // Loops through the files while (files.hasNext()) { const file = files.next(); file.addCommenter('hello@example.com'); }
Parametreler
| Ad | Tür | Açıklama |
|---|---|---|
email | String | Eklenecek kullanıcının e-posta adresi. |
Return
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan biri veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/drive
add Commenter(user)
Belirtilen kullanıcıyı File için yorumcular listesine ekleyin. Kullanıcı zaten izleyiciler listesindeyse bu yöntem, kullanıcının izleyiciler listesinden çıkarılmasını sağlar.
// Gets a list of all files in Google Drive with the given name. // TODO(developer): Replace the file name with your own. const files = DriveApp.getFilesByName('Test'); // Adds the active user as a commenter. while (files.hasNext()) { const file = files.next(); file.addCommenter(Session.getActiveUser()); }
Parametreler
| Ad | Tür | Açıklama |
|---|---|---|
user | User | Eklenecek kullanıcının temsili. |
Return
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan biri veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/drive
add Commenters(emailAddresses)
Belirtilen kullanıcı dizisini File için yorumcular listesine ekleyin. Kullanıcılardan herhangi biri zaten izleyiciler listesindeyse bu yöntem, söz konusu kullanıcıları izleyiciler listesinden çıkarır.
// Gets a list of all files in Google Drive with the given name. // TODO(developer): Replace the file name with your own. const files = DriveApp.getFilesByName('Test'); while (files.hasNext()) { const file = files.next(); // TODO(developer): Replace 'cloudysanfrancisco@gmail.com' and // 'baklavainthebalkans@gmail.com' with the email addresses to add as // commenters. const emails = [ 'cloudysanfrancisco@gmail.com', 'baklavainthebalkans@gmail.com', ]; console.log(file.addCommenters(emails)); }
Parametreler
| Ad | Tür | Açıklama |
|---|---|---|
email | String[] | Eklenecek kullanıcıların e-posta adreslerinden oluşan bir dizi. |
Return
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan biri veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/drive
add Editor(emailAddress)
Belirtilen kullanıcıyı File için düzenleyenler listesine ekler. Kullanıcı zaten izleyiciler listesindeyse bu yöntem, kullanıcının izleyiciler listesinden çıkmasını sağlar.
Parametreler
| Ad | Tür | Açıklama |
|---|---|---|
email | String | Eklenecek kullanıcının e-posta adresi. |
Return
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan biri veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/drive
add Editor(user)
Belirtilen kullanıcıyı File için düzenleyenler listesine ekler. Kullanıcı zaten izleyiciler listesindeyse bu yöntem, kullanıcının izleyiciler listesinden çıkmasını sağlar.
Parametreler
| Ad | Tür | Açıklama |
|---|---|---|
user | User | Eklenecek kullanıcının temsili. |
Return
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan biri veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/drive
add Editors(emailAddresses)
Belirtilen kullanıcı dizisini File için düzenleyenler listesine ekler. Kullanıcılardan herhangi biri zaten izleyiciler listesindeyse bu yöntemle kullanıcılar izleyiciler listesinden çıkarılır.
Parametreler
| Ad | Tür | Açıklama |
|---|---|---|
email | String[] | Eklenecek kullanıcıların e-posta adreslerinden oluşan bir dizi. |
Return
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan biri veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/drive
add Viewer(emailAddress)
Belirtilen kullanıcıyı File için görüntüleyiciler listesine ekler. Kullanıcı zaten düzenleyenler listesindeyse bu yöntemin etkisi olmaz.
Parametreler
| Ad | Tür | Açıklama |
|---|---|---|
email | String | Eklenecek kullanıcının e-posta adresi. |
Return
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan biri veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/drive
add Viewer(user)
Belirtilen kullanıcıyı File için görüntüleyiciler listesine ekler. Kullanıcı zaten düzenleyenler listesindeyse bu yöntemin etkisi olmaz.
Parametreler
| Ad | Tür | Açıklama |
|---|---|---|
user | User | Eklenecek kullanıcının temsili. |
Return
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan biri veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/drive
add Viewers(emailAddresses)
Belirtilen kullanıcı dizisini File için görüntüleyiciler listesine ekler. Kullanıcılardan herhangi biri zaten düzenleyenler listesindeyse bu yöntem söz konusu kullanıcılar için geçerli olmaz.
Parametreler
| Ad | Tür | Açıklama |
|---|---|---|
email | String[] | Eklenecek kullanıcıların e-posta adreslerinden oluşan bir dizi. |
Return
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan biri veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/drive
get Access(email)
Belirli bir kullanıcıya verilen izni alır. Bu yöntem, Google Grubu için izinlerin veya Google Gruplar üzerinden devralınan izinlerin döndürülmesini desteklemez.
Parametreler
| Ad | Tür | Açıklama |
|---|---|---|
email | String | İzinleri kontrol edilecek kullanıcının e-posta adresi. Google Gruplar desteklenmez. |
Return
Permission: Kullanıcıya verilen izinler.
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan biri veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/drive.readonly -
https://www.googleapis.com/auth/drive
get Access(user)
Belirli bir kullanıcıya verilen izni alır. Bu yöntem, Google Grubu için izinlerin veya Google Gruplar üzerinden devralınan izinlerin döndürülmesini desteklemez.
Parametreler
| Ad | Tür | Açıklama |
|---|---|---|
user | User | İzinleri kontrol edilecek kullanıcının temsili. |
Return
Permission: Kullanıcıya verilen izinler.
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan biri veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/drive.readonly -
https://www.googleapis.com/auth/drive
get As(contentType)
Bu nesnenin içindeki verileri, belirtilen içerik türüne dönüştürülmüş bir blob olarak döndürür. Bu yöntem, dosya adına uygun uzantıyı ekler (ör. "dosyam.pdf"). Ancak, dosya adının son noktadan sonraki kısmının (varsa) değiştirilmesi gereken mevcut bir uzantı olduğunu varsayar. Bu nedenle, "ShoppingList.12.25.2014" ifadesi "ShoppingList.12.25.pdf" olur.
Dönüşümlerle ilgili günlük kotaları görüntülemek için Google Hizmetleri Kotaları başlıklı makaleyi inceleyin. Yeni oluşturulan Google Workspace alanları geçici olarak daha katı kotalara tabi olabilir.
Parametreler
| Ad | Tür | Açıklama |
|---|---|---|
content | String | Dönüştürülecek MIME türü. Çoğu blob için tek geçerli seçenek 'application/pdf''dır. BMP, GIF, JPEG veya PNG biçimindeki resimler için 'image/bmp', 'image/gif', 'image/jpeg' veya 'image/png' de geçerlidir. Google Dokümanlar dokümanlarında 'text/markdown' da geçerlidir. |
Return
Blob — Veriler blob olarak.
get Blob()
get Date Created()
File öğesinin oluşturulduğu tarihi alır.
Return
Date: File öğesinin oluşturulduğu tarih
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan biri veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/drive.readonly -
https://www.googleapis.com/auth/drive
get Description()
File öğesinin açıklamasını alır.
Return
String: File için açıklama
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan biri veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/drive.readonly -
https://www.googleapis.com/auth/drive
get Download Url()
Dosyayı indirmek için kullanılabilecek URL'yi alır. URL'ye yalnızca Google Drive'da dosyayı açma izni olan kullanıcılar erişebilir. Bu URL'yi dosyayı indirmek için tarayıcıda kullanabilirsiniz ancak dosyayı Url ile getirmek için kullanamazsınız. Dosyanın içeriğinin senaryoda yer almasını istiyorsanız get simgesini kullanın.
// Gets a list of all files in Google Drive with the given name. // TODO(developer): Replace the file name with your own. const files = DriveApp.getFilesByName('Test'); // Loops through the files and logs the download URLs to the console. while (files.hasNext()) { const file = files.next(); console.log(file.getDownloadUrl()); }
Return
String: Dosyayı indirmek için kullanılabilecek URL.
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan biri veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/drive.readonly -
https://www.googleapis.com/auth/drive
get Editors()
Bu File için düzenleyenlerin listesini alır. Komut dosyasını yürüten kullanıcının File için düzenleme erişimi yoksa bu yöntem boş bir dizi döndürür.
// Gets a list of all files in Google Drive with the given name. // TODO(developer): Replace the file name with your own. const files = DriveApp.getFilesByName('Test'); // Loops through the files. while (files.hasNext()) { const file = files.next(); // Adds the email addresses in the array as editors of each file. // TODO(developer): Replace 'cloudysanfrancisco@gmail.com' // and 'baklavainthebalkans@gmail.com' with valid email addresses. file.addEditors([ 'cloudysanfrancisco@gmail.com', 'baklavainthebalkans@gmail.com', ]); // Gets a list of the file editors. const editors = file.getEditors(); // For each file, logs the editors' email addresses to the console. for (const editor of editors) { console.log(editor.getEmail()); } }
Return
User[]: Kullanıcının bu User[] için düzenleme erişimi varsa düzenleyenlerin listesini döndürür.File Kullanıcının düzenleme erişimi yoksa boş bir dizi döndürür.
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan biri veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/drive.readonly -
https://www.googleapis.com/auth/drive
get Id()
File kimliğini alır.
Return
String: File kimliği
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan biri veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/drive.readonly -
https://www.googleapis.com/auth/drive
get Last Updated()
File öğesinin son güncellendiği tarihi alır.
Return
Date: File son güncellenme tarihi
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan biri veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/drive.readonly -
https://www.googleapis.com/auth/drive
get Mime Type()
Dosyanın MIME türünü alır.
// Gets a list of all files in Google Drive with the given name. // TODO(developer): Replace the file name with your own. const files = DriveApp.getFilesByName('Test'); // Loops through the files and logs the MIME type to the console. while (files.hasNext()) { const file = files.next(); console.log(file.getMimeType()); }
Return
String: Dosyanın MIME türü.
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan biri veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/drive.readonly -
https://www.googleapis.com/auth/drive
get Name()
File öğesinin adını alır.
Return
String: File'nin adı
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan biri veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/drive.readonly -
https://www.googleapis.com/auth/drive
get Owner()
Dosya sahibini alır.
// Gets a list of all files in Google Drive with the given name. // TODO(developer): Replace the file name with your own. const files = DriveApp.getFilesByName('Test'); // Loops through the files and logs the names of the file owners to the console. while (files.hasNext()) { const file = files.next(); console.log(file.getOwner().getName()); }
Return
User: Dosyanın sahibi.
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan biri veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/drive.readonly -
https://www.googleapis.com/auth/drive
get Parents()
File öğesinin doğrudan üst öğeleri olan klasörlerin koleksiyonunu alır.
Return
Folder: File öğesinin doğrudan üst öğeleri olan klasörler koleksiyonu
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan biri veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/drive.readonly -
https://www.googleapis.com/auth/drive
get Resource Key()
Bağlantı kullanılarak paylaşılan öğelere erişmek için gereken File kaynağının anahtarını alır.
Return
String: File kaynağının kaynak anahtarı.
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan biri veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/drive.readonly -
https://www.googleapis.com/auth/drive
get Security Update Eligible()
Bu 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.
Drive, bağlantı kullanılarak paylaşılan bazı dosya veya klasörlere erişmek için kaynak anahtarı gerektirir. Bu değişiklik, bir güvenlik güncellemesinin parçasıdır. Güncelleme, uygun dosyalar ve klasörler için varsayılan olarak etkindir. Uygun dosyalar için kaynak anahtarı zorunluluğunu etkinleştirmek veya devre dışı bırakmak üzere set simgesini kullanın.
Google Drive güvenlik güncellemesi hakkında daha fazla bilgi edinin.
Return
Boolean: Kaynak anahtarı koşulunun File için uygulanıp uygulanamayacağı.
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan biri veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/drive.readonly -
https://www.googleapis.com/auth/drive
get Security Update Enabled()
Bağlantı kullanılarak paylaşıldığında bu File için erişim amacıyla kaynak anahtarı gerekip gerekmediğini alır. Bu koşul, uygun dosyalar ve klasörler için varsayılan olarak etkindir.
Uygun dosyalar için kaynak anahtarı zorunluluğunu etkinleştirmek veya devre dışı bırakmak üzere
setSecurityUpdateEnabled simgesini kullanın.
Google Drive güvenlik güncellemesi hakkında daha fazla bilgi edinin.
Return
Boolean: Bu File için kaynak anahtarı şartının etkin olup olmadığı.
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan biri veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/drive.readonly -
https://www.googleapis.com/auth/drive
get Sharing Access()
Eriş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.
Return
Access — hangi kullanıcı sınıfı File erişebilir?
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan biri veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/drive.readonly -
https://www.googleapis.com/auth/drive
get Sharing Permission()
File 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.
Return
Permission: File öğesine erişebilen kullanıcılara verilen izinler
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan biri veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/drive.readonly -
https://www.googleapis.com/auth/drive
get Size()
Drive'da File öğesini depolamak için kullanılan bayt sayısını alır. Google Workspace uygulama dosyalarının Drive depolama alanı sınırlarına dahil edilmediğini ve bu nedenle 0 bayt döndürdüğünü unutmayın.
Return
Integer: File öğesini Drive'da depolamak için kullanılan bayt sayısı
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan biri veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/drive.readonly -
https://www.googleapis.com/auth/drive
get Target Id()
Bu bir kısayolsa işaret ettiği öğenin kimliğini döndürür.
Aksi takdirde null değeri döndürülür.
// The ID of the file for which to make a shortcut and the ID of // the folder to which you want to add the shortcut. // TODO(developer): Replace the file and folder IDs with your IDs. const fileId = 'abc123456'; const folderId = 'xyz987654'; // Gets the folder to add the shortcut to. const folder = DriveApp.getFolderById(folderId); // Creates a shortcut of the file and moves it to the specified folder. const shortcut = DriveApp.createShortcut(fileId).moveTo(folder); // Logs the target ID of the shortcut. console.log(`${shortcut.getName()}=${shortcut.getTargetId()}`);
Return
String: Hedef öğe kimliği.
get Target Mime Type()
Bu bir kısayolsa işaret ettiği öğenin MIME türünü döndürür.
Aksi takdirde null değeri döndürülür.
// The ID of the file for which to make a shortcut and the ID of // the folder to which you want to add the shortcut. // TODO(developer): Replace the file and folder IDs with your IDs. const fileId = 'abc123456'; const folderId = 'xyz987654'; // Gets the folder to add the shortcut to. const folder = DriveApp.getFolderById(folderId); // Creates a shortcut of the file and moves it to the specified folder. const shortcut = DriveApp.createShortcut(fileId).moveTo(folder); // Logs the MIME type of the file that the shortcut points to. console.log(`MIME type of the shortcut: ${shortcut.getTargetMimeType()}`);
Return
String: Hedef öğenin MIME türü.
get Target Resource Key()
Dosya bir kısayolsa işaret ettiği öğenin kaynak anahtarını döndürür. Kaynak anahtarı, bağlantı kullanılarak paylaşılan dosyalara erişmek için iletmeniz gereken ek bir parametredir.
Dosya kısayol değilse null döndürülür.
// Gets a file by its ID. // TODO(developer): Replace 'abc123456' with your file ID. const file = DriveApp.getFileById('abc123456'); // If the file is a shortcut, returns the resource key of the file that it // points to. console.log(file.getTargetResourceKey());
Return
String: Hedef öğenin kaynak anahtarı veya dosya kısayol değilse null.
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan biri veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/drive.readonly -
https://www.googleapis.com/auth/drive
get Thumbnail()
Dosyanın küçük resmini veya küçük resim yoksa null değerini alır.
// Gets a list of all files in Google Drive with the given name. // TODO(developer): Replace the file name with your own. const files = DriveApp.getFilesByName('Test'); // Loops through the files. while (files.hasNext()) { const file = files.next(); // Logs the thumbnail image for each file to the console as a blob, // or null if no thumbnail exists. console.log(file.getThumbnail()); }
Return
Blob|null: Dosyanın küçük resmi.
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan biri veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/drive.readonly -
https://www.googleapis.com/auth/drive
get Url()
File simgesini Drive veya Dokümanlar gibi bir Google uygulamasında açmak için kullanılabilecek URL'yi alır.
Return
String: Bu File öğesini Drive veya Dokümanlar gibi bir Google uygulamasında görüntülemek için kullanılabilecek URL
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan biri veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/drive.readonly -
https://www.googleapis.com/auth/drive
get Viewers()
Bu File için görüntüleyenlerin ve yorumcuların listesini alır. Komut dosyasını yürüten kullanıcının File için düzenleme erişimi yoksa bu yöntem boş bir dizi döndürür.
// Gets a list of all files in Google Drive with the given name. // TODO(developer): Replace the file name with your own. const files = DriveApp.getFilesByName('Test'); // Loops through the files. while (files.hasNext()) { const file = files.next(); // For each file, logs the viewers' email addresses to the console. const viewers = file.getViewers(); for (const viewer of viewers) { console.log(viewer.getEmail()); } }
Return
User[] — Kullanıcının bu File için düzenleme erişimi varsa görüntüleyenlerin ve yorumcuların listesini döndürür. Kullanıcının düzenleme erişimi yoksa boş bir dizi döndürür.
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan biri veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/drive.readonly -
https://www.googleapis.com/auth/drive
is Starred()
File öğesinin, kullanıcının Drive'ında yıldızlanıp yıldızlanmadığını belirler.
Return
Boolean: File, kullanıcının Drive'ında yıldızlandıysa true, yıldızlanmadıysa false
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan biri veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/drive.readonly -
https://www.googleapis.com/auth/drive
is Trashed()
File öğesinin, kullanıcının Drive çöp kutusunda olup olmadığını belirler.
Return
Boolean — File, kullanıcının Drive çöp kutusundaysa true;
Aksi takdirde false
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan biri veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/drive.readonly -
https://www.googleapis.com/auth/drive
make Copy()
Dosyanın bir kopyasını oluşturur.
// Gets a list of all files in Google Drive with the given name. // TODO(developer): Replace the file name with your own. const files = DriveApp.getFilesByName('Test'); // Loops through the files. while (files.hasNext()) { const file = files.next(); // Creates a copy of each file and logs the file name to the console. console.log(file.makeCopy().getName()); }
Return
File: Yeni kopya.
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan biri veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/drive
make Copy(destination)
Hedef dizinde dosyanın bir kopyasını oluşturur.
// Gets a list of all files in Google Drive with the given name. // TODO(developer): Replace the file name with your own. const files = DriveApp.getFilesByName('Test'); // Loops through the files. while (files.hasNext()) { const file = files.next(); // Creates a copy of each file and adds it to the specified folder. // TODO(developer): Replace the folder ID with your own. const destination = DriveApp.getFolderById('123456abcxyz'); const copiedFile = file.makeCopy(destination); // Logs the file names to the console. console.log(copiedFile.getName()); }
Parametreler
| Ad | Tür | Açıklama |
|---|---|---|
destination | Folder | Dosyanın kopyalanacağı dizin. |
Return
File: Yeni kopya.
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan biri veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/drive
make Copy(name)
Dosyanın bir kopyasını oluşturur ve belirtilen adla adlandırır.
// Gets a list of all files in Google Drive with the given name. // TODO(developer): Replace the file name with your own. const files = DriveApp.getFilesByName('Test'); // Loops through the files. while (files.hasNext()) { const file = files.next(); // Creates a copy of each file and sets the name to 'Test-Copy.' const filename = file.makeCopy('Test-Copy'); // Logs the copied file's name to the console. console.log(filename.getName()); }
Parametreler
| Ad | Tür | Açıklama |
|---|---|---|
name | String | Yeni kopyaya uygulanacak dosya adı. |
Return
File: Yeni kopya.
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan biri veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/drive
make Copy(name, destination)
Hedef dizinde dosyanın bir kopyasını oluşturur ve sağlanan adla adlandırır.
// Gets a list of all files in Google Drive with the given name. // TODO(developer): Replace the file name with your own. const files = DriveApp.getFilesByName('Test'); // Loops through the files. while (files.hasNext()) { const file = files.next(); // Creates a copy of each file, sets the file name, and adds the copied file // to the specified folder. // TODO(developer): Replace the folder ID with your own. const destination = DriveApp.getFolderById('123456abcxyz'); const copiedFile = file.makeCopy('Test-Copy', destination); // Logs the file names to the console. console.log(copiedFile.getName()); }
Parametreler
| Ad | Tür | Açıklama |
|---|---|---|
name | String | Yeni kopyaya uygulanacak dosya adı. |
destination | Folder | Dosyanın kopyalanacağı dizin. |
Return
File: Yeni kopya.
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan biri veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/drive
move To(destination)
Bu öğeyi belirtilen hedef klasöre taşır.
Öğeyi hedef klasöre taşımak için mevcut kullanıcı, dosyanın sahibi olmalı veya öğenin mevcut üst klasörüne en azından düzenleme erişimine sahip olmalıdır.
Parametreler
| Ad | Tür | Açıklama |
|---|---|---|
destination | Folder | Yeni üst klasör olacak klasör. |
Return
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan biri veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/drive
remove Commenter(emailAddress)
Belirtilen kullanıcıyı File için yorum yapanlar listesinden kaldırır. Bu yöntem, genel erişime sahip bir kullanıcı sınıfına ait olmaları durumunda kullanıcıların File erişimini engellemez. Örneğin, File kullanıcının alanının tamamıyla paylaşılıyorsa.
// Gets a list of all files in Google Drive with the given name. // TODO(developer): Replace the file name with your own. const files = DriveApp.getFilesByName('Test'); // Loops through the files. while (files.hasNext()) { const file = files.next(); // Removes the given user from the list of commenters for each file. // TODO(developer): Replace the email with the email of the user you want to // remove. file.removeCommenter('cloudysanfrancisco@gmail.com'); }
Parametreler
| Ad | Tür | Açıklama |
|---|---|---|
email | String | Kaldırılacak kullanıcının e-posta adresi. |
Return
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan biri veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/drive
remove Commenter(user)
Belirtilen kullanıcıyı File için yorum yapanlar listesinden kaldırır. Bu yöntem, genel erişime sahip bir kullanıcı sınıfına ait olmaları durumunda kullanıcıların File erişimini engellemez. Örneğin, File kullanıcının alanının tamamıyla paylaşılıyorsa.
// Gets a list of all files in Google Drive with the given name. // TODO(developer): Replace the file name with your own. const files = DriveApp.getFilesByName('Test'); // Loops through the files. while (files.hasNext()) { const file = files.next(); // Removes the given user from the list of commenters for each file. console.log(file.removeCommenter(Session.getActiveUser())); }
Parametreler
| Ad | Tür | Açıklama |
|---|---|---|
user | User | Kaldırılacak kullanıcının temsili. |
Return
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan biri veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/drive
remove Editor(emailAddress)
Belirtilen kullanıcıyı File için düzenleyenler listesinden kaldırır. Bu yöntem, genel erişime sahip bir kullanıcı sınıfına ait olmaları durumunda kullanıcıların File erişmesini engellemez. Örneğin, File kullanıcının alanının tamamıyla paylaşılıyorsa veya File, kullanıcının erişebileceği bir ortak Drive'daysa.
Drive dosyaları için bu işlem, kullanıcıyı görüntüleyenler listesinden de kaldırır.
Parametreler
| Ad | Tür | Açıklama |
|---|---|---|
email | String | Kaldırılacak kullanıcının e-posta adresi. |
Return
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan biri veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/drive
remove Editor(user)
Belirtilen kullanıcıyı File için düzenleyenler listesinden kaldırır. Bu yöntem, genel erişime sahip bir kullanıcı sınıfına ait olmaları durumunda kullanıcıların File erişmesini engellemez. Örneğin, File kullanıcının alanının tamamıyla paylaşılıyorsa veya File, kullanıcının erişebileceği bir ortak Drive'daysa.
Drive dosyaları için bu işlem, kullanıcıyı görüntüleyenler listesinden de kaldırır.
Parametreler
| Ad | Tür | Açıklama |
|---|---|---|
user | User | Kaldırılacak kullanıcının temsili. |
Return
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan biri veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/drive
remove Viewer(emailAddress)
Belirtilen kullanıcıyı File için izleyici ve yorumcu listesinden kaldırır. Bu yöntem, kullanıcı görüntüleyici veya yorumcu değil de düzenleyiciyse etkili olmaz. Bu yöntem, genel erişime sahip bir kullanıcı sınıfına ait olmaları durumunda kullanıcıların File erişimini de engellemez. Örneğin, File kullanıcının alanının tamamıyla paylaşılıyorsa veya File, kullanıcının erişebileceği bir ortak Drive'daysa.
Drive dosyaları için bu işlem, kullanıcıyı düzenleyenler listesinden de kaldırır.
Parametreler
| Ad | Tür | Açıklama |
|---|---|---|
email | String | Kaldırılacak kullanıcının e-posta adresi. |
Return
File: Bu, zincirleme için File.
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan biri veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/drive
remove Viewer(user)
Belirtilen kullanıcıyı File için izleyici ve yorumcu listesinden kaldırır. Bu yöntem, kullanıcı görüntüleyici değil düzenleyiciyse etkili olmaz. Bu yöntem, genel erişime sahip bir kullanıcı sınıfına ait olmaları durumunda kullanıcıların File erişimini de engellemez. Örneğin, File kullanıcının alanının tamamıyla paylaşılıyorsa veya File kullanıcının erişebileceği bir ortak Drive'da bulunuyorsa.
Drive dosyaları için bu işlem, kullanıcıyı düzenleyenler listesinden de kaldırır.
Parametreler
| Ad | Tür | Açıklama |
|---|---|---|
user | User | Kaldırılacak kullanıcının temsili. |
Return
File: Bu, zincirleme için File.
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan biri veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/drive
revoke Permissions(emailAddress)
Belirli bir kullanıcıya verilen File erişimini iptal eder. Bu yöntem, genel erişime sahip bir kullanıcı sınıfına ait olmaları durumunda kullanıcıların File hizmetine erişmesini engellemez. Örneğin, File hizmeti kullanıcının alanının tamamıyla paylaşılıyorsa bu durum geçerlidir.
Parametreler
| Ad | Tür | Açıklama |
|---|---|---|
email | String | Erişimi iptal edilecek kullanıcının e-posta adresi. |
Return
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan biri veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/drive
revoke Permissions(user)
Belirli bir kullanıcıya verilen File erişimini iptal eder. Bu yöntem, genel erişime sahip bir kullanıcı sınıfına ait olmaları durumunda kullanıcıların File hizmetine erişmesini engellemez. Örneğin, File hizmeti kullanıcının alanının tamamıyla paylaşılıyorsa bu durum geçerlidir.
Parametreler
| Ad | Tür | Açıklama |
|---|---|---|
user | User | Erişimi iptal edilecek kullanıcının temsili. |
Return
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan biri veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/drive
set Content(content)
Dosyanın içeriğini belirli bir değiştirme işlemiyle üzerine yazar. content 10 MB'tan büyükse istisna oluşturur.
// Creates a text file with the content 'Hello, world!' const file = DriveApp.createFile('New Text File', 'Hello, world!'); // Logs the content of the text file to the console. console.log(file.getBlob().getDataAsString()); // Updates the content of the text file to 'Updated text!' file.setContent('Updated text!'); // Logs content of the text file to the console. console.log(file.getBlob().getDataAsString());
Parametreler
| Ad | Tür | Açıklama |
|---|---|---|
content | String | Dosyanın yeni içeriği. |
Return
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan biri veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/drive
set Description(description)
File için açıklamayı ayarlar.
Parametreler
| Ad | Tür | Açıklama |
|---|---|---|
description | String | File için yeni açıklama |
Return
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan biri veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/drive
set Name(name)
File adını ayarlar.
Parametreler
| Ad | Tür | Açıklama |
|---|---|---|
name | String | File adlı uygulamanın yeni adı |
Return
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan biri veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/drive
set Owner(emailAddress)
File öğesinin sahibini değiştirir. Bu yöntem, önceki sahibe File için açıkça düzenleme erişimi de verir.
Parametreler
| Ad | Tür | Açıklama |
|---|---|---|
email | String | Yeni sahip olacak kullanıcının e-posta adresi |
Return
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan biri veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/drive
set Owner(user)
File öğesinin sahibini değiştirir. Bu yöntem, önceki sahibe File için açıkça düzenleme erişimi de verir.
Parametreler
| Ad | Tür | Açıklama |
|---|---|---|
user | User | Yeni sahip olması gereken kullanıcının temsili |
Return
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan biri veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/drive
set Security Update Enabled(enabled)
File, bağlantı kullanılarak paylaşıldığında erişim için kaynak anahtarı gerektirip gerektirmediğini ayarlar. Uygun dosya ve klasörler varsayılan olarak etkindir.
Google Drive güvenlik güncellemesi hakkında daha fazla bilgi edinin.
Parametreler
| Ad | Tür | Açıklama |
|---|---|---|
enabled | Boolean | File için kaynak anahtarı şartının etkinleştirilip etkinleştirilmeyeceği. |
Return
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan biri veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/drive
set Sharing(accessType, permissionType)
File'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.
// Creates a folder that anyone on the Internet can read from and write to. // (Domain administrators can prohibit this setting for users of a Google // Workspace domain.) const folder = DriveApp.createFolder('Shared Folder'); folder.setSharing(DriveApp.Access.ANYONE, DriveApp.Permission.EDIT);
Parametreler
| Ad | Tür | Açıklama |
|---|---|---|
access | Access | Hangi kullanıcı sınıfı File erişebilmelidir? |
permission | Permission | File erişebilen kullanıcılara verilmesi gereken izinler |
Return
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan biri veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/drive
set Starred(starred)
File öğesinin kullanıcının Drive'ında yıldızlanıp yıldızlanmayacağını ayarlar. Yeni File'ler için varsayılan değer false'dir.
Parametreler
| Ad | Tür | Açıklama |
|---|---|---|
starred | Boolean | File, kullanıcının Drive'ında yıldızlanacaksa true; aksi takdirde false |
Return
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan biri veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/drive
set Trashed(trashed)
File öğesinin, kullanıcının Drive çöp kutusunda olup olmayacağını ayarlar. File yalnızca sahibi silebilir. Yeni File'ler için varsayılan değer false'dir.
Parametreler
| Ad | Tür | Açıklama |
|---|---|---|
trashed | Boolean | true, File kullanıcının Drive çöp kutusuna taşınacaksa; false, taşınmayacaksa |
Return
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan biri veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/drive