Class Folder

Klasör

Google Drive'daki bir klasör. Klasörlere DriveApp uygulamasından erişilebilir veya klasörden klasör oluşturulabilir.

// Log the name of every folder in the user's Drive.
var folders = DriveApp.getFolders();
while (folders.hasNext()) {
  var folder = folders.next();
  Logger.log(folder.getName());
}

Yöntemler

YöntemDönüş türüKısa açıklama
addEditor(emailAddress)FolderKullanıcıyı Folder düzenleyici listesine ekler.
addEditor(user)FolderKullanıcıyı Folder düzenleyici listesine ekler.
addEditors(emailAddresses)FolderBelirtilen kullanıcı dizisini, Folder düzenleyicisi listesine ekler.
addViewer(emailAddress)FolderKullanıcıyı Folder öğesini görüntüleyenler listesine ekler.
addViewer(user)FolderKullanıcıyı Folder öğesini görüntüleyenler listesine ekler.
addViewers(emailAddresses)FolderBelirtilen kullanıcı dizisini, Folder için görüntüleyen listesine ekler.
createFile(blob)FileBelirli bir Blob rastgele veriden geçerli klasörde bir dosya oluşturur.
createFile(name, content)FileGeçerli klasörde belirtilen ad ve içeriklerle bir metin dosyası oluşturur.
createFile(name, content, mimeType)FileGeçerli klasörde belirtilen ada, içeriğe ve MIME türüne sahip bir dosya oluşturur.
createFolder(name)FolderGeçerli klasörde belirtilen adla bir klasör oluşturur.
createShortcut(targetId)FileSağlanan Drive öğesi kimliğine kısayol oluşturur ve bu kimliği döndürür.
createShortcutForTargetIdAndResourceKey(targetId, targetResourceKey)FileSağlanan Drive öğesi kimliği ve kaynak anahtarı için kısayol oluşturur ve bu kısayolu döndürür.
getAccess(email)PermissionBelirli bir kullanıcıya verilen izni alır.
getAccess(user)PermissionBelirli bir kullanıcıya verilen izni alır.
getDateCreated()DateFolder öğesinin oluşturulduğu tarihi alır.
getDescription()StringFolder öğesinin açıklamasını alır.
getEditors()User[]Bu Folder için düzenleyenlerin listesini alır.
getFiles()FileIteratorGeçerli klasörün alt öğeleri olan tüm dosyaların bir koleksiyonunu alır.
getFilesByName(name)FileIteratorGeçerli klasörün alt öğeleri olan ve belirtilen ada sahip olan tüm dosyaların bir koleksiyonunu alır.
getFilesByType(mimeType)FileIteratorGeçerli klasörün alt öğeleri olan ve belirtilen MIME türüne sahip tüm dosyaların bir koleksiyonunu alır.
getFolders()FolderIteratorGeçerli klasörün alt öğeleri olan tüm klasörlerin bir koleksiyonunu alır.
getFoldersByName(name)FolderIteratorGeçerli klasörün alt öğeleri olan ve belirtilen ada sahip olan tüm klasörlerin bir koleksiyonunu alır.
getId()StringFolder kimliğini alır.
getLastUpdated()DateFolder öğesinin son güncellendiği tarihi alır.
getName()StringFolder öğesinin adını alır.
getOwner()UserBu Folder öğesinin sahibini alır.
getParents()FolderIteratorFolder öğesinin doğrudan üst öğeleri olan klasör koleksiyonunu alır.
getResourceKey()StringBir bağlantı kullanılarak paylaşılan öğelere erişmek için gerekli olan Folder öğesinin kaynak anahtarını alır.
getSecurityUpdateEligible()BooleanBu Folder cihazının, bir bağlantı kullanılarak paylaşıldığında erişim için kaynak anahtarı gerektiren güvenlik güncellemesini uygulamaya uygun olup olmadığını alır.
getSecurityUpdateEnabled()BooleanBu Folder öğesinin bir bağlantı kullanılarak paylaşıldığında erişim için kaynak anahtarı gerektirip gerektirmediğini belirtir.
getSharingAccess()AccessAçıkça erişim izni verilen bireysel kullanıcıların yanı sıra hangi kullanıcı sınıflarının Folder öğesine erişebileceğini belirtir.
getSharingPermission()PermissionAçıkça erişim verilen bireysel kullanıcıların yanı sıra Folder erişimi olan kullanıcılara da verilen izni alır.
getSize()IntegerFolder öğesini Drive'da depolamak için kullanılan bayt sayısını alır.
getUrl()StringFolder öğesini Drive veya Dokümanlar gibi bir Google uygulamasında açmak için kullanılabilecek URL'yi alır.
getViewers()User[]Bu Folder için görüntüleyenlerin ve yorum yapanların listesini alır.
isShareableByEditors()BooleanFolder üzerinde düzenleme izinlerine sahip olan kullanıcıların diğer kullanıcılarla paylaşımda bulunmasına veya izinleri değiştirmesine izin verilip verilmeyeceğini belirler.
isStarred()BooleanFolder öğesinin, kullanıcının Drive'ında yıldızlı olup olmadığını belirler.
isTrashed()BooleanFolder öğesinin, kullanıcının Drive'ının çöp kutusunda olup olmadığını belirler.
moveTo(destination)FolderBu öğeyi sağlanan hedef klasöre taşır.
removeEditor(emailAddress)FolderKullanıcıyı, Folder düzenleyici listesinden kaldırır.
removeEditor(user)FolderKullanıcıyı, Folder düzenleyici listesinden kaldırır.
removeViewer(emailAddress)Folderİlgili kullanıcıyı, Folder için görüntüleyenler ve yorum yapanlar listesinden kaldırır.
removeViewer(user)Folderİlgili kullanıcıyı, Folder için görüntüleyenler ve yorum yapanlar listesinden kaldırır.
revokePermissions(emailAddress)FolderBelirtilen kullanıcıya verilen Folder erişimini iptal eder.
revokePermissions(user)FolderBelirtilen kullanıcıya verilen Folder erişimini iptal eder.
searchFiles(params)FileIteratorGeçerli klasörün alt öğeleri olan ve belirtilen arama ölçütleriyle eşleşen tüm dosyaların bir koleksiyonunu alır.
searchFolders(params)FolderIteratorGeçerli klasörün alt öğeleri olan ve belirtilen arama ölçütleriyle eşleşen tüm klasörlerin bir koleksiyonunu alır.
setDescription(description)FolderFolder öğesinin açıklamasını ayarlar.
setName(name)FolderFolder öğesinin adını belirler.
setOwner(emailAddress)FolderFolder öğesinin sahibini değiştirir.
setOwner(user)FolderFolder öğesinin sahibini değiştirir.
setSecurityUpdateEnabled(enabled)FolderFolder bir bağlantı kullanılarak paylaşıldığında erişim için kaynak anahtarı gerektirip gerektirmediğini belirler.
setShareableByEditors(shareable)FolderFolder üzerinde düzenleme izinlerine sahip olan kullanıcıların diğer kullanıcılarla paylaşımda bulunmasına veya izinleri değiştirmesine izin verilip verilmeyeceğini belirler.
setSharing(accessType, permissionType)FolderAçıkça erişim verilen bireysel kullanıcıların yanı sıra hangi kullanıcı sınıflarının Folder ürününe erişebileceğini ve bu kullanıcılara hangi izinlerin verileceğini belirler.
setStarred(starred)FolderFolder öğesinin, kullanıcının Drive'ında yıldızlı olup olmadığını belirler.
setTrashed(trashed)FolderFolder öğesinin, kullanıcının Drive'ının çöp kutusunda olup olmadığını belirler.

