Class DriveApp

Önceki bir iteratörden gelen devamlılık jetonunu kullanarak dosya yinelemesini devam ettirir. Bu yöntem Bir yürütmede yinelemenin işlenmesi maksimum yürütme süresini aşarsa yararlı olur. 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: Devamlılık jetonu alındığında önceki bir yinelemede kalan dosya koleksiyonu oluşturuldu.

Önceki bir iteratörün devamlılık jetonunu kullanarak klasör yinelemesini devam ettirir. Bu yöntem Bir yürütmede yinelemenin işlenmesi maksimum yürütme süresini aşarsa yararlı olur. 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: Geçiş sırasında önceki yinelemede kalan klasörlerden oluşan bir koleksiyon jeton oluşturuldu.

Belirli bir Blob rastgele veriden kullanıcının Drive'ının kök dizininde 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.createFile(blob);

Parametreler

Return

File - Yeni dosya.

Yetkilendirme

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

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

Kullanıcının Drive'ının kök dizininde belirtilen ad ve içerikle bir metin dosyası oluşturur. Şunu atar: (content) 50 MB'tan büyükse istisna uygular.

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

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

Belirtilen ad, içerik ve MIME türüne sahip kullanıcının Drive'ının kök dizininde bir dosya oluşturur. Fırlatma content 10 MB'tan büyükse istisna uygulanır.

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

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

Kullanıcının Drive'ının kök dizininde verilen ada sahip bir klasör oluşturur.

Parametreler

Return

Folder — Yeni klasör.

Yetkilendirme

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

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

Sağlanan Drive öğe kimliğine kısayol oluşturur ve bunu döndürür.

Parametreler

Return

File: Yeni kısayol.

Yetkilendirme

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

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

Sağlanan Drive öğe kimliği ve kaynak anahtarına kısayol oluşturur ve bu kısayolu döndürür. Kaynak anahtarı, etkinleştirilecek hedef dosyaya veya klasöre erişmek için iletilmesi gereken bir bağlantı kullanılarak paylaşıldı.

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

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

Öğe üst öğelerini etkileyen tüm çağrılar için tekli ebeveyn davranışını zorunlu kılar veya devre dışı bırakır.

Ayrıntılı bilgi için Google Drive'ın klasör yapısını ve paylaşım modellerini basitleştirme başlıklı blog yazısına göz atın. inceleyebilirsiniz.

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

Parametreler

Yetkilendirme

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

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

Verilen kimliğe sahip dosyayı alır. Dosya mevcut değilse veya kullanıcısının erişim izni yok.

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

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

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

Dosya mevcut değilse veya kullanıcının izni yoksa komut dosyası istisnası atar erişebilir.

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

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

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

Return

FileIterator — Kullanıcının Drive'ındaki tüm dosyaları içeren bir koleksiyon.

Yetkilendirme

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

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

Kullanıcının Drive'ında belirtilen ada sahip tüm dosyaların bir 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ı, aşağıdaki kapsamlardan bir veya daha fazlasıyla yetkilendirme gerektirir:

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

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

Parametreler

Return

FileIterator: Kullanıcının Drive'ında, belirli bir MIME'ye sahip olan tüm dosyaların koleksiyonu türü.

Yetkilendirme

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

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

Verilen kimliğe sahip klasörü alır. Klasör yoksa veya Kullanıcının erişim izni yok.

Parametreler

Return

Folder — Belirtilen kimliğe sahip klasör.

Yetkilendirme

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

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

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

Klasör yoksa veya kullanıcının izni yoksa komut dosyası istisnası atar erişebilir.

Parametreler

Return

Folder — Belirtilen kimliğe sahip klasör.

Yetkilendirme

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

• 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 koleksiyonu.

Yetkilendirme

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

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

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

Parametreler

Return

FolderIterator — Kullanıcının Drive'ında belirtilen ada sahip tüm klasörlerin koleksiyonudur.

Yetkilendirme

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

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

Kullanıcının Drive'ının kök dizininde bulunan 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ı, aşağıdaki kapsamlardan bir veya daha fazlasıyla yetkilendirme gerektirir:

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

Kullanıcının Drive'da depolamasına izin verilen 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 depolamasına izin verilen bayt sayısı.

Yetkilendirme

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

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

Kullanıcının 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 Drive'da depoladığı bayt sayısı.

Yetkilendirme

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

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

Kullanıcının Drive'ının çöp kutusundaki tüm dosyaların bir 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 koleksiyonu.

Yetkilendirme

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

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

Kullanıcının Drive'ının çö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ör koleksiyonu.

Yetkilendirme

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

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

Kullanıcının Drive'ında, belirtilen aramayla eşleşen tüm dosyaların bir koleksiyonunu alır ölçütlerine bağlıdır. Arama ölçütleri, Google Drive SDK'sı dokümanlarında ayrıntılı olarak açıklanmıştır. Drive'ın hizmeti, Drive API'nin v2 sürümünü kullanır ve bazı sorgu alanları v3'ten farklıdır. Alanını inceleyin v2 ile v3 arasındaki farklar hakkında daha fazla bilgi edinin.

params bağımsız değişkeni, dize değerleri içerebilen bir sorgu dizesi olduğundan kullanabilirsiniz (ö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.""
var files = DriveApp.searchFiles(
    'modifiedDate > "2022-02-28" and title contains "untitled"');
while (files.hasNext()) {
  var file = files.next();
  console.log(file.getName());
}

Parametreler

Return

FileIterator - Kullanıcının Drive'ında, aramayla eşleşen tüm dosyaların koleksiyonu ölçütlerine bağlıdır.

Yetkilendirme

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

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

Kullanıcının Drive'ında, belirtilen aramayla eşleşen tüm klasörlerin koleksiyonunu alır ölçütlerine bağlıdır. Arama ölçütleri, Google Drive SDK'sı dokümanlarında ayrıntılı olarak açıklanmıştır. Drive'ın hizmeti, Drive API'nin v2 sürümünü kullanır ve bazı sorgu alanları v3'ten farklıdır. Alanını inceleyin v2 ile v3 arasındaki farklar hakkında daha fazla bilgi edinin.

params bağımsız değişkeni, dize değerleri içerebilen bir sorgu dizesi olduğundan kullanabilirsiniz (ö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.
var folders = DriveApp.searchFolders('starred = true and "me" in owners');
while (folders.hasNext()) {
  var folder = folders.next();
  console.log(folder.getName());
}

Parametreler

Return

FolderIterator - Kullanıcının Drive'ında, aramayla eşleşen tüm klasörlerin koleksiyonu ölçütlerine bağlıdır.

Yetkilendirme

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

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