Google Drive'daki bir klasör. Klasörlere DriveApp
'ten erişilebilir veya klasör oluşturulabilir.
// Log the name of every folder in the user's Drive. const folders = DriveApp.getFolders(); while (folders.hasNext()) { const folder = folders.next(); Logger.log(folder.getName()); }
Yöntemler
Yöntem | Dönüş türü | Kısa açıklama |
---|---|---|
addEditor(emailAddress) | Folder | Belirtilen kullanıcıyı Folder için düzenleyiciler listesine ekler. |
addEditor(user) | Folder | Belirtilen kullanıcıyı Folder için düzenleyiciler listesine ekler. |
addEditors(emailAddresses) | Folder | Belirtilen kullanıcı dizisini Folder için düzenleyiciler listesine ekler. |
addViewer(emailAddress) | Folder | Belirtilen kullanıcıyı Folder için izleyiciler listesine ekler. |
addViewer(user) | Folder | Belirtilen kullanıcıyı Folder için izleyiciler listesine ekler. |
addViewers(emailAddresses) | Folder | Belirtilen kullanıcı dizisini Folder için izleyici listesine ekler. |
createFile(blob) | File | Belirli bir Blob rastgele verisinden geçerli klasörde bir dosya oluşturur. |
createFile(name, content) | File | Geçerli klasörde, belirtilen ada ve içeriğe sahip bir metin dosyası oluşturur. |
createFile(name, content, mimeType) | File | Geçerli klasörde, belirtilen ada, içeriğe ve MIME türüne sahip bir dosya oluşturur. |
createFolder(name) | Folder | Geçerli klasörde belirtilen ada sahip bir klasör oluşturur. |
createShortcut(targetId) | File | Sağlanan Drive öğe kimliğinin kısayolunu oluşturur ve döndürür. |
createShortcutForTargetIdAndResourceKey(targetId, targetResourceKey) | File | Sağlanan Drive öğe kimliğinin ve kaynak anahtarının kısayolunu oluşturup döndürür. |
getAccess(email) | Permission | Belirli bir kullanıcıya verilen izni alır. |
getAccess(user) | Permission | Belirli bir kullanıcıya verilen izni alır. |
getDateCreated() | Date | Folder öğesinin oluşturulduğu tarihi alır. |
getDescription() | String | Folder öğesinin açıklamasını alır. |
getEditors() | User[] | Bu Folder için düzenleyenlerin listesini alır. |
getFiles() | FileIterator | Geçerli klasörün alt öğeleri olan tüm dosyaların koleksiyonunu alır. |
getFilesByName(name) | FileIterator | Mevcut klasörün alt öğeleri olan ve belirtilen ada sahip tüm dosyaların koleksiyonunu alır. |
getFilesByType(mimeType) | FileIterator | Mevcut klasörün alt öğeleri olan ve belirtilen MIME türüne sahip tüm dosyaların koleksiyonunu alır. |
getFolders() | FolderIterator | Geçerli klasörün alt klasörlerinin tümünü içeren bir koleksiyon alır. |
getFoldersByName(name) | FolderIterator | Mevcut klasörün alt öğeleri olan ve belirtilen ada sahip tüm klasörlerin koleksiyonunu alır. |
getId() | String | Folder öğesinin kimliğini alır. |
getLastUpdated() | Date | Folder öğesinin son güncellendiği tarihi alır. |
getName() | String | Folder öğesinin adını alır. |
getOwner() | User | Bu Folder öğesinin sahibini alır. |
getParents() | FolderIterator | Folder klasörünün doğrudan üst klasörlerini içeren bir koleksiyon alır. |
getResourceKey() | String | Bağlantı kullanılarak paylaşılan öğelere erişmek için gereken Folder kaynağının anahtarını alır. |
getSecurityUpdateEligible() | Boolean | Bu Folder 'nin, bağlantı kullanılarak paylaşıldığında erişim için kaynak anahtarı gerektiren güvenlik güncellemesini uygulamaya uygun olup olmadığını alır. |
getSecurityUpdateEnabled() | Boolean | Bu Folder 'ün, bağlantı kullanılarak paylaşıldığında erişim için kaynak anahtarı gerektirip gerektirmediğini alır. |
getSharingAccess() | Access | Açıkça erişim izni verilen kullanıcıların yanı sıra Folder 'ye hangi kullanıcı sınıfının erişebileceğini alır. |
getSharingPermission() | Permission | Açıkça erişim izni verilen kullanıcıların yanı sıra Folder 'e erişebilen kullanıcılara verilen izni alır. |
getSize() | Integer | Folder öğesini Drive'da depolamak için kullanılan bayt sayısını alır. |
getUrl() | String | Folder dosyasını Drive veya Dokümanlar gibi bir Google uygulamasında açmak için kullanılabilecek URL'yi alır. |
getViewers() | User[] | Bu Folder için görüntüleyenlerin ve yorumcuların listesini alır. |
isShareableByEditors() | Boolean | Folder için düzenleme izinlerine sahip kullanıcıların diğer kullanıcılarla paylaşma veya izinleri değiştirme izni olup olmadığını belirler. |
isStarred() | Boolean | Folder öğesinin kullanıcının Drive'ında yıldızla işaretlenip işaretlenmediğini belirler. |
isTrashed() | Boolean | Folder öğesinin, kullanıcının Drive'ındaki çöp kutusuna ait olup olmadığını belirler. |
moveTo(destination) | Folder | Bu öğeyi, belirtilen hedef klasöre taşır. |
removeEditor(emailAddress) | Folder | Belirtilen kullanıcıyı Folder için düzenleyenler listesinden kaldırır. |
removeEditor(user) | Folder | Belirtilen kullanıcıyı Folder için düzenleyenler listesinden kaldırır. |
removeViewer(emailAddress) | Folder | Belirtilen kullanıcıyı Folder için görüntüleyen ve yorum yapanlar listesinden kaldırır. |
removeViewer(user) | Folder | Belirtilen kullanıcıyı Folder için görüntüleyen ve yorum yapanlar listesinden kaldırır. |
revokePermissions(emailAddress) | Folder | Belirli bir kullanıcıya verilen Folder erişimini iptal eder. |
revokePermissions(user) | Folder | Belirli bir kullanıcıya verilen Folder erişimini iptal eder. |
searchFiles(params) | FileIterator | Geçerli klasörün alt öğeleri olan ve belirtilen arama ölçütleriyle eşleşen tüm dosyaların koleksiyonunu alır. |
searchFolders(params) | FolderIterator | Geçerli klasörün alt klasörü olan ve belirtilen arama ölçütleriyle eşleşen tüm klasörlerin koleksiyonunu alır. |
setDescription(description) | Folder | Folder öğesinin açıklamasını belirler. |
setName(name) | Folder | Folder değerinin adını belirler. |
setOwner(emailAddress) | Folder | Folder öğesinin sahibini değiştirir. |
setOwner(user) | Folder | Folder öğesinin sahibini değiştirir. |
setSecurityUpdateEnabled(enabled) | Folder | Folder 'ün, bağlantı kullanılarak paylaşıldığında erişim için kaynak anahtarı gerektirip gerektirmeyeceğini belirler. |
setShareableByEditors(shareable) | Folder | Folder için düzenleme izinlerine sahip kullanıcıların diğer kullanıcılarla paylaşma veya izinleri değiştirme izni olup olmadığını belirler. |
setSharing(accessType, permissionType) | Folder | Açıkça erişim izni verilen kullanıcıların yanı sıra Folder 'ye hangi kullanıcı sınıfının erişebileceğini ve bu kullanıcılara hangi izinlerin verileceğini belirler. |
setStarred(starred) | Folder | Folder öğesinin kullanıcının Drive'ında yıldızla işaretlenip işaretlenmeyeceğini belirler. |
setTrashed(trashed) | Folder | Folder öğesinin, kullanıcının Drive'ındaki çöp kutusuna ait olup olmadığını belirler. |
Ayrıntılı dokümanlar
addEditor(emailAddress)
Belirtilen kullanıcıyı Folder
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 |
---|---|---|
emailAddress | String | Eklenecek kullanıcının e-posta adresi. |
Return
Folder
: Zincirleme için bu Folder
.
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
addEditor(user)
Belirtilen kullanıcıyı Folder
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
Folder
: Zincirleme için bu Folder
.
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
addEditors(emailAddresses)
Belirtilen kullanıcı dizisini Folder
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 |
---|---|---|
emailAddresses | String[] | Eklenecek kullanıcıların e-posta adresleri dizisi. |
Return
Folder
: Zincirleme için bu Folder
.
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
addViewer(emailAddress)
Belirtilen kullanıcıyı Folder
için izleyiciler listesine ekler. Kullanıcı zaten düzenleyiciler listesindeyse bu yöntemin etkisi olmaz.
Parametreler
Ad | Tür | Açıklama |
---|---|---|
emailAddress | String | Eklenecek kullanıcının e-posta adresi. |
Return
Folder
: Zincirleme için bu Folder
.
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
addViewer(user)
Belirtilen kullanıcıyı Folder
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
Folder
: Zincirleme için bu Folder
.
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
addViewers(emailAddresses)
Belirtilen kullanıcı dizisini Folder
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 |
---|---|---|
emailAddresses | String[] | Eklenecek kullanıcıların e-posta adresleri dizisi. |
Return
Folder
: Zincirleme için bu Folder
.
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
createFile(blob)
Belirli bir Blob
rastgele verisinden geçerli klasörde bir dosya oluşturur.
Parametreler
Ad | Tür | Açıklama |
---|---|---|
blob | BlobSource | Yeni dosyanın verileri. |
Return
File
: Yeni dosya.
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
createFile(name, content)
Geçerli klasörde, belirtilen ada ve içeriğe sahip bir metin dosyası oluşturur. content
50 MB'tan büyükse istisna atar.
// Create a text file with the content "Hello, world!" DriveApp.getRootFolder().createFile('New Text File', 'Hello, world!');
Parametreler
Ad | Tür | Açıklama |
---|---|---|
name | String | Yeni dosyanın adı. |
content | String | Yeni dosyanın içeriği. |
Return
File
: Yeni dosya.
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
createFile(name, content, mimeType)
Geçerli klasörde, belirtilen ada, içeriğe ve MIME türüne sahip bir dosya oluşturur. content
10 MB'tan büyükse istisna atar.
// Create an HTML file with the content "Hello, world!" DriveApp.getRootFolder().createFile('New HTML File', '<b>Hello, world!</b>', MimeType.HTML);
Parametreler
Ad | Tür | Açıklama |
---|---|---|
name | String | Yeni dosyanın adı. |
content | String | Yeni dosyanın içeriği. |
mimeType | String | Yeni dosyanın MIME türü. |
Return
File
: Yeni dosya.
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
createFolder(name)
Geçerli klasörde belirtilen ada sahip bir klasör oluşturur.
Parametreler
Ad | Tür | Açıklama |
---|---|---|
name | String | Yeni klasörün adı. |
Return
Folder
: Yeni klasö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
createShortcut(targetId)
Sağlanan Drive öğe kimliğinin kısayolunu oluşturur ve döndürür.
Parametreler
Ad | Tür | Açıklama |
---|---|---|
targetId | String | Hedef dosyanın veya klasörün dosya kimliği. |
Return
File
: Yeni kısayol.
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
createShortcutForTargetIdAndResourceKey(targetId, targetResourceKey)
Sağlanan Drive öğe kimliğinin ve kaynak anahtarının kısayolunu oluşturup döndürür. Kaynak anahtarı, bağlantı kullanılarak paylaşılan hedef dosyaya veya klasöre erişmek için iletilmesi gereken ek bir parametredir.
// Creates shortcuts for all folders in the user's drive that have a specific // name. // TODO(developer): Replace 'Test-Folder' with a valid folder name in your // drive. const folders = DriveApp.getFoldersByName('Test-Folder'); // Iterates through all folders named 'Test-Folder'. while (folders.hasNext()) { const folder = folders.next(); // Creates a shortcut to the provided Drive item ID and resource key, and // returns it. DriveApp.createShortcutForTargetIdAndResourceKey( folder.getId(), folder.getResourceKey(), ); }
Parametreler
Ad | Tür | Açıklama |
---|---|---|
targetId | String | Hedef dosyanın veya klasörün kimliği. |
targetResourceKey | String | Hedef dosyanın veya klasörün kaynak anahtarı. |
Return
File
: Yeni kısayol.
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
getAccess(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
getAccess(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
getDateCreated()
Folder
öğesinin oluşturulduğu tarihi alır.
Return
Date
: Folder
öğ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
getDescription()
Folder
öğesinin açıklamasını alır.
Return
String
: Folder
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
getEditors()
Bu Folder
için düzenleyenlerin listesini alır. Komut dosyasını yürüten kullanıcının Folder
için düzenleme erişimi yoksa bu yöntem boş bir dizi döndürür.
// Gets a folder by its ID. // TODO(developer): Replace the folder ID with your own. const folder = DriveApp.getFolderById('1234567890abcdefghijklmnopqrstuvwxyz'); // Gets the list of editors and logs their names to the console. const editors = folder.getEditors(); for (const editor of editors) { console.log(editor.getName()); }
Return
User[]
: Kullanıcının düzenleme erişimi varsa bu Folder
için düzenleyicilerin listesi, aksi takdirde boş bir dizi.
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
getFiles()
Geçerli klasörün alt öğeleri olan tüm dosyaların koleksiyonunu alır.
Return
FileIterator
: Geçerli klasörün alt öğeleri olan tüm dosyaların 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
getFilesByName(name)
Mevcut klasörün alt öğeleri olan ve belirtilen ada sahip tüm dosyaların koleksiyonunu alır.
Parametreler
Ad | Tür | Açıklama |
---|---|---|
name | String | Bulunacak dosyaların adı. |
Return
FileIterator
: Geçerli klasörün alt öğeleri olan ve belirtilen ada sahip tüm dosyaların koleksiyonudur.
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
getFilesByType(mimeType)
Mevcut klasörün alt öğeleri olan ve belirtilen MIME türüne sahip tüm dosyaların koleksiyonunu alır.
Parametreler
Ad | Tür | Açıklama |
---|---|---|
mimeType | String | Bulunacak dosyaların MIME türü. |
Return
FileIterator
: Geçerli klasörün alt öğeleri olan ve belirli bir MIME türüne sahip tüm dosyaların 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
getFolders()
Geçerli klasörün alt klasörlerinin tümünü içeren bir koleksiyon alır.
Return
FolderIterator
: Geçerli klasörün alt klasörlerinin tümü.
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
getFoldersByName(name)
Mevcut klasörün alt öğeleri olan ve belirtilen ada sahip tüm klasörlerin koleksiyonunu alır.
Parametreler
Ad | Tür | Açıklama |
---|---|---|
name | String | Bulunacak klasörlerin adı. |
Return
FolderIterator
: Geçerli klasörün alt klasörü olan ve belirtilen ada sahip tüm klasörlerin 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
getId()
Folder
öğesinin kimliğini alır.
Return
String
: Folder
öğ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
getLastUpdated()
Folder
öğesinin son güncellendiği tarihi alır.
Return
Date
: Folder
'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
getName()
Folder
öğesinin adını alır.
Return
String
: Folder
öğ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
getOwner()
Bu Folder
öğesinin sahibini alır.
// Gets a folder by its ID. // TODO(developer): Replace the folder ID with your own. const folder = DriveApp.getFolderById('1234567890abcdefghijklmnopqrstuvwxyz'); // Gets the owner of the folder and logs the name to the console. const folderOwner = folder.getOwner(); console.log(folderOwner.getName());
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.readonly
-
https://www.googleapis.com/auth/drive
getParents()
Folder
klasörünün doğrudan üst klasörlerini içeren bir koleksiyon alır.
Return
FolderIterator
: Folder
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
getResourceKey()
Bağlantı kullanılarak paylaşılan öğelere erişmek için gereken Folder
kaynağının anahtarını alır.
Return
String
: Folder
öğ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
getSecurityUpdateEligible()
Bu Folder
'nin, bağlantı kullanılarak paylaşıldığında erişim için kaynak anahtarı gerektiren güvenlik güncellemesini uygulamaya uygun olup olmadığını alır.
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 setSecurityUpdateEnabled
simgesini kullanın.
Google Drive güvenlik güncellemesi hakkında daha fazla bilgi edinin.
Return
Boolean
: Kaynak anahtarı koşulunun Folder
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
getSecurityUpdateEnabled()
Bu Folder
'ü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 Folder
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
getSharingAccess()
Açıkça erişim izni verilen kullanıcıların yanı sıra Folder
'e hangi kullanıcı sınıfının erişebileceğini alır.
Return
Access
: Folder
'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
getSharingPermission()
Açıkça erişim izni verilen kullanıcıların yanı sıra Folder
'e erişebilen kullanıcılara verilen izni alır.
Return
Permission
: Folder
'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
getSize()
Folder
öğ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
: Folder
öğ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
getUrl()
Folder
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 Folder
'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
getViewers()
Bu Folder
için görüntüleyenlerin ve yorumcuların listesini alır. Komut dosyasını yürüten kullanıcının Folder
için düzenleme erişimi yoksa bu yöntem boş bir dizi döndürür.
// Gets a folder by its ID. // TODO(developer): Replace the folder ID with your own. const folder = DriveApp.getFolderById('1234567890abcdefghijklmnopqrstuvwxyz'); // Gets the list of viewers and logs their names to the console. const viewers = folder.getViewers(); for (const viewer of viewers) { console.log(viewer.getName()); }
Return
User[]
: Kullanıcının düzenleme erişimi varsa bu Folder
için görüntüleyenlerin ve yorumcuların listesi, aksi takdirde boş bir dizi.
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
isStarred()
Folder
öğesinin kullanıcının Drive'ında yıldızla işaretlenip işaretlenmediğini belirler.
Return
Boolean
: Folder
, 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
isTrashed()
Folder
öğesinin, kullanıcının Drive'ındaki çöp kutusuna ait olup olmadığını belirler.
Return
Boolean
: Folder
, 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
moveTo(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
Folder
: Zincirleme için bu Folder
.
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
removeEditor(emailAddress)
Belirtilen kullanıcıyı Folder
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 Folder
'e erişimini engellemez. Örneğin, Folder
kullanıcının alanının tamamıyla paylaşılıyorsa veya Folder
, 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 |
---|---|---|
emailAddress | String | Kaldırılacak kullanıcının e-posta adresi. |
Return
Folder
: Zincirleme için bu Folder
.
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
removeEditor(user)
Belirtilen kullanıcıyı Folder
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 Folder
'e erişimini engellemez. Örneğin, Folder
kullanıcının alanının tamamıyla paylaşılıyorsa veya Folder
, 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
Folder
: Zincirleme için bu Folder
.
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
removeViewer(emailAddress)
Belirtilen kullanıcıyı Folder
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 Folder
'e erişmesini de engellemez. Örneğin, Folder
kullanıcının alanının tamamıyla paylaşılıyorsa veya Folder
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 |
---|---|---|
emailAddress | String | Kaldırılacak kullanıcının e-posta adresi. |
Return
Folder
: Zincirleme için bu Folder
.
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
removeViewer(user)
Belirtilen kullanıcıyı Folder
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 Folder
'e erişimini de engellemez. Örneğin, Folder
kullanıcının alanının tamamıyla paylaşılıyorsa veya Folder
, 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
Folder
: Zincirleme için bu Folder
.
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
revokePermissions(emailAddress)
Belirli bir kullanıcıya verilen Folder
erişimini iptal eder. Bu yöntem, genel erişime sahip bir kullanıcı sınıfına ait kullanıcıların Folder
'e erişimini engellemez. Örneğin, Folder
kullanıcının alanının tamamıyla paylaşılıyorsa.
Parametreler
Ad | Tür | Açıklama |
---|---|---|
emailAddress | String | Erişimi iptal edilecek kullanıcının e-posta adresi. |
Return
Folder
: Zincirleme için bu Folder
.
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
revokePermissions(user)
Belirli bir kullanıcıya verilen Folder
erişimini iptal eder. Bu yöntem, genel erişime sahip bir kullanıcı sınıfına ait kullanıcıların Folder
'e erişimini engellemez. Örneğin, Folder
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
Folder
: Zincirleme için bu Folder
.
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
searchFiles(params)
Geçerli klasörün alt öğeleri olan ve belirtilen arama ölçütleriyle eşleşen tüm dosyaların koleksiyonunu alır. Arama ölçütleri Google Drive SDK dokümanlarında ayrıntılı olarak açıklanmıştır. Drive hizmetinin Drive API'nin 2. sürümünü kullandığını ve bazı sorgu alanlarının 3. sürümden farklı olduğunu unutmayın. v2 ile v3 arasındaki alan farklılıklarını inceleyin.
params
bağımsız değişkeni, dize değerleri içerebilen bir sorgu dizesi olduğundan tırnak işaretlerini doğru şekilde kod dışına çıkardığınızdan emin olun (örneğin, "title contains 'Gulliver\\'s
Travels'"
veya 'title contains "Gulliver\'s Travels"'
).
// Logs the name of every file that are children of the current folder and modified after February 28, // 2022 whose name contains "untitled."" const files = DriveApp.getRootFolder().searchFiles( 'modifiedDate > "2022-02-28" and title contains "untitled"'); while (files.hasNext()) { const file = files.next(); console.log(file.getName()); }
Parametreler
Ad | Tür | Açıklama |
---|---|---|
params | String | Google Drive SDK dokümanlarında açıklandığı gibi arama ölçütleri. |
Return
FileIterator
: Geçerli klasörün alt öğeleri olan ve arama ölçütleriyle eşleşen tüm dosyaların 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
searchFolders(params)
Geçerli klasörün alt klasörü olan ve belirtilen arama ölçütleriyle eşleşen tüm klasörlerin koleksiyonunu alır. Arama ölçütleri Google Drive SDK dokümanlarında ayrıntılı olarak açıklanmıştır. Drive hizmetinin Drive API'nin 2. sürümünü kullandığını ve bazı sorgu alanlarının 3. sürümden farklı olduğunu unutmayın. v2 ile v3 arasındaki alan farklılıklarını inceleyin.
params
bağımsız değişkeni, dize değerleri içerebilen bir sorgu dizesi olduğundan tırnak işaretlerini doğru şekilde kod dışına çıkardığınızdan emin olun (örneğin, "title contains 'Gulliver\\'s
Travels'"
veya 'title contains "Gulliver\'s Travels"'
).
// Logs the name of every folder that are children of the current folder and you own and is starred. const folders = DriveApp.getRootFolder().searchFolders('starred = true and "me" in owners'); while (folders.hasNext()) { const folder = folders.next(); console.log(folder.getName()); }
Parametreler
Ad | Tür | Açıklama |
---|---|---|
params | String | Google Drive SDK dokümanlarında açıklandığı gibi arama ölçütleri. |
Return
FolderIterator
: Geçerli klasörün alt klasörü olan ve arama ölçütleriyle eşleşen tüm klasörlerin 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
setDescription(description)
Folder
öğesinin açıklamasını belirler.
Parametreler
Ad | Tür | Açıklama |
---|---|---|
description | String | Folder için yeni açıklama |
Return
Folder
: Zincirleme için bu Folder
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
setName(name)
Folder
değerinin adını belirler.
Parametreler
Ad | Tür | Açıklama |
---|---|---|
name | String | Folder için yeni ad |
Return
Folder
: Zincirleme için bu Folder
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
setOwner(emailAddress)
Folder
öğesinin sahibini değiştirir. Bu yöntem, önceki sahibine Folder
için açık düzenleme erişimi de verir.
Parametreler
Ad | Tür | Açıklama |
---|---|---|
emailAddress | String | Yeni sahip olması gereken kullanıcının e-posta adresi |
Return
Folder
: Zincirleme için bu Folder
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
setOwner(user)
Folder
öğesinin sahibini değiştirir. Bu yöntem, önceki sahibine Folder
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
Folder
: Zincirleme için bu Folder
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
setSecurityUpdateEnabled(enabled)
Folder
'ü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 | Folder için kaynak anahtarı koşulunun etkinleştirilip etkinleştirilmeyeceği. |
Return
Folder
: Zincirleme için bu Folder
.
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
setSharing(accessType, permissionType)
Açıkça erişim izni verilen kullanıcıların yanı sıra Folder
'ye hangi kullanıcı sınıfının erişebileceğini ve bu kullanıcılara hangi izinlerin verileceğini belirler.
// 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 |
---|---|---|
accessType | Access | Folder |
permissionType | Permission | Folder 'e erişebilen kullanıcılara verilmesi gereken izinler |
Return
Folder
: Zincirleme için bu Folder
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
setStarred(starred)
Folder
öğesinin kullanıcının Drive'ında yıldızla işaretlenip işaretlenmeyeceğini belirler. Yeni Folder
'ler için varsayılan değer false
'dur.
Parametreler
Ad | Tür | Açıklama |
---|---|---|
starred | Boolean | Folder , kullanıcının Drive'ında yıldızlanmalıdır (true ) veya yıldızlanmamalıdır (false ). |
Return
Folder
: Zincirleme için bu Folder
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
setTrashed(trashed)
Folder
öğesinin, kullanıcının Drive'ındaki çöp kutusuna ait olup olmadığını belirler. Folder
öğesini yalnızca sahibi çöp kutusuna gönderebilir. Yeni Folder
'ler için varsayılan değer false
'tur.
Parametreler
Ad | Tür | Açıklama |
---|---|---|
trashed | Boolean | Folder , kullanıcının Drive'ının çöp kutusuna taşınacaksa true ; aksi takdirde false |
Return
Folder
: Zincirleme için bu Folder
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