Ayrıntılı belgeler

addEditor(emailAddress)

Kullanıcıyı Folder düzenleyici listesine ekler. Kullanıcı zaten görüntüleyen listesindeyse bu yöntem kullanıcıyı görüntüleyen listesinin dışına çıkarır.

Parametreler

AdTürAçıklama
emailAddressStringEklenecek kullanıcının e-posta adresi.

Return

Folder — Bu Folder, zincirleme bağlantı için.

Yetkilendirme

Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamların biri veya daha fazlasıyla yetkilendirme gerektirir:

  • https://www.googleapis.com/auth/drive

addEditor(user)

Kullanıcıyı Folder düzenleyici listesine ekler. Kullanıcı zaten görüntüleyen listesindeyse bu yöntem kullanıcıyı görüntüleyen listesinin dışına çıkarır.

Parametreler

AdTürAçıklama
userUserEklenecek kullanıcının temsili.

Return

Folder — Bu Folder, zincirleme bağlantı için.

Yetkilendirme

Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamların biri veya daha fazlasıyla yetkilendirme gerektirir:

  • https://www.googleapis.com/auth/drive

addEditors(emailAddresses)

Belirtilen kullanıcı dizisini, Folder düzenleyicisi listesine ekler. Kullanıcılardan biri zaten görüntüleyen listesindeyse bu yöntem, söz konusu kullanıcıları görüntüleyen listesinin dışına çıkarır.

Parametreler

AdTürAçıklama
emailAddressesString[]Eklenecek kullanıcıların e-posta adresleri dizisi.

Return

Folder — Bu Folder, zincirleme bağlantı için.

Yetkilendirme

Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamların biri veya daha fazlasıyla yetkilendirme gerektirir:

  • https://www.googleapis.com/auth/drive

addViewer(emailAddress)

Kullanıcıyı Folder öğesini görüntüleyenler listesine ekler. Kullanıcı zaten düzenleyenler listesindeyse bu yöntemin herhangi bir etkisi olmaz.

Parametreler

AdTürAçıklama
emailAddressStringEklenecek kullanıcının e-posta adresi.

Return

Folder — Bu Folder, zincirleme bağlantı için.

Yetkilendirme

Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamların biri veya daha fazlasıyla yetkilendirme gerektirir:

  • https://www.googleapis.com/auth/drive

addViewer(user)

Kullanıcıyı Folder öğesini görüntüleyenler listesine ekler. Kullanıcı zaten düzenleyenler listesindeyse bu yöntemin herhangi bir etkisi olmaz.

Parametreler

AdTürAçıklama
userUserEklenecek kullanıcının temsili.

Return

Folder — Bu Folder, zincirleme bağlantı için.

Yetkilendirme

Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamların biri veya daha fazlasıyla yetkilendirme gerektirir:

  • https://www.googleapis.com/auth/drive

addViewers(emailAddresses)

Belirtilen kullanıcı dizisini, Folder için görüntüleyen listesine ekler. Kullanıcılardan biri zaten düzenleyen listesindeyse bu yöntemin o kullanıcılar için bir etkisi yoktur.

Parametreler

AdTürAçıklama
emailAddressesString[]Eklenecek kullanıcıların e-posta adresleri dizisi.

Return

Folder — Bu Folder, zincirleme bağlantı için.

Yetkilendirme

Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamların biri veya daha fazlasıyla yetkilendirme gerektirir:

  • https://www.googleapis.com/auth/drive

createFile(blob)

Belirli bir Blob rastgele veriden geçerli klasörde bir dosya oluşturur.

// Create an image file in Google Drive using the Maps service.
var blob = Maps.newStaticMap().setCenter('76 9th Avenue, New York NY').getBlob();
DriveApp.getRootFolder().createFile(blob);

Parametreler

AdTürAçıklama
blobBlobSourceYeni dosyanın verileri.

Return

File: Yeni dosya.

Yetkilendirme

Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamların biri veya daha fazlasıyla yetkilendirme gerektirir:

  • https://www.googleapis.com/auth/drive

createFile(name, content)

Geçerli klasörde belirtilen ad ve içeriklerle 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

AdTürAçıklama
nameStringYeni dosyanın adı.
contentStringYeni dosyanın içeriği.

Return

File: Yeni dosya.

Yetkilendirme

Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamların biri veya daha fazlasıyla yetkilendirme gerektirir:

  • 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 oluşturur.

// Create an HTML file with the content "Hello, world!"
DriveApp.getRootFolder().createFile('New HTML File', '<b>Hello, world!</b>', MimeType.HTML);

Parametreler

AdTürAçıklama
nameStringYeni dosyanın adı.
contentStringYeni dosyanın içeriği.
mimeTypeStringYeni dosyanın MIME türü.

Return

File: Yeni dosya.

Yetkilendirme

Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamların biri veya daha fazlasıyla yetkilendirme gerektirir:

  • https://www.googleapis.com/auth/drive

createFolder(name)

Geçerli klasörde belirtilen adla bir klasör oluşturur.

Parametreler

AdTürAçıklama
nameStringYeni klasörün adı.

Return

Folder: Yeni klasör.

Yetkilendirme

Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamların biri veya daha fazlasıyla yetkilendirme gerektirir:

  • https://www.googleapis.com/auth/drive

createShortcut(targetId)

Sağlanan Drive öğesi kimliğine kısayol oluşturur ve bu kimliği döndürür.

Parametreler

AdTürAçıklama
targetIdStringHedef dosyanın veya klasörün dosya kimliği.

Return

File: Yeni kısayol.

Yetkilendirme

Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamların biri veya daha fazlasıyla yetkilendirme gerektirir:

  • https://www.googleapis.com/auth/drive

createShortcutForTargetIdAndResourceKey(targetId, targetResourceKey)

Sağlanan Drive öğesi kimliği ve kaynak anahtarı için kısayol oluşturur ve bu kısayolu döndürür. Kaynak anahtarı, bir 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

AdTürAçıklama
targetIdStringHedef dosyanın veya klasörün kimliği.
targetResourceKeyStringHedef dosyanın veya klasörün kaynak anahtarı.

Return

File: Yeni kısayol.

Yetkilendirme

Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamların biri veya daha fazlasıyla yetkilendirme gerektirir:

  • https://www.googleapis.com/auth/drive

getAccess(email)

Belirli bir kullanıcıya verilen izni alır.

Parametreler

AdTürAçıklama
emailStringİzinlerinin kontrol edilmesi gereken kullanıcının e-posta adresi

Return

Permission - kullanıcıya verilen izinler

Yetkilendirme

Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamların biri veya daha fazlasıyla yetkilendirme gerektirir:

  • https://www.googleapis.com/auth/drive.readonly
  • https://www.googleapis.com/auth/drive

getAccess(user)

Belirli bir kullanıcıya verilen izni alır.

Parametreler

AdTürAçıklama
userUserİzinlerinin kontrol edilmesi gereken kullanıcının temsili

Return

Permission - kullanıcıya verilen izinler

Yetkilendirme

Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamların biri veya daha fazlasıyla yetkilendirme gerektirir:

  • https://www.googleapis.com/auth/drive.readonly
  • https://www.googleapis.com/auth/drive

getDateCreated()

Folder öğesinin oluşturulduğu tarihi alır.

Return

DateFolder oluşturulduğu tarih

Yetkilendirme

Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamların biri veya daha fazlasıyla yetkilendirme gerektirir:

  • https://www.googleapis.com/auth/drive.readonly
  • https://www.googleapis.com/auth/drive

getDescription()

Folder öğesinin açıklamasını alır.

Return

StringFolder için açıklama

Yetkilendirme

Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamların biri veya daha fazlasıyla yetkilendirme gerektirir:

  • 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 (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 veya aksi takdirde boş bir dizi.

Yetkilendirme

Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamların biri veya daha fazlasıyla yetkilendirme gerektirir:

  • 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 bir koleksiyonunu alır.

Return

FileIterator: Geçerli klasörün alt öğeleri olan tüm dosyaların koleksiyonudur.

Yetkilendirme

Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamların biri veya daha fazlasıyla yetkilendirme gerektirir:

  • https://www.googleapis.com/auth/drive.readonly
  • https://www.googleapis.com/auth/drive

getFilesByName(name)

Geçerli klasörün alt öğeleri olan ve belirtilen ada sahip olan tüm dosyaların bir koleksiyonunu alır.

Parametreler

AdTürAçıklama
nameStringBulunacak dosyaların adı.

Return

FileIterator: Geçerli klasörün alt öğeleri olan ve belirtilen ada sahip olan tüm dosyaların koleksiyonudur.

Yetkilendirme

Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamların biri veya daha fazlasıyla yetkilendirme gerektirir:

  • https://www.googleapis.com/auth/drive.readonly
  • https://www.googleapis.com/auth/drive

getFilesByType(mimeType)

Geçerli klasörün alt öğeleri olan ve belirtilen MIME türüne sahip tüm dosyaların bir koleksiyonunu alır.

Parametreler

AdTürAçıklama
mimeTypeStringBulunacak dosyaların MIME türü.

Return

FileIterator: Geçerli klasörün alt öğeleri olan ve belirtilen MIME türüne sahip tüm dosyaların koleksiyonu.

Yetkilendirme

Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamların biri veya daha fazlasıyla yetkilendirme gerektirir:

  • https://www.googleapis.com/auth/drive.readonly
  • https://www.googleapis.com/auth/drive

getFolders()

Geçerli klasörün alt öğeleri olan tüm klasörlerin bir koleksiyonunu alır.

Return

FolderIterator: Geçerli klasörün alt öğeleri olan tüm klasörlerin koleksiyonudur.

Yetkilendirme

Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamların biri veya daha fazlasıyla yetkilendirme gerektirir:

  • https://www.googleapis.com/auth/drive.readonly
  • https://www.googleapis.com/auth/drive

getFoldersByName(name)

Geçerli klasörün alt öğeleri olan ve belirtilen ada sahip olan tüm klasörlerin bir koleksiyonunu alır.

Parametreler

AdTürAçıklama
nameStringBulunacak klasörlerin adı.

Return

FolderIterator: Geçerli klasörün alt öğeleri olan ve belirtilen ada sahip olan tüm klasörlerin koleksiyonudur.

Yetkilendirme

Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamların biri veya daha fazlasıyla yetkilendirme gerektirir:

  • https://www.googleapis.com/auth/drive.readonly
  • https://www.googleapis.com/auth/drive

getId()

Folder kimliğini alır.

Return

StringFolder kimliği

Yetkilendirme

Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamların biri veya daha fazlasıyla yetkilendirme gerektirir:

  • https://www.googleapis.com/auth/drive.readonly
  • https://www.googleapis.com/auth/drive

getLastUpdated()

Folder öğesinin son güncellendiği tarihi alır.

Return

DateFolder öğesinin son güncellendiği tarih

Yetkilendirme

Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamların biri veya daha fazlasıyla yetkilendirme gerektirir:

  • https://www.googleapis.com/auth/drive.readonly
  • https://www.googleapis.com/auth/drive

getName()

Folder öğesinin adını alır.

Return

StringFolder adı

Yetkilendirme

Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamların biri veya daha fazlasıyla yetkilendirme gerektirir:

  • 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

User — Bu Folder öğesinin sahibi.

Yetkilendirme

Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamların biri veya daha fazlasıyla yetkilendirme gerektirir:

  • https://www.googleapis.com/auth/drive.readonly
  • https://www.googleapis.com/auth/drive

getParents()

Folder öğesinin doğrudan üst öğeleri olan klasör koleksiyonunu alır.

Return

FolderIteratorFolder öğesinin hemen üst öğeleri olan klasörler koleksiyonu

Yetkilendirme

Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamların biri veya daha fazlasıyla yetkilendirme gerektirir:

  • https://www.googleapis.com/auth/drive.readonly
  • https://www.googleapis.com/auth/drive

getResourceKey()

Bir bağlantı kullanılarak paylaşılan öğelere erişmek için gerekli olan Folder öğesinin kaynak anahtarını alır.

Return

String: Folder öğesinin kaynak anahtarı.

Yetkilendirme

Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamların biri veya daha fazlasıyla yetkilendirme gerektirir:

  • https://www.googleapis.com/auth/drive.readonly
  • https://www.googleapis.com/auth/drive

getSecurityUpdateEligible()

Bu Folder cihazının, bir bağlantı kullanılarak paylaşıldığında erişim için kaynak anahtarı gerektiren güvenlik güncellemesini uygulamaya uygun olup olmadığını alır.

Drive'ın, bağlantı kullanılarak paylaşılan bazı dosyalara veya klasörlere erişebilmesi için kaynak anahtarı gerekir. Bu değişiklik, bir güvenlik güncellemesinin parçasıdır. Uygun dosya ve klasörler için güncelleme varsayılan olarak etkindir. Uygun dosyalar için kaynak anahtarı koşulunu etkinleştirmek veya devre dışı bırakmak üzere setSecurityUpdateEnabled özelliğini kullanın.

Google Drive güvenlik güncellemesi hakkında daha fazla bilgi edinin.

Return

Boolean: Kaynak anahtarı gereksiniminin Folder için uygulanıp uygulanamayacağı.

Yetkilendirme

Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamların biri veya daha fazlasıyla yetkilendirme gerektirir:

  • https://www.googleapis.com/auth/drive.readonly
  • https://www.googleapis.com/auth/drive

getSecurityUpdateEnabled()

Bu Folder öğesinin bir bağlantı kullanılarak paylaşıldığında erişim için kaynak anahtarı gerektirip gerektirmediğini belirtir. 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 özelliğini kullanın.

Google Drive güvenlik güncellemesi hakkında daha fazla bilgi edinin.

Return

Boolean: Bu Folder için kaynak anahtarı gereksiniminin etkinleştirilip etkinleştirilmediği.

Yetkilendirme

Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamların biri veya daha fazlasıyla yetkilendirme gerektirir:

  • https://www.googleapis.com/auth/drive.readonly
  • https://www.googleapis.com/auth/drive

getSharingAccess()

Açıkça erişim izni verilen bireysel kullanıcıların yanı sıra hangi kullanıcı sınıflarının Folder öğesine erişebileceğini belirtir.

Return

Access - hangi kullanıcı sınıflarının Folder erişimi vardır?

Yetkilendirme

Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamların biri veya daha fazlasıyla yetkilendirme gerektirir:

  • https://www.googleapis.com/auth/drive.readonly
  • https://www.googleapis.com/auth/drive

getSharingPermission()

Açıkça erişim verilen bireysel kullanıcıların yanı sıra Folder erişimi olan kullanıcılara da verilen izni alır.

Return

PermissionFolder içeriğine erişebilen kullanıcılara verilen izinler

Yetkilendirme

Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamların biri veya daha fazlasıyla yetkilendirme gerektirir:

  • 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 verisinin Drive'da depolanması için kullanılan bayt sayısı

Yetkilendirme

Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamların biri veya daha fazlasıyla yetkilendirme gerektirir:

  • https://www.googleapis.com/auth/drive.readonly
  • https://www.googleapis.com/auth/drive

getUrl()

Folder öğesini Drive veya Dokümanlar gibi bir Google uygulamasında açmak için kullanılabilecek URL'yi alır.

Return

String — bu Folder öğeyi 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 kapsamların biri veya daha fazlasıyla yetkilendirme gerektirir:

  • https://www.googleapis.com/auth/drive.readonly
  • https://www.googleapis.com/auth/drive

getViewers()

Bu Folder için görüntüleyenlerin ve yorum yapanları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 (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 veya aksi halde boş bir dizi.

Yetkilendirme

Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamların biri veya daha fazlasıyla yetkilendirme gerektirir:

  • https://www.googleapis.com/auth/drive.readonly
  • https://www.googleapis.com/auth/drive

isShareableByEditors()

Folder üzerinde düzenleme izinlerine sahip olan kullanıcıların diğer kullanıcılarla paylaşımda bulunmasına veya izinleri değiştirmesine izin verilip verilmeyeceğini belirler.

Return

Boolean — Düzenleme izinlerine sahip kullanıcıların diğer kullanıcılarla paylaşımda bulunmasına veya izinleri değiştirmesine izin veriliyorsa true; izin verilmiyorsa false

Yetkilendirme

Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamların biri veya daha fazlasıyla yetkilendirme gerektirir:

  • https://www.googleapis.com/auth/drive.readonly
  • https://www.googleapis.com/auth/drive

isStarred()

Folder öğesinin, kullanıcının Drive'ında yıldızlı olup olmadığını belirler.

Return

BooleanFolder, kullanıcının Drive'ında yıldızlıysa true; yoksa false

Yetkilendirme

Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamların biri veya daha fazlasıyla yetkilendirme gerektirir:

  • https://www.googleapis.com/auth/drive.readonly
  • https://www.googleapis.com/auth/drive

isTrashed()

Folder öğesinin, kullanıcının Drive'ının çöp kutusunda olup olmadığını belirler.

Return

BooleanFolder, kullanıcının Drive'ının çöp kutusundaysa true; değilse false

Yetkilendirme

Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamların biri veya daha fazlasıyla yetkilendirme gerektirir:

  • https://www.googleapis.com/auth/drive.readonly
  • https://www.googleapis.com/auth/drive

moveTo(destination)

Bu öğeyi sağlanan hedef klasöre taşır.

Öğeyi hedef klasöre taşımak için geçerli kullanıcının, dosyanın sahibi olması veya öğenin geçerli üst klasörüne en azından düzenleme erişimine sahip olması gerekir.

Parametreler

AdTürAçıklama
destinationFolderYeni üst öğe olacak klasör.

Return

Folder — Bu Folder, zincirleme bağlantı için.

Yetkilendirme

Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamların biri veya daha fazlasıyla yetkilendirme gerektirir:

  • https://www.googleapis.com/auth/drive

removeEditor(emailAddress)

Kullanıcıyı, Folder düzenleyici listesinden kaldırır. Genel erişime sahip bir kullanıcı sınıfına ait olan (örneğin, Folder, kullanıcının tüm alan adıyla paylaşılıyorsa veya Folder, kullanıcının erişebildiği bir ortak Drive'da yer alıyorsa) bu yöntem, kullanıcıların Folder ürününe erişmesini engellemez.

Bu işlem, Drive dosyalarını görüntüleyenler listesinden de kaldırır.

Parametreler

AdTürAçıklama
emailAddressStringKaldırılacak kullanıcının e-posta adresi.

Return

Folder — Bu Folder, zincirleme bağlantı için.

Yetkilendirme

Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamların biri veya daha fazlasıyla yetkilendirme gerektirir:

  • https://www.googleapis.com/auth/drive

removeEditor(user)

Kullanıcıyı, Folder düzenleyici listesinden kaldırır. Genel erişime sahip bir kullanıcı sınıfına ait olan (örneğin, Folder, kullanıcının tüm alan adıyla paylaşılıyorsa veya Folder, kullanıcının erişebildiği bir ortak Drive'da yer alıyorsa) bu yöntem, kullanıcıların Folder ürününe erişmesini engellemez.

Bu işlem, Drive dosyalarını görüntüleyenler listesinden de kaldırır.

Parametreler

AdTürAçıklama
userUserKaldırılacak kullanıcının temsili.

Return

Folder — Bu Folder, zincirleme bağlantı için.

Yetkilendirme

Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamların biri veya daha fazlasıyla yetkilendirme gerektirir:

  • https://www.googleapis.com/auth/drive

removeViewer(emailAddress)

İlgili kullanıcıyı, Folder için görüntüleyenler ve yorum yapanlar listesinden kaldırır. Kullanıcı düzenleyen veya görüntüleyen ya da yorumcu değilse bu yöntemin herhangi bir etkisi yoktur. Ayrıca, Folder, kullanıcının tüm alanıyla paylaşılıyorsa veya Folder kullanıcının erişebildiği bir ortak Drive'da yer alıyorsa bu yöntem, genel erişime sahip bir kullanıcı sınıfında yer alan kullanıcıların Folder öğesine erişimini de engellemez.

Bu işlem, Drive dosyalarında kullanıcıyı düzenleyenler listesinden de kaldırır.

Parametreler

AdTürAçıklama
emailAddressStringKaldırılacak kullanıcının e-posta adresi.

Return

Folder — Zincirleme için bu Folder.

Yetkilendirme

Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamların biri veya daha fazlasıyla yetkilendirme gerektirir:

  • https://www.googleapis.com/auth/drive

removeViewer(user)

İlgili kullanıcıyı, Folder için görüntüleyenler ve yorum yapanlar listesinden kaldırır. Kullanıcı görüntüleyen değil düzenleyense bu yöntemin herhangi bir etkisi yoktur. Ayrıca, Folder kullanıcının tüm alanıyla paylaşılıyorsa veya Folder kullanıcının erişebildiği bir ortak Drive'da bulunuyorsa bu yöntem, genel erişime sahip bir kullanıcı sınıfında bulunan kullanıcıların Folder öğesine erişimini de engellemez.

Bu işlem, Drive dosyalarında kullanıcıyı düzenleyenler listesinden de kaldırır.

Parametreler

AdTürAçıklama
userUserKaldırılacak kullanıcının temsili.

Return

Folder — Zincirleme için bu Folder.

Yetkilendirme

Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamların biri veya daha fazlasıyla yetkilendirme gerektirir:

  • https://www.googleapis.com/auth/drive

revokePermissions(emailAddress)

Belirtilen kullanıcıya verilen Folder erişimini iptal eder. Genel erişime sahip bir kullanıcı sınıfında bulunan (örneğin Folder, kullanıcının tüm alanıyla paylaşılıyorsa) bu yöntem, kullanıcıların Folder öğesine erişmesini engellemez.

Parametreler

AdTürAçıklama
emailAddressStringErişiminin iptal edilmesi gereken kullanıcının e-posta adresi.

Return

Folder — Bu Folder, zincirleme bağlantı için.

Yetkilendirme

Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamların biri veya daha fazlasıyla yetkilendirme gerektirir:

  • https://www.googleapis.com/auth/drive

revokePermissions(user)

Belirtilen kullanıcıya verilen Folder erişimini iptal eder. Genel erişime sahip bir kullanıcı sınıfında bulunan (örneğin Folder, kullanıcının tüm alanıyla paylaşılıyorsa) bu yöntem, kullanıcıların Folder öğesine erişmesini engellemez.

Parametreler

AdTürAçıklama
userUserErişiminin iptal edilmesi gereken kullanıcının temsili.

Return

Folder — Bu Folder, zincirleme bağlantı için.

Yetkilendirme

Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamların biri veya daha fazlasıyla yetkilendirme gerektirir:

  • 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 bir koleksiyonunu alır. Arama ölçütlerinin ayrıntıları, Google Drive SDK'sı dokümanlarında açıklanmıştır. Drive hizmetinin, Drive API'nin v2 sürümünü kullandığını ve bazı sorgu alanlarının v3'ten farklı olduğunu unutmayın. v2 ile v3 arasındaki alan farklarını inceleyin.

params bağımsız değişkeni, dize değerleri içerebilen bir sorgu dizesidir. Bu nedenle, tırnak işaretlerini doğru şekilde kullanmaktan kaçının (ör. "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.""
var files = DriveApp.getRootFolder().searchFiles(
    'modifiedDate > "2022-02-28" and title contains "untitled"');
while (files.hasNext()) {
  var file = files.next();
  console.log(file.getName());
}

Parametreler

AdTürAçıklama
paramsStringGoogle Drive SDK'sı dokümanlarında ayrıntılı olarak açıklanan 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ı, aşağıdaki kapsamların biri veya daha fazlasıyla yetkilendirme gerektirir:

  • https://www.googleapis.com/auth/drive.readonly
  • https://www.googleapis.com/auth/drive

searchFolders(params)

Geçerli klasörün alt öğeleri olan ve belirtilen arama ölçütleriyle eşleşen tüm klasörlerin bir koleksiyonunu alır. Arama ölçütlerinin ayrıntıları, Google Drive SDK'sı dokümanlarında açıklanmıştır. Drive hizmetinin, Drive API'nin v2 sürümünü kullandığını ve bazı sorgu alanlarının v3'ten farklı olduğunu unutmayın. v2 ile v3 arasındaki alan farklarını inceleyin.

params bağımsız değişkeni, dize değerleri içerebilen bir sorgu dizesidir. Bu nedenle, tırnak işaretlerini doğru şekilde kullanmaktan kaçının (ör. "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.
var folders = DriveApp.getRootFolder().searchFolders('starred = true and "me" in owners');
while (folders.hasNext()) {
  var folder = folders.next();
  console.log(folder.getName());
}

Parametreler

AdTürAçıklama
paramsStringGoogle Drive SDK'sı dokümanlarında ayrıntılı olarak açıklanan arama ölçütleri.

Return

FolderIterator: Geçerli klasörün alt öğeleri olan ve arama ölçütleriyle eşleşen tüm klasörlerin koleksiyonudur.

Yetkilendirme

Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamların biri veya daha fazlasıyla yetkilendirme gerektirir:

  • https://www.googleapis.com/auth/drive.readonly
  • https://www.googleapis.com/auth/drive

setDescription(description)

Folder öğesinin açıklamasını ayarlar.

Parametreler

AdTürAçıklama
descriptionStringFolder için yeni açıklama

Return

Folder — bu Folder, zincirleme bağlantı için

Yetkilendirme

Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamların biri veya daha fazlasıyla yetkilendirme gerektirir:

  • https://www.googleapis.com/auth/drive

setName(name)

Folder öğesinin adını belirler.

Parametreler

AdTürAçıklama
nameStringFolder yeni adı

Return

Folder — bu Folder, zincirleme bağlantı için

Yetkilendirme

Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamların biri veya daha fazlasıyla yetkilendirme gerektirir:

  • https://www.googleapis.com/auth/drive

setOwner(emailAddress)

Folder öğesinin sahibini değiştirir. Bu yöntem, önceki sahibe Folder için açık düzenleme erişimi de verir.

Parametreler

AdTürAçıklama
emailAddressStringyeni sahip olması gereken kullanıcının e-posta adresi

Return

Folder — bu Folder, zincirleme bağlantı için

Yetkilendirme

Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamların biri veya daha fazlasıyla yetkilendirme gerektirir:

  • https://www.googleapis.com/auth/drive

setOwner(user)

Folder öğesinin sahibini değiştirir. Bu yöntem, önceki sahibe Folder için açık düzenleme erişimi de verir.

Parametreler

AdTürAçıklama
userUseryeni sahip olması gereken kullanıcının temsili

Return

Folder — bu Folder, zincirleme bağlantı için

Yetkilendirme

Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamların biri veya daha fazlasıyla yetkilendirme gerektirir:

  • https://www.googleapis.com/auth/drive

setSecurityUpdateEnabled(enabled)

Folder bir bağlantı kullanılarak paylaşıldığında erişim için kaynak anahtarı gerektirip gerektirmediğini belirler. Uygun dosya ve klasörler varsayılan olarak etkindir.

Google Drive güvenlik güncellemesi hakkında daha fazla bilgi edinin.

Parametreler

AdTürAçıklama
enabledBooleanFolder için kaynak anahtarı gereksiniminin etkinleştirilip etkinleştirilmeyeceği.

Return

Folder — Bu Folder, zincirleme bağlantı için.

Yetkilendirme

Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamların biri veya daha fazlasıyla yetkilendirme gerektirir:

  • https://www.googleapis.com/auth/drive

setShareableByEditors(shareable)

Folder üzerinde düzenleme izinlerine sahip olan kullanıcıların diğer kullanıcılarla paylaşımda bulunmasına veya izinleri değiştirmesine izin verilip verilmeyeceğini belirler. Yeni Folder için varsayılan değer: true.

Parametreler

AdTürAçıklama
shareableBooleanDüzenleme izinlerine sahip kullanıcıların diğer kullanıcılarla paylaşımda bulunmasına veya izinleri değiştirmesine izin verilmesi gerekiyorsa true; izin verilmiyorsa false

Return

Folder — bu Folder, zincirleme bağlantı için

Yetkilendirme

Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamların biri veya daha fazlasıyla yetkilendirme gerektirir:

  • https://www.googleapis.com/auth/drive

setSharing(accessType, permissionType)

Açıkça erişim verilen bireysel kullanıcıların yanı sıra hangi kullanıcı sınıflarının Folder ürününe erişebileceğini ve bu kullanıcılara hangi izinlerin verileceğini belirler.

// 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.)
var folder = DriveApp.createFolder('Shared Folder');
folder.setSharing(DriveApp.Access.ANYONE, DriveApp.Permission.EDIT);

Parametreler

AdTürAçıklama
accessTypeAccesshangi kullanıcı sınıflarının Folder ürününe erişebilmesi gerekir?
permissionTypePermissionFolder özelliğine erişebilen kullanıcılara verilmesi gereken izinleri

Return

Folder — bu Folder, zincirleme bağlantı için

Yetkilendirme

Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamların biri veya daha fazlasıyla yetkilendirme gerektirir:

  • https://www.googleapis.com/auth/drive

setStarred(starred)

Folder öğesinin, kullanıcının Drive'ında yıldızlı olup olmadığını belirler. Yeni Folder için varsayılan değer false'dir.

Parametreler

AdTürAçıklama
starredBooleanFolder öğesinin, kullanıcının Drive'ında yıldızlı olması gerekiyorsa true; aksi takdirde false

Return

Folder — bu Folder, zincirleme bağlantı için

Yetkilendirme

Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamların biri veya daha fazlasıyla yetkilendirme gerektirir:

  • https://www.googleapis.com/auth/drive

setTrashed(trashed)

Folder öğesinin, kullanıcının Drive'ının çöp kutusunda olup olmadığını belirler. Folder öğesini yalnızca sahibi çöp kutusuna gönderebilir. Yeni Folder için varsayılan değer false.

Parametreler

AdTürAçıklama
trashedBooleanFolder öğesinin, kullanıcının Drive'ındaki çöp kutusuna taşınması gerekiyorsa true; taşınmaması durumunda false

Return

Folder — bu Folder, zincirleme bağlantı için

Yetkilendirme

Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamların biri veya daha fazlasıyla yetkilendirme gerektirir:

  • https://www.googleapis.com/auth/drive

Kullanımdan kaldırılan yöntemler