Class DriveApp

Önceki bir iteratörden alınan devam ettirme jetonunu kullanarak dosya iterasyonunu devam ettirir. Bu yöntem, bir iteratör bir yürütmede işlenirken maksimum yürütme süresi aşıldığında faydalıdır. Devam jetonları genellikle bir hafta boyunca geçerlidir.

// Continues getting a list of all 'Untitled document' files in the user's
// Drive. Creates a file iterator named 'previousIterator'.
const previousIterator = DriveApp.getFilesByName('Untitled document');

// Gets continuation token from the previous file iterator.
const continuationToken = previousIterator.getContinuationToken();

// Creates a new iterator using the continuation token from the previous file
// iterator.
const newIterator = DriveApp.continueFileIterator(continuationToken);

// Resumes the file iteration using a continuation token from 'firstIterator'
// and logs the file name.
if (newIterator.hasNext()) {
  const file = newIterator.next();
  console.log(file.getName());
}

Parametreler

Return

FileIterator: Devam jetonu oluşturulduğunda önceki bir iteratörde kalan dosya koleksiyonu.

Önceki bir iteratörden alınan bir devam ettirme jetonunu kullanarak klasör iterasyonunu devam ettirir. Bu yöntem, bir iteratör bir yürütmede işlenirken maksimum yürütme süresi aşıldığında faydalıdır. Devam jetonları genellikle bir hafta boyunca geçerlidir.

// Continues getting a list of all folders in user's Drive.
// Creates a folder iterator named 'previousIterator'.
const previousIterator = DriveApp.getFolders();

// Gets continuation token from the previous folder iterator.
const continuationToken = previousIterator.getContinuationToken();

// Creates a new iterator using the continuation token from the previous folder
// iterator.
const newIterator = DriveApp.continueFolderIterator(continuationToken);

// Resumes the folder iteration using a continuation token from the previous
// iterator and logs the folder name.
if (newIterator.hasNext()) {
  const folder = newIterator.next();
  console.log(folder.getName());
}

Parametreler

Return

FolderIterator: Devam jetonu oluşturulduğunda önceki bir iteratörde kalan klasör koleksiyonu.

Belirli bir Blob rastgele verisinden kullanıcının Drive'ının kökünde bir dosya oluşturur.

Parametreler

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

Kullanıcının Drive'ının kökünde, belirtilen adı ve içeriği içeren bir metin dosyası oluşturur. content 50 MB'tan büyükse istisna atar.

// Create a text file with the content "Hello, world!"
DriveApp.createFile('New Text File', 'Hello, world!');

Parametreler

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

Kullanıcının Drive'ının kökünde, belirtilen adı, içeriği ve MIME türünü içeren bir dosya oluşturur. content 10 MB'tan büyükse istisna atar.

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

Parametreler

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

Kullanıcının Drive'ının kökünde, belirtilen ada sahip bir klasör oluşturur.

Parametreler

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

Sağlanan Drive öğe kimliğinin kısayolunu oluşturur ve döndürür.

Parametreler

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

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

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

Öğe ebeveynlerini etkileyen tüm çağrılar için enforceSingleParent davranışını etkinleştirir veya devre dışı bırakır.

Daha fazla bilgi için Google Drive'ın klasör yapısını ve paylaşım modellerini basitleştirme başlıklı blog makalesine bakın.

// Enables enforceSingleParent behavior for all calls affecting item parents.
DriveApp.enforceSingleParent(true);

Parametreler

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

Belirtilen kimliğe sahip dosyayı alır. Dosya mevcut değilse veya kullanıcının dosyaya erişme izni yoksa komut dosyası istisnası oluşturur.

// Gets a list of all files in Google Drive with the given name.
// TODO(developer): Replace 'Test' with your file name.
const files = DriveApp.getFilesByName('Test');

if (files.hasNext()) {
  // Gets the ID of each file in the list.
  const fileId = files.next().getId();

  // Gets the file name using its ID and logs it to the console.
  console.log(DriveApp.getFileById(fileId).getName());
}

Parametreler

Return

File: Belirtilen kimliğe sahip 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.readonly
• https://www.googleapis.com/auth/drive

Belirtilen kimliğe ve kaynak anahtarına sahip dosyayı alır. Kaynak anahtarları, bağlantı kullanılarak paylaşılan dosyalara erişmek için iletilmesi gereken ek bir parametredir.

Dosya mevcut değilse veya kullanıcının dosyaya erişme izni yoksa komut dosyası istisnası oluşturur.

// Gets a list of all files in Drive with the given name.
// TODO(developer): Replace 'Test' with your file name.
const files = DriveApp.getFilesByName('Test');
if (files.hasNext()) {
  // Gets the first file in the list.
  const file = files.next();

  // Gets the ID and resource key.
  const key = file.getResourceKey();
  const id = file.getId();

  // Logs the file name to the console using its ID and resource key.
  console.log(DriveApp.getFileByIdAndResourceKey(id, key).getName());
}

Parametreler

Return

File: Belirtilen kimliğe sahip 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.readonly
• https://www.googleapis.com/auth/drive

Kullanıcının Drive'ındaki tüm dosyaların koleksiyonunu alır.

Return

FileIterator: Kullanıcının Drive'ındaki 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

Kullanıcının Drive'ındaki, belirtilen ada sahip tüm dosyaların koleksiyonunu alır.

Parametreler

Return

FileIterator: Kullanıcının Drive'ında belirtilen ada 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

Kullanıcının Drive'ındaki belirli bir MIME türüne sahip tüm dosyaların koleksiyonunu alır.

Parametreler

Return

FileIterator: Kullanıcının Drive'ındaki, 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

Belirtilen kimliğe sahip klasörü alır. Klasör mevcut değilse veya kullanıcının klasöre erişme izni yoksa komut dosyası istisnası oluşturur.

Parametreler

Return

Folder: Belirtilen kimliğe sahip 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.readonly
• https://www.googleapis.com/auth/drive

Belirtilen kimlik ve kaynak anahtarına sahip klasörü alır. Kaynak anahtarları, bağlantı kullanılarak paylaşılan klasörlere erişmek için iletilmesi gereken ek bir parametredir.

Klasör mevcut değilse veya kullanıcının klasöre erişme izni yoksa komut dosyası istisnası oluşturur.

Parametreler

Return

Folder: Belirtilen kimliğe sahip 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.readonly
• https://www.googleapis.com/auth/drive

Kullanıcının Drive'ındaki tüm klasörlerin koleksiyonunu alır.

Return

FolderIterator: Kullanıcının Drive'ındaki tüm klasörlerin bir 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

Kullanıcının Drive'ındaki, belirtilen ada sahip tüm klasörlerin koleksiyonunu alır.

Parametreler

Return

FolderIterator: Kullanıcının Drive'ındaki, 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

Kullanıcının Drive'ının kökündeki klasörü alır.

// Gets the user's My Drive folder and logs its name to the console.
console.log(DriveApp.getRootFolder().getName());

// Logs the Drive owner's name to the console.
console.log(DriveApp.getRootFolder().getOwner().getName());

Return

Folder: Kullanıcının Drive'ının kök 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.readonly
• https://www.googleapis.com/auth/drive

Kullanıcının Drive'da depolayabileceği bayt sayısını alır.

// Gets the number of bytes the user can store in Drive and logs it to the
// console.
console.log(DriveApp.getStorageLimit());

Return

Integer: Kullanıcının Drive'da depolayabileceği 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

Kullanıcının şu anda Drive'da depoladığı bayt sayısını alır.

// Gets the number of bytes the user is currently storing in Drive and logs it
// to the console.
console.log(DriveApp.getStorageUsed());

Return

Integer: Kullanıcının şu anda Drive'da depoladığı 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

Kullanıcının Drive'ındaki çöp kutusundaki tüm dosyaların koleksiyonunu alır.

// Gets a list of all the files in the trash of the user's Drive.
const trashFiles = DriveApp.getTrashedFiles();

// Logs the trash file names to the console.
while (trashFiles.hasNext()) {
  const file = trashFiles.next();
  console.log(file.getName());
}

Return

FileIterator: Çöp kutusundaki dosya 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

Kullanıcının Drive'ındaki çöp kutusundaki tüm klasörlerin koleksiyonunu alır.

// Gets a collection of all the folders in the trash of the user's Drive.
const trashFolders = DriveApp.getTrashedFolders();

// Logs the trash folder names to the console.
while (trashFolders.hasNext()) {
  const folder = trashFolders.next();
  console.log(folder.getName());
}

Return

FolderIterator: Çöp kutusundaki 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

Kullanıcının Drive'ındaki, 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 in the user's Drive that modified after February 28,
// 2022 whose name contains "untitled.""
const files = DriveApp.searchFiles(
    'modifiedDate > "2022-02-28" and title contains "untitled"');
while (files.hasNext()) {
  const file = files.next();
  console.log(file.getName());
}

Parametreler

Return

FileIterator: Kullanıcının Drive'ındaki, 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

Kullanıcının Drive'ındaki, 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 in the user's Drive that you own and is starred.
const folders = DriveApp.searchFolders('starred = true and "me" in owners');
while (folders.hasNext()) {
  const folder = folders.next();
  console.log(folder.getName());
}

Parametreler

Return

FolderIterator: Kullanıcının Drive'ındaki, 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