Class Folder

Klasör

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öntemDönüş türüKısa açıklama
addEditor(emailAddress)FolderBelirtilen kullanıcıyı Folder için düzenleyiciler listesine ekler.
addEditor(user)FolderBelirtilen kullanıcıyı Folder için düzenleyiciler listesine ekler.
addEditors(emailAddresses)FolderBelirtilen kullanıcı dizisini Folder için düzenleyiciler listesine ekler.
addViewer(emailAddress)FolderBelirtilen kullanıcıyı Folder için izleyiciler listesine ekler.
addViewer(user)FolderBelirtilen kullanıcıyı Folder için izleyiciler listesine ekler.
addViewers(emailAddresses)FolderBelirtilen kullanıcı dizisini Folder için izleyici listesine ekler.
createFile(blob)FileBelirli bir Blob rastgele verisinden geçerli klasörde bir dosya oluşturur.
createFile(name, content)FileGeçerli klasörde, belirtilen ada ve içeriğe sahip 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 ada sahip bir klasör oluşturur.
createShortcut(targetId)FileSağlanan Drive öğe kimliğinin kısayolunu oluşturur ve döndürür.
createShortcutForTargetIdAndResourceKey(targetId, targetResourceKey)FileSağlanan Drive öğe kimliğinin ve kaynak anahtarının kısayolunu oluşturup 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 koleksiyonunu alır.
getFilesByName(name)FileIteratorMevcut klasörün alt öğeleri olan ve belirtilen ada sahip tüm dosyaların koleksiyonunu alır.
getFilesByType(mimeType)FileIteratorMevcut klasörün alt öğeleri olan ve belirtilen MIME türüne sahip tüm dosyaların koleksiyonunu alır.
getFolders()FolderIteratorGeçerli klasörün alt klasörlerinin tümünü içeren bir koleksiyon alır.
getFoldersByName(name)FolderIteratorMevcut klasörün alt öğeleri olan ve belirtilen ada sahip tüm klasörlerin koleksiyonunu alır.
getId()StringFolder öğesinin 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 klasörünün doğrudan üst klasörlerini içeren bir koleksiyon alır.
getResourceKey()StringBağlantı kullanılarak paylaşılan öğelere erişmek için gereken Folder kaynağının anahtarını alır.
getSecurityUpdateEligible()BooleanBu 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()BooleanBu Folder'ün, bağlantı kullanılarak paylaşıldığında erişim için kaynak anahtarı gerektirip gerektirmediğini alır.
getSharingAccess()AccessAçı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()PermissionAçı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()IntegerFolder öğesini Drive'da depolamak için kullanılan bayt sayısını alır.
getUrl()StringFolder 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()BooleanFolder 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()BooleanFolder öğesinin kullanıcının Drive'ında yıldızla işaretlenip işaretlenmediğini belirler.
isTrashed()BooleanFolder öğesinin, kullanıcının Drive'ındaki çöp kutusuna ait olup olmadığını belirler.
moveTo(destination)FolderBu öğeyi, belirtilen hedef klasöre taşır.
removeEditor(emailAddress)FolderBelirtilen kullanıcıyı Folder için düzenleyenler listesinden kaldırır.
removeEditor(user)FolderBelirtilen kullanıcıyı Folder için düzenleyenler listesinden kaldırır.
removeViewer(emailAddress)FolderBelirtilen kullanıcıyı Folder için görüntüleyen ve yorum yapanlar listesinden kaldırır.
removeViewer(user)FolderBelirtilen kullanıcıyı Folder için görüntüleyen ve yorum yapanlar listesinden kaldırır.
revokePermissions(emailAddress)FolderBelirli bir kullanıcıya verilen Folder erişimini iptal eder.
revokePermissions(user)FolderBelirli bir 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 koleksiyonunu alır.
searchFolders(params)FolderIteratorGeç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)FolderFolder öğesinin açıklamasını belirler.
setName(name)FolderFolder değerinin adını belirler.
setOwner(emailAddress)FolderFolder öğesinin sahibini değiştirir.
setOwner(user)FolderFolder öğesinin sahibini değiştirir.
setSecurityUpdateEnabled(enabled)FolderFolder'ün, bağlantı kullanılarak paylaşıldığında erişim için kaynak anahtarı gerektirip gerektirmeyeceğini belirler.
setShareableByEditors(shareable)FolderFolder 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)FolderAçı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)FolderFolder öğesinin kullanıcının Drive'ında yıldızla işaretlenip işaretlenmeyeceğini belirler.
setTrashed(trashed)FolderFolder öğ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

AdTürAçıklama
emailAddressStringEklenecek 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

AdTürAçıklama
userUserEklenecek 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

AdTürAçıklama
emailAddressesString[]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

AdTürAçıklama
emailAddressStringEklenecek 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

AdTürAçıklama
userUserEklenecek 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 bazıları zaten düzenleyiciler listesindeyse bu yöntemin bu kullanıcılar üzerinde herhangi bir etkisi olmaz.

Parametreler

AdTürAçıklama
emailAddressesString[]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

AdTürAçıklama
blobBlobSourceYeni 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

AdTürAçıklama
nameStringYeni dosyanın adı.
contentStringYeni 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

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ı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

AdTürAçıklama
nameStringYeni 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

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ı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

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ı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

AdTürAçıklama
emailStringİ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

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ı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

AdTürAçıklama
nameStringBulunacak 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

AdTürAçıklama
mimeTypeStringBulunacak 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

AdTürAçıklama
nameStringBulunacak 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

User: Bu Folder'nin 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

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'ye 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

isShareableByEditors()

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.

Return

Boolean: Düzenleme iznine sahip kullanıcıların diğer kullanıcılarla paylaşması veya izinleri değiştirmesine izin veriliyor ise 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

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ızlıysa true, değilse false değerini alı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

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

AdTürAçıklama
destinationFolderYeni ü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

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ı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

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ı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

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ı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

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ı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

AdTürAçıklama
emailAddressStringEriş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

AdTürAçıklama
userUserEriş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

AdTürAçıklama
paramsStringGoogle 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

AdTürAçıklama
paramsStringGoogle 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

AdTürAçıklama
descriptionStringFolder 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

AdTürAçıklama
nameStringFolder 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

AdTürAçıklama
emailAddressStringYeni 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

AdTürAçıklama
userUserYeni 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

AdTürAçıklama
enabledBooleanFolder 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

setShareableByEditors(shareable)

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. Yeni bir Folder için varsayılan değer true'tir.

Parametreler

AdTürAçıklama
shareableBooleantrue düzenleme iznine sahip kullanıcıların diğer kullanıcılarla paylaşması veya izinleri değiştirmesine izin verilecekse; 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

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

AdTürAçıklama
accessTypeAccessFolder
permissionTypePermissionFolder'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

AdTürAçıklama
starredBooleanFolder, 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

AdTürAçıklama
trashedBooleanFolder, 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

Kullanımdan kaldırılan yöntemler