Google Drive'daki bir dosya. Dosyalara Drive
'ten erişilebilir veya dosya 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 yorumcu listesine ekleyin. |
add | File | Belirtilen kullanıcıyı File için yorumcu listesine ekleyin. |
add | File | Belirtilen kullanıcı dizisini File için yorumcuların listesine ekleyin. |
add | File | Belirtilen kullanıcıyı File için düzenleyiciler listesine ekler. |
add | File | Belirtilen kullanıcıyı File için düzenleyiciler listesine ekler. |
add | File | Belirtilen kullanıcı dizisini File için düzenleyiciler listesine ekler. |
add | File | Belirtilen kullanıcıyı File için izleyiciler listesine ekler. |
add | File | Belirtilen kullanıcıyı File için izleyiciler listesine ekler. |
add | File | Belirtilen kullanıcı dizisini File için izleyici 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ürme. |
get | Blob | Bu nesnenin içindeki verileri bir blob olarak döndürme. |
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 öğesinin 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 | Dosyanın sahibini alır. |
get | Folder | File klasörünün doğrudan üst klasörlerini içeren bir koleksiyon 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 '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. |
get | Boolean | Bu File 'ün, bağlantı kullanılarak paylaşıldığında erişim için kaynak anahtarı gerektirip gerektirmediğini alır. |
get | 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. |
get | 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. |
get | Integer | File öğesini Drive'da 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 | Dosyanın küçük resmini alır veya küçük resim yoksa null değerini döndürür. |
get | String | File dosyasını 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 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. |
is | Boolean | File öğesinin kullanıcının Drive'ında yıldızla işaretlenip işaretlenmediğini belirler. |
is | Boolean | File öğesinin, kullanıcının Drive'ındaki çöp kutusuna ait olup olmadığını belirler. |
make | File | Dosyanın bir kopyasını oluşturur. |
make | File | Dosyanın hedef dizinde bir kopyasını oluşturur. |
make | File | Dosyanın bir kopyasını oluşturur ve dosyayı sağlanan adla adlandırır. |
make | File | Hedef dizinde dosyanın bir kopyasını oluşturur ve dosyaya belirtilen adı verir. |
move | File | Bu öğeyi, belirtilen hedef klasöre taşır. |
remove | File | Belirtilen kullanıcıyı File için yorumcu listesinden kaldırır. |
remove | File | Belirtilen kullanıcıyı File için yorumcu 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 görüntüleyen ve yorum yapanlar listesinden kaldırır. |
remove | File | Belirtilen kullanıcıyı File için görüntüleyen ve yorum yapanlar 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ğinin üzerine belirli bir değiştirmeyle yazılır. |
set | File | File öğesinin açıklamasını belirler. |
set | File | File değerinin adını belirler. |
set | File | File öğesinin sahibini değiştirir. |
set | File | File öğesinin sahibini değiştirir. |
set | File | File 'ün, bağlantı kullanılarak paylaşıldığında erişim için kaynak anahtarı gerektirip gerektirmeyeceğini belirler. |
set | 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. |
set | 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. |
set | File | File öğesinin kullanıcının Drive'ında yıldızla işaretlenip işaretlenmeyeceğini belirler. |
set | File | File öğesinin, kullanıcının Drive'ındaki çöp kutusuna ait olup olmadığını belirler. |
Ayrıntılı dokümanlar
add Commenter(emailAddress)
Belirtilen kullanıcıyı File
için yorumcu listesine ekleyin. Kullanıcı zaten izleyici listesindeyse bu yöntem, kullanıcıyı izleyici listesinden çıkarır.
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
File
: Zincirleme için bu File
.
Yetkilendirme
Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:
-
https://www.googleapis.com/auth/drive
add Commenter(user)
Belirtilen kullanıcıyı File
için yorumcu listesine ekleyin. Kullanıcı zaten izleyici listesindeyse bu yöntem, kullanıcıyı izleyici 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'); // 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
File
: Zincirleme için bu File
.
Yetkilendirme
Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:
-
https://www.googleapis.com/auth/drive
add Commenters(emailAddresses)
Belirtilen kullanıcı dizisini File
için yorumcuların listesine ekleyin. Halihazırda izleyici listesinde olan kullanıcılar bu yöntemle izleyici listesinden çıkarılı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 adresleri dizisi. |
Return
File
: Zincirleme için bu File
.
Yetkilendirme
Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:
-
https://www.googleapis.com/auth/drive
add Editor(emailAddress)
Belirtilen kullanıcıyı File
için düzenleyiciler listesine ekler. Kullanıcı zaten izleyici listesindeyse bu yöntem, kullanıcıyı izleyici listesinden çıkarır.
Parametreler
Ad | Tür | Açıklama |
---|---|---|
email | String | Eklenecek kullanıcının e-posta adresi. |
Return
File
: Zincirleme için bu File
.
Yetkilendirme
Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:
-
https://www.googleapis.com/auth/drive
add Editor(user)
Belirtilen kullanıcıyı File
için düzenleyiciler listesine ekler. Kullanıcı zaten izleyici listesindeyse bu yöntem, kullanıcıyı izleyici listesinden çıkarır.
Parametreler
Ad | Tür | Açıklama |
---|---|---|
user | User | Eklenecek kullanıcının temsili. |
Return
File
: Zincirleme için bu File
.
Yetkilendirme
Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:
-
https://www.googleapis.com/auth/drive
add Editors(emailAddresses)
Belirtilen kullanıcı dizisini File
için düzenleyiciler listesine ekler. Kullanıcılardan herhangi biri zaten izleyici listesindeyse bu yöntem, kullanıcıları izleyici listesinden çıkarır.
Parametreler
Ad | Tür | Açıklama |
---|---|---|
email | String[] | Eklenecek kullanıcıların e-posta adresleri dizisi. |
Return
File
: Zincirleme için bu File
.
Yetkilendirme
Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:
-
https://www.googleapis.com/auth/drive
add Viewer(emailAddress)
Belirtilen kullanıcıyı File
için izleyiciler listesine ekler. Kullanıcı zaten düzenleyiciler listesindeyse bu yöntemin etkisi olmaz.
Parametreler
Ad | Tür | Açıklama |
---|---|---|
email | String | Eklenecek kullanıcının e-posta adresi. |
Return
File
: Zincirleme için bu File
.
Yetkilendirme
Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:
-
https://www.googleapis.com/auth/drive
add Viewer(user)
Belirtilen kullanıcıyı File
için izleyiciler listesine ekler. Kullanıcı zaten düzenleyiciler listesindeyse bu yöntemin etkisi olmaz.
Parametreler
Ad | Tür | Açıklama |
---|---|---|
user | User | Eklenecek kullanıcının temsili. |
Return
File
: Zincirleme için bu File
.
Yetkilendirme
Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:
-
https://www.googleapis.com/auth/drive
add Viewers(emailAddresses)
Belirtilen kullanıcı dizisini File
için izleyici listesine ekler. Kullanıcılardan herhangi biri zaten düzenleyiciler listesindeyse bu yöntemin bu kullanıcılar üzerinde herhangi bir etkisi olmaz.
Parametreler
Ad | Tür | Açıklama |
---|---|---|
email | String[] | Eklenecek kullanıcıların e-posta adresleri dizisi. |
Return
File
: Zincirleme için bu File
.
Yetkilendirme
Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:
-
https://www.googleapis.com/auth/drive
get Access(email)
Belirli bir kullanıcıya verilen izni alır. Bu yöntem, bir Google grubuna ait izinleri veya Google Gruplar aracılığıyla devralınan izinleri döndürmeyi desteklemez.
Parametreler
Ad | Tür | Açıklama |
---|---|---|
email | String | İzinlerinin kontrol edilmesi gereken kullanıcının e-posta adresi. Google Gruplar desteklenmez. |
Return
Permission
: Kullanıcıya verilen izinler.
Yetkilendirme
Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:
-
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, bir Google grubuna ait izinleri veya Google Gruplar aracılığıyla devralınan izinleri döndürmeyi desteklemez.
Parametreler
Ad | Tür | Açıklama |
---|---|---|
user | User | İzinlerinin kontrol edilmesi gereken kullanıcının temsili. |
Return
Permission
: Kullanıcıya verilen izinler.
Yetkilendirme
Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:
-
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ürme. Bu yöntem, dosya adına uygun uzantıyı ekler (ör. "dosyam.pdf"). Ancak, dosya adının son noktayı (varsa) izleyen kısmının, değiştirilmesi gereken mevcut bir uzantı olduğu varsayılır. Sonuç olarak, "AlışverişListesi.25.12.2014", "AlışverişListesi.25.12.pdf" olur.
Dönüşümler için günlük kotaları görüntülemek istiyorsanız Google Hizmetleri için 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 'application/pdf' tek geçerli seçenektir. BMP, GIF, JPEG veya PNG biçimindeki resimler için 'image/bmp' , 'image/gif' , 'image/jpeg' veya 'image/png' değerlerinden herhangi biri de geçerlidir. Google Dokümanlar dokümanı için 'text/markdown' de geçerlidir. |
Return
Blob
: Veriler bir 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ının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:
-
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ının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:
-
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 dosyayı Google Drive'da açma izni olan kullanıcılar erişebilir. Dosyayı indirmek için tarayıcıda bu URL'yi kullanabilirsiniz ancak Url
ile dosyayı almak için kullanamazsınız. Dosyanın içeriğinin komut dosyasında olması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ının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:
-
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 File
için düzenleme erişimi varsa düzenleyicilerin listesini döndürür. Kullanıcının düzenleme erişimi yoksa boş bir dizi döndürülür.
Yetkilendirme
Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:
-
https://www.googleapis.com/auth/drive.readonly
-
https://www.googleapis.com/auth/drive
get Id()
File
öğesinin kimliğini alır.
Return
String
: File
öğesinin kimliği
Yetkilendirme
Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:
-
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
'un son güncellendiği tarih
Yetkilendirme
Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:
-
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ının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:
-
https://www.googleapis.com/auth/drive.readonly
-
https://www.googleapis.com/auth/drive
get Name()
File
öğesinin adını alır.
Return
String
: File
öğesinin adı
Yetkilendirme
Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:
-
https://www.googleapis.com/auth/drive.readonly
-
https://www.googleapis.com/auth/drive
get Owner()
Dosyanın 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ının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:
-
https://www.googleapis.com/auth/drive.readonly
-
https://www.googleapis.com/auth/drive
get Parents()
File
klasörünün doğrudan üst klasörlerini içeren bir koleksiyon alır.
Return
Folder
: File
klasörünün doğrudan üst klasörlerini içeren bir klasör koleksiyonu
Yetkilendirme
Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:
-
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
öğesinin kaynak anahtarı.
Yetkilendirme
Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:
-
https://www.googleapis.com/auth/drive.readonly
-
https://www.googleapis.com/auth/drive
get Security Update Eligible()
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.
Drive, bağlantı kullanılarak paylaşılan bazı dosyalara 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ı koşulunu 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ğını belirtir.
Yetkilendirme
Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:
-
https://www.googleapis.com/auth/drive.readonly
-
https://www.googleapis.com/auth/drive
get Security Update Enabled()
Bu File
'ün, bağlantı kullanılarak paylaşıldığında erişim için kaynak anahtarı gerektirip gerektirmediğini alır. Bu şart, uygun dosya ve klasörler için varsayılan olarak etkindir.
Uygun dosyalar için kaynak anahtarı koşulunu 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
: Kaynak anahtarı koşulunun bu File
için etkin olup olmadığı.
Yetkilendirme
Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:
-
https://www.googleapis.com/auth/drive.readonly
-
https://www.googleapis.com/auth/drive
get Sharing Access()
Açıkça erişim izni verilen kullanıcıların yanı sıra File
'e hangi kullanıcı sınıfının erişebileceğini alır.
Return
Access
: File
'a hangi kullanıcı sınıfının erişebileceği
Yetkilendirme
Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:
-
https://www.googleapis.com/auth/drive.readonly
-
https://www.googleapis.com/auth/drive
get Sharing 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.
Return
Permission
: File
'a erişebilen kullanıcılara verilen izinler
Yetkilendirme
Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:
-
https://www.googleapis.com/auth/drive.readonly
-
https://www.googleapis.com/auth/drive
get Size()
File
öğesini Drive'da depolamak için kullanılan bayt sayısını alır. Google Workspace uygulama dosyalarının Drive depolama alanı sınırlarında hesaba katılmadığını ve bu nedenle 0
bayt döndürdüğünü unutmayın.
Return
Integer
: File
öğesinin Drive'da depolanması için kullanılan bayt sayısı
Yetkilendirme
Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:
-
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
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
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ının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:
-
https://www.googleapis.com/auth/drive.readonly
-
https://www.googleapis.com/auth/drive
get Thumbnail()
Dosyanın küçük resmini alır veya küçük resim yoksa null
değerini 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(); // 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
: Dosyanın küçük resmi.
Yetkilendirme
Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:
-
https://www.googleapis.com/auth/drive.readonly
-
https://www.googleapis.com/auth/drive
get Url()
File
dosyasını Drive veya Dokümanlar gibi bir Google uygulamasında açmak için kullanılabilecek URL'yi alır.
Return
String
: Drive veya Dokümanlar gibi bir Google uygulamasında bu File
'yi görüntülemek için kullanılabilecek URL
Yetkilendirme
Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:
-
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ının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:
-
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ızla işaretlenip işaretlenmediğini belirler.
Return
Boolean
: File
, kullanıcının Drive'ında yıldızlandıysa true
, aksi takdirde false
Yetkilendirme
Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:
-
https://www.googleapis.com/auth/drive.readonly
-
https://www.googleapis.com/auth/drive
is Trashed()
File
öğesinin, kullanıcının Drive'ındaki çöp kutusuna ait olup olmadığını belirler.
Return
Boolean
: File
, kullanıcının Drive'ının çöp kutusundaysa true
; aksi takdirde false
Yetkilendirme
Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:
-
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ının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:
-
https://www.googleapis.com/auth/drive
make Copy(destination)
Dosyanın hedef dizinde 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ının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:
-
https://www.googleapis.com/auth/drive
make Copy(name)
Dosyanın bir kopyasını oluşturur ve dosyayı 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 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 uygulanması gereken dosya adı. |
Return
File
: Yeni kopya.
Yetkilendirme
Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:
-
https://www.googleapis.com/auth/drive
make Copy(name, destination)
Hedef dizinde dosyanın bir kopyasını oluşturur ve dosyaya belirtilen adı verir.
// 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 uygulanması gereken dosya adı. |
destination | Folder | Dosyanın kopyalanacağı dizin. |
Return
File
: Yeni kopya.
Yetkilendirme
Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:
-
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ının, dosyanın sahibi olması veya öğenin mevcut üst klasörüne en azından düzenleme erişimi olması gerekir.
Parametreler
Ad | Tür | Açıklama |
---|---|---|
destination | Folder | Yeni üst klasör olacak klasör. |
Return
File
: Zincirleme için bu File
.
Yetkilendirme
Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:
-
https://www.googleapis.com/auth/drive
remove Commenter(emailAddress)
Belirtilen kullanıcıyı File
için yorumcu listesinden kaldırır. Bu yöntem, genel erişime sahip bir kullanıcı sınıfına ait kullanıcıların File
'e erişimini engellemez. Örneğin, File
kullanıcının tüm alanı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
File
: Zincirleme için bu File
.
Yetkilendirme
Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:
-
https://www.googleapis.com/auth/drive
remove Commenter(user)
Belirtilen kullanıcıyı File
için yorumcu listesinden kaldırır. Bu yöntem, genel erişime sahip bir kullanıcı sınıfına ait kullanıcıların File
'e erişimini engellemez. Örneğin, File
kullanıcının tüm alanı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
File
: Zincirleme için bu File
.
Yetkilendirme
Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:
-
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 olan kullanıcıların File
'e erişimini engellemez. Örneğin, File
kullanıcının alanının tamamıyla paylaşılıyorsa veya File
, kullanıcının erişebildiği bir ortak Drive'da bulunuyorsa.
Drive dosyaları için bu işlem, kullanıcıyı görüntüleyen kullanıcılar 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
: Zincirleme için bu File
.
Yetkilendirme
Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:
-
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 olan kullanıcıların File
'e erişimini engellemez. Örneğin, File
kullanıcının alanının tamamıyla paylaşılıyorsa veya File
, kullanıcının erişebildiği bir ortak Drive'da bulunuyorsa.
Drive dosyaları için bu işlem, kullanıcıyı görüntüleyen kullanıcılar listesinden de kaldırır.
Parametreler
Ad | Tür | Açıklama |
---|---|---|
user | User | Kaldırılacak kullanıcının temsili. |
Return
File
: Zincirleme için bu File
.
Yetkilendirme
Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:
-
https://www.googleapis.com/auth/drive
remove Viewer(emailAddress)
Belirtilen kullanıcıyı File
için görüntüleyen ve yorum yapanlar listesinden kaldırır. Kullanıcı izleyici veya yorumcu değilse bu yöntemin hiçbir etkisi yoktur. Bu yöntem, genel erişime sahip bir kullanıcı sınıfına ait kullanıcıların File
'e erişmesini de engellemez. Örneğin, File
kullanıcının alanının tamamıyla paylaşılıyorsa veya File
kullanıcının erişebildiği bir ortak Drive'da bulunuyorsa.
Drive dosyaları için bu işlem, kullanıcıyı düzenleyiciler 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
: Zincirleme için bu File
.
Yetkilendirme
Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:
-
https://www.googleapis.com/auth/drive
remove Viewer(user)
Belirtilen kullanıcıyı File
için görüntüleyen ve yorum yapanlar listesinden kaldırır. Kullanıcı izleyici değil de düzenleyiciyse bu yöntemin hiçbir etkisi olmaz. Bu yöntem, genel erişime sahip bir kullanıcı sınıfına ait kullanıcıların File
'e 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şebildiği bir ortak Drive'da bulunuyorsa.
Drive dosyaları için bu işlem, kullanıcıyı düzenleyiciler listesinden de kaldırır.
Parametreler
Ad | Tür | Açıklama |
---|---|---|
user | User | Kaldırılacak kullanıcının temsili. |
Return
File
: Zincirleme için bu File
.
Yetkilendirme
Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:
-
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 kullanıcıların File
'e erişimini engellemez. Örneğin, File
kullanıcının alanının tamamıyla paylaşılıyorsa.
Parametreler
Ad | Tür | Açıklama |
---|---|---|
email | String | Erişimi iptal edilecek kullanıcının e-posta adresi. |
Return
File
: Zincirleme için bu File
.
Yetkilendirme
Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:
-
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 kullanıcıların File
'e erişimini engellemez. Örneğin, File
kullanıcının alanının tamamıyla paylaşılıyorsa.
Parametreler
Ad | Tür | Açıklama |
---|---|---|
user | User | Erişimi iptal edilmesi gereken kullanıcının temsili. |
Return
File
: Zincirleme için bu File
.
Yetkilendirme
Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:
-
https://www.googleapis.com/auth/drive
set Content(content)
Dosyanın içeriğinin üzerine, belirtilen değiştirmeyle yazılır. content
10 MB'tan büyükse istisna atar.
// 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
File
: Zincirleme için bu File
.
Yetkilendirme
Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:
-
https://www.googleapis.com/auth/drive
set Description(description)
File
öğesinin açıklamasını belirler.
Parametreler
Ad | Tür | Açıklama |
---|---|---|
description | String | File için yeni açıklama |
Return
Yetkilendirme
Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:
-
https://www.googleapis.com/auth/drive
set Name(name)
File
değerinin adını belirler.
Parametreler
Ad | Tür | Açıklama |
---|---|---|
name | String | File öğesinin yeni adı |
Return
Yetkilendirme
Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:
-
https://www.googleapis.com/auth/drive
set Owner(emailAddress)
File
öğesinin sahibini değiştirir. Bu yöntem, önceki sahibine File
için açık düzenleme erişimi de verir.
Parametreler
Ad | Tür | Açıklama |
---|---|---|
email | String | Yeni sahip olması gereken kullanıcının e-posta adresi |
Return
Yetkilendirme
Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:
-
https://www.googleapis.com/auth/drive
set Owner(user)
File
öğesinin sahibini değiştirir. Bu yöntem, önceki sahibine File
için açık 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ının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:
-
https://www.googleapis.com/auth/drive
set Security Update Enabled(enabled)
File
'ün, bağlantı kullanılarak paylaşıldığında erişim için kaynak anahtarı gerektirip gerektirmeyeceğini belirler. 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ı koşulunun etkinleştirilip etkinleştirilmeyeceği. |
Return
File
: Zincirleme için bu File
.
Yetkilendirme
Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:
-
https://www.googleapis.com/auth/drive
set Sharing(accessType, permissionType)
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.
// 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 | File |
permission | Permission | File 'e erişebilen kullanıcılara verilmesi gereken izinler |
Return
Yetkilendirme
Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:
-
https://www.googleapis.com/auth/drive
set Starred(starred)
File
öğesinin kullanıcının Drive'ında yıldızla işaretlenip işaretlenmeyeceğini belirler. Yeni File
'ler için varsayılan değer false
'dur.
Parametreler
Ad | Tür | Açıklama |
---|---|---|
starred | Boolean | File , kullanıcının Drive'ında yıldızlanmalıdır (true ) veya yıldızlanmamalıdır (false ). |
Return
Yetkilendirme
Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:
-
https://www.googleapis.com/auth/drive
set Trashed(trashed)
File
öğesinin, kullanıcının Drive'ındaki çöp kutusuna ait olup olmadığını belirler. File
öğesini yalnızca sahibi çöp kutusuna gönderebilir. Yeni File
'ler için varsayılan değer false
'tur.
Parametreler
Ad | Tür | Açıklama |
---|---|---|
trashed | Boolean | File , kullanıcının Drive'ının çöp kutusuna taşınacaksa true ; aksi takdirde false |
Return
Yetkilendirme
Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:
-
https://www.googleapis.com/auth/drive