Class Folder

Klasör

Google Drive'daki bir klasör Klasörlere DriveApp üzerinden erişilebilir veya klasörler 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üzenleyenler listesine ekler.
addEditor(user)FolderBelirtilen kullanıcıyı Folder için düzenleyenler listesine ekler.
addEditors(emailAddresses)FolderBelirtilen kullanıcı dizisini Folder için düzenleyenler listesine ekler.
addViewer(emailAddress)FolderBelirtilen kullanıcıyı Folder için görüntüleyiciler listesine ekler.
addViewer(user)FolderBelirtilen kullanıcıyı Folder için görüntüleyiciler listesine ekler.
addViewers(emailAddresses)FolderBelirtilen kullanıcı dizisini Folder için görüntüleyiciler listesine ekler.
createFile(blob)FileGeçerli klasörde, rastgele verilerden oluşan belirli bir Blob ile dosya oluşturur.
createFile(name, content)FileGeçerli klasörde, belirtilen ad ve içeriklere sahip bir metin dosyası oluşturur.
createFile(name, content, mimeType)FileGeçerli klasörde, belirtilen ad, içerik ve MIME türüyle bir dosya oluşturur.
createFolder(name)FolderGeçerli klasörde, belirtilen ada sahip bir klasör oluşturur.
createShortcut(targetId)FileBelirtilen Drive öğesi kimliğinin kısayolunu oluşturur ve döndürür.
createShortcutForTargetIdAndResourceKey(targetId, targetResourceKey)FileBelirtilen Drive öğesi kimliği ve kaynak anahtarı için kısayol oluşturur ve 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 öğesi olan tüm dosyaların koleksiyonunu alır.
getFilesByName(name)FileIteratorGeçerli klasörün alt öğeleri olan ve belirli bir ada sahip tüm dosyaların koleksiyonunu alır.
getFilesByType(mimeType)FileIteratorGeçerli klasörün alt öğesi olan ve belirtilen MIME türüne sahip tüm dosyaların koleksiyonunu alır.
getFolders()FolderIteratorGeçerli klasörün alt öğeleri olan tüm klasörlerin koleksiyonunu alır.
getFoldersByName(name)FolderIteratorGeçerli klasörün alt öğeleri olan ve belirli bir ada sahip tüm klasörlerin 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örlerin koleksiyonunu 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 öğesinin, bağlantı kullanılarak paylaşıldığında erişim için kaynak anahtarı gerektiren güvenlik güncellemesini uygulamaya uygun olup olmadığını alır.
getSecurityUpdateEnabled()BooleanBağlantı kullanılarak paylaşıldığında bu Folder için erişim amacıyla kaynak anahtarı gerekip gerekmediğini alır.
getSharingAccess()AccessErişim izni açıkça verilmiş bireysel kullanıcıların yanı sıra Folder'ya hangi kullanıcı sınıfının erişebileceğini alır.
getSharingPermission()PermissionFolder erişebilen kullanıcılara verilen izni alır. Ayrıca, açıkça erişim izni verilen bireysel kullanıcılar da bu izni alır.
getSize()IntegerDrive'da Folder öğesini depolamak için kullanılan bayt sayısını alır.
getUrl()StringFolder simgesini 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 üzerinde düzenleme izni olan kullanıcıların diğer kullanıcılarla paylaşmasına veya izinleri değiştirmesine izin verilip verilmeyeceğini belirler.
isStarred()BooleanFolder öğesinin, kullanıcının Drive'ında yıldızlanıp yıldızlanmadığını belirler.
isTrashed()BooleanFolder öğesinin, kullanıcının Drive çöp kutusunda 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 izleyici ve yorumcu listesinden kaldırır.
removeViewer(user)FolderBelirtilen kullanıcıyı Folder için izleyici ve yorumcu 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 öğesi olan ve belirtilen arama ölçütleriyle eşleşen tüm klasörlerin koleksiyonunu alır.
setDescription(description)FolderFolder için açıklamayı ayarlar.
setName(name)FolderFolder adını ayarlar.
setOwner(emailAddress)FolderFolder sahibini değiştirir.
setOwner(user)FolderFolder sahibini değiştirir.
setSecurityUpdateEnabled(enabled)FolderFolder, bağlantı kullanılarak paylaşıldığında erişim için kaynak anahtarı gerektirip gerektirmediğini ayarlar.
setShareableByEditors(shareable)FolderFolder üzerinde düzenleme izni olan kullanıcıların diğer kullanıcılarla paylaşım yapmasına veya izinleri değiştirmesine izin verilip verilmeyeceğini belirler.
setSharing(accessType, permissionType)FolderFolder'a hangi kullanıcı sınıfının erişebileceğini ve açıkça erişim izni verilen bireysel kullanıcıların yanı sıra bu kullanıcılara hangi izinlerin verileceğini belirler.
setStarred(starred)FolderFolder öğesinin kullanıcının Drive'ında yıldızlanıp yıldızlanmayacağını ayarlar.
setTrashed(trashed)FolderFolder öğesinin, kullanıcının Drive çöp kutusunda olup olmayacağını ayarlar.

Ayrıntılı belgeler

addEditor(emailAddress)

Belirtilen kullanıcıyı Folder için düzenleyenler listesine ekler. Kullanıcı zaten izleyiciler listesindeyse bu yöntem, kullanıcının izleyiciler listesinden çıkmasını sağlar.

Parametreler

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ı, aşağıdaki kapsamlardan biri veya daha fazlasıyla yetkilendirme gerektirir:

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

addEditor(user)

Belirtilen kullanıcıyı Folder için düzenleyenler listesine ekler. Kullanıcı zaten izleyiciler listesindeyse bu yöntem, kullanıcının izleyiciler listesinden çıkmasını sağlar.

Parametreler

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

Return

Folder: Zincirleme için bu Folder.

Yetkilendirme

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

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

addEditors(emailAddresses)

Belirtilen kullanıcı dizisini Folder için düzenleyenler listesine ekler. Kullanıcılardan herhangi biri zaten izleyiciler listesindeyse bu yöntemle kullanıcılar izleyiciler listesinden çıkarılır.

Parametreler

AdTürAçıklama
emailAddressesString[]Eklenecek kullanıcıların e-posta adreslerinden oluşan bir dizi.

Return

Folder: Zincirleme için bu Folder.

Yetkilendirme

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

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

addViewer(emailAddress)

Belirtilen kullanıcıyı Folder için görüntüleyiciler listesine ekler. Kullanıcı zaten düzenleyenler 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ı, aşağıdaki kapsamlardan biri veya daha fazlasıyla yetkilendirme gerektirir:

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

addViewer(user)

Belirtilen kullanıcıyı Folder için görüntüleyiciler listesine ekler. Kullanıcı zaten düzenleyenler 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ı, aşağıdaki kapsamlardan 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üleyiciler listesine ekler. Kullanıcılardan herhangi biri zaten düzenleyenler listesindeyse bu yöntem söz konusu kullanıcılar için geçerli olmaz.

Parametreler

AdTürAçıklama
emailAddressesString[]Eklenecek kullanıcıların e-posta adreslerinden oluşan bir dizi.

Return

Folder: Zincirleme için bu Folder.

Yetkilendirme

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

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

createFile(blob)

Geçerli klasörde, rastgele verilerden oluşan belirli bir Blob ile dosya oluşturur.

Parametreler

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

Return

File: Yeni dosya.

Yetkilendirme

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

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

createFile(name, content)

Geçerli klasörde, belirtilen ad ve içeriklere sahip bir metin dosyası oluşturur. content 50 MB'tan büyükse istisna oluşturur. 

// 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 kapsamlardan biri veya daha fazlasıyla yetkilendirme gerektirir:

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

createFile(name, content, mimeType)

Geçerli klasörde, belirtilen ad, içerik ve MIME türüyle 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 kapsamlardan biri veya daha fazlasıyla yetkilendirme gerektirir:

  • 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ı, aşağıdaki kapsamlardan biri veya daha fazlasıyla yetkilendirme gerektirir:

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

createShortcut(targetId)

Belirtilen Drive öğesi 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ı, aşağıdaki kapsamlardan biri veya daha fazlasıyla yetkilendirme gerektirir:

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

createShortcutForTargetIdAndResourceKey(targetId, targetResourceKey)

Belirtilen Drive öğesi kimliği ve kaynak anahtarı için kısayol oluşturur ve 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ı, aşağıdaki kapsamlardan biri veya daha fazlasıyla yetkilendirme gerektirir:

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

getAccess(email)

Belirli bir kullanıcıya verilen izni alır. Bu yöntem, Google Grubu için izinlerin veya Google Gruplar üzerinden devralınan izinlerin döndürülmesini desteklemez.

Parametreler

AdTürAçıklama
emailStringİzinleri kontrol edilecek kullanıcının e-posta adresi. Google Gruplar desteklenmez.

Return

Permission: Kullanıcıya verilen izinler.

Yetkilendirme

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

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

getAccess(user)

Belirli bir kullanıcıya verilen izni alır. Bu yöntem, Google Grubu için izinlerin veya Google Gruplar üzerinden devralınan izinlerin döndürülmesini desteklemez.

Parametreler

AdTürAçıklama
userUserİzinleri kontrol edilecek kullanıcının temsili.

Return

Permission: Kullanıcıya verilen izinler.

Yetkilendirme

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

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

getDateCreated()

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

Return

Date: Folder öğesinin oluşturulduğu tarih

Yetkilendirme

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

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

getDescription()

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

Return

String: Folder için açıklama

Yetkilendirme

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

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

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 User[] için düzenleyenlerin listesi, aksi takdirde boş dizi.Folder

Yetkilendirme

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

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

getFiles()

Geçerli klasörün alt öğesi olan tüm dosyaların koleksiyonunu alır.

Return

FileIterator: Geçerli klasörün alt öğesi olan tüm dosyaların bulunduğu bir koleksiyon.

Yetkilendirme

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

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

getFilesByName(name)

Geçerli klasörün alt öğeleri olan ve belirli bir 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 öğesi olan ve verilen ada sahip tüm dosyaların koleksiyonu.

Yetkilendirme

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

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

getFilesByType(mimeType)

Geçerli klasörün alt öğesi 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 öğesi olan ve belirtilen MIME türüne sahip tüm dosyaların bulunduğu bir koleksiyon.

Yetkilendirme

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

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

getFolders()

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

Return

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

Yetkilendirme

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

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

getFoldersByName(name)

Geçerli klasörün alt öğeleri olan ve belirli bir 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 öğesi olan ve belirli bir ada sahip tüm klasörlerin koleksiyonu.

Yetkilendirme

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

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

getId()

Folder kimliğini alır.

Return

String: Folder kimliği

Yetkilendirme

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

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

getLastUpdated()

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

Return

Date: Folder son güncellenme tarihi

Yetkilendirme

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

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

getName()

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

Return

String: Folder'nin adı

Yetkilendirme

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

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

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 kapsamlardan 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örlerin koleksiyonunu alır.

Return

FolderIterator: Folder öğesinin doğrudan üst öğeleri olan klasörler koleksiyonu

Yetkilendirme

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

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

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ı, aşağıdaki kapsamlardan biri veya daha fazlasıyla yetkilendirme gerektirir:

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

getSecurityUpdateEligible()

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

Drive, bağlantı kullanılarak paylaşılan bazı dosya veya klasörlere erişmek için kaynak anahtarı gerektirir. Bu değişiklik, bir güvenlik güncellemesinin parçasıdır. Güncelleme, uygun dosyalar ve klasörler için varsayılan olarak etkindir. Uygun dosyalar için kaynak anahtarı zorunluluğunu etkinleştirmek veya devre dışı bırakmak üzere 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ğı.

Yetkilendirme

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

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

getSecurityUpdateEnabled()

Bağlantı kullanılarak paylaşıldığında bu Folder için erişim amacıyla kaynak anahtarı gerekip gerekmediğini alır. Bu koşul, uygun dosyalar ve klasörler için varsayılan olarak etkindir. Uygun dosyalar için kaynak anahtarı zorunluluğunu etkinleştirmek veya devre dışı bırakmak üzere setSecurityUpdateEnabled simgesini kullanın.

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

Return

Boolean: Bu Folder için kaynak anahtarı şartının etkin olup olmadığı.

Yetkilendirme

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

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

getSharingAccess()

Erişim izni açıkça verilmiş bireysel kullanıcıların yanı sıra Folder'ya hangi kullanıcı sınıfının erişebileceğini alır.

Return

Access — hangi kullanıcı sınıfı Folder erişebilir?

Yetkilendirme

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

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

getSharingPermission()

Folder erişebilen kullanıcılara verilen izni alır. Ayrıca, açıkça erişim izni verilen bireysel kullanıcılar da bu izni alır.

Return

Permission: Folder öğesine erişebilen kullanıcılara verilen izinler

Yetkilendirme

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

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

getSize()

Drive'da Folder öğesini depolamak için kullanılan bayt sayısını alır. Google Workspace uygulama dosyalarının Drive depolama alanı sınırlarına dahil edilmediğini ve bu nedenle 0 bayt döndürdüğünü unutmayın.

Return

Integer: Folder öğesini Drive'da depolamak için kullanılan bayt sayısı

Yetkilendirme

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

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

getUrl()

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

Return

String: Bu Folder öğesini Drive veya Dokümanlar gibi bir Google uygulamasında görüntülemek için kullanılabilecek URL

Yetkilendirme

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

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

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ş dizi.

Yetkilendirme

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

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

isShareableByEditors()

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

Return

Düzenleme izni olan kullanıcıların diğer kullanıcılarla paylaşmasına veya izinleri değiştirmesine izin veriliyorsa Boolean — true, verilmiyorsa false

Yetkilendirme

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

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

isStarred()

Folder öğesinin, kullanıcının Drive'ında yıldızlanıp yıldızlanmadığını belirler.

Return

Boolean: Folder, kullanıcının Drive'ında yıldızlandıysa true, yıldızlanmadıysa false

Yetkilendirme

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

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

isTrashed()

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

Return

Boolean — Folder, kullanıcının Drive çöp kutusundaysa true; Aksi takdirde false

Yetkilendirme

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

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

moveTo(destination)

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

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

Parametreler

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

Return

Folder: Zincirleme için bu Folder.

Yetkilendirme

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

  • 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 olmaları durumunda kullanıcıların Folder erişmesini engellemez. Örneğin, Folder kullanıcının alanının tamamıyla paylaşılıyorsa veya Folder, kullanıcının erişebileceği bir ortak Drive'daysa.

Drive dosyaları için bu işlem, kullanıcıyı görüntüleyenler listesinden de kaldırır.

Parametreler

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 kapsamlardan biri veya daha fazlasıyla yetkilendirme gerektirir:

  • 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 olmaları durumunda kullanıcıların Folder erişmesini engellemez. Örneğin, Folder kullanıcının alanının tamamıyla paylaşılıyorsa veya Folder, kullanıcının erişebileceği bir ortak Drive'daysa.

Drive dosyaları için bu işlem, kullanıcıyı görüntüleyenler listesinden de kaldırır.

Parametreler

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 kapsamlardan biri veya daha fazlasıyla yetkilendirme gerektirir:

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

removeViewer(emailAddress)

Belirtilen kullanıcıyı Folder için izleyici ve yorumcu listesinden kaldırır. Bu yöntem, kullanıcı görüntüleyici veya yorumcu değil de düzenleyiciyse etkili olmaz. Bu yöntem, genel erişime sahip bir kullanıcı sınıfına ait olmaları durumunda kullanıcıların Folder 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şebileceği bir ortak Drive'daysa.

Drive dosyaları için bu işlem, 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: Bu, zincirleme için Folder.

Yetkilendirme

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

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

removeViewer(user)

Belirtilen kullanıcıyı Folder için izleyici ve yorumcu listesinden kaldırır. Bu yöntem, kullanıcı görüntüleyici değil düzenleyiciyse etkili olmaz. Bu yöntem, genel erişime sahip bir kullanıcı sınıfına ait olmaları durumunda kullanıcıların Folder 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şebileceği bir ortak Drive'da bulunuyorsa.

Drive dosyaları için bu işlem, kullanıcıyı düzenleyenler listesinden de kaldırır.

Parametreler

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

Return

Folder: Bu, zincirleme için Folder.

Yetkilendirme

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

  • 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 olmaları durumunda kullanıcıların Folder hizmetine erişimini engellemez. Örneğin, Folder hizmeti kullanıcının alanının tamamıyla paylaşılıyorsa bu durum geçerlidir.

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ı, aşağıdaki kapsamlardan biri veya daha fazlasıyla yetkilendirme gerektirir:

  • 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 olmaları durumunda kullanıcıların Folder hizmetine erişimini engellemez. Örneğin, Folder hizmeti kullanıcının alanının tamamıyla paylaşılıyorsa bu durum geçerlidir.

Parametreler

AdTürAçıklama
userUserErişimi iptal edilecek kullanıcının temsili.

Return

Folder: Zincirleme için bu Folder.

Yetkilendirme

Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan 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 koleksiyonunu alır. Arama ölçütleri Google Drive SDK belgelerinde ayrıntılı olarak 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 farklılıkları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 kod dışına almaya dikkat edin (ö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 ayrıntılı olarak açıklanan arama ölçütleri.

Return

FileIterator: Geçerli klasörün alt öğesi olan ve arama ölçütleriyle eşleşen tüm dosyaların bulunduğu bir koleksiyon.

Yetkilendirme

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

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

searchFolders(params)

Geçerli klasörün alt öğesi olan ve belirtilen arama ölçütleriyle eşleşen tüm klasörlerin koleksiyonunu alır. Arama ölçütleri Google Drive SDK belgelerinde ayrıntılı olarak 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 farklılıkları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 kod dışına almaya dikkat edin (ö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 ayrıntılı olarak açıklanan arama ölçütleri.

Return

FolderIterator: Geçerli klasörün alt öğesi olan ve arama ölçütleriyle eşleşen tüm klasörlerin bulunduğu bir koleksiyon.

Yetkilendirme

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

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

setDescription(description)

Folder için açıklamayı ayarlar.

Parametreler

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

Return

Folder: Zincirleme için bu Folder

Yetkilendirme

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

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

setName(name)

Folder adını ayarlar.

Parametreler

AdTürAçıklama
nameStringFolder adlı uygulamanın yeni adı

Return

Folder: Zincirleme için bu Folder

Yetkilendirme

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

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

setOwner(emailAddress)

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

Drive, gmail.com hesaplarına ait öğelerin sahipliğinin değiştirilmesini desteklemez. Bu işlem Workspace hesaplarında desteklenir.

Parametreler

AdTürAçıklama
emailAddressStringYeni sahip olacak kullanıcının e-posta adresi.

Return

Folder: Zincirleme için bu Folder.

Yetkilendirme

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

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

setOwner(user)

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

Drive, gmail.com hesaplarına ait öğelerin sahipliğinin değiştirilmesini desteklemez. Bu işlem Workspace hesaplarında desteklenir.

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ı, aşağıdaki kapsamlardan biri veya daha fazlasıyla yetkilendirme gerektirir:

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

setSecurityUpdateEnabled(enabled)

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

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

Parametreler

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

Return

Folder: Zincirleme için bu Folder.

Yetkilendirme

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

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

setShareableByEditors(shareable)

Folder üzerinde düzenleme izni olan kullanıcıların diğer kullanıcılarla paylaşım yapmasına veya izinleri değiştirmesine izin verilip verilmeyeceğini belirler. Yeni bir Folder için varsayılan değer true'dir.

Parametreler

AdTürAçıklama
shareableBooleantrue Düzenleme izni olan kullanıcıların diğer kullanıcılarla paylaşmasına veya izinleri değiştirmesine izin verilip verilmeyeceği; false verilmeyecekse

Return

Folder: Zincirleme için bu Folder

Yetkilendirme

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

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

setSharing(accessType, permissionType)

Folder'a hangi kullanıcı sınıfının erişebileceğini ve açıkça erişim izni verilen bireysel kullanıcıların yanı sıra bu kullanıcılara hangi izinlerin verileceğini belirler. 

// Creates a folder that anyone on the Internet can read from and write to.
// (Domain administrators can prohibit this setting for users of a Google
// Workspace domain.)
const folder = DriveApp.createFolder('Shared Folder');
folder.setSharing(DriveApp.Access.ANYONE, DriveApp.Permission.EDIT);

Parametreler

AdTürAçıklama
accessTypeAccessHangi kullanıcı sınıfı Folder erişebilmelidir?
permissionTypePermissionFolder erişebilen kullanıcılara verilmesi gereken izinler

Return

Folder: Zincirleme için bu Folder

Yetkilendirme

Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan 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ızlanıp yıldızlanmayacağını ayarlar. Yeni Folder'ler için varsayılan değer false'dir.

Parametreler

AdTürAçıklama
starredBooleanFolder, kullanıcının Drive'ında yıldızlanacaksa true; aksi takdirde false

Return

Folder: Zincirleme için bu Folder

Yetkilendirme

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

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

setTrashed(trashed)

Folder öğesinin, kullanıcının Drive çöp kutusunda olup olmayacağını ayarlar. Folder yalnızca sahibi silebilir. Yeni Folder'ler için varsayılan değer false'dir.

Parametreler

AdTürAçıklama
trashedBooleantrue, Folder kullanıcının Drive çöp kutusuna taşınacaksa; false, taşınmayacaksa

Return

Folder: Zincirleme için bu Folder

Yetkilendirme

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

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

Desteği sonlandırılmış yöntemler