דף זה תורגם על ידי Cloud Translation API.

Class DriveApp

התכונה מאפשרת לסקריפטים ליצור, למצוא ולשנות קבצים ותיקיות ב-Google Drive. כדי לגשת לקבצים או תיקיות באחסון השיתופי, צריך להשתמש בשירות המתקדם של Drive.

// Logs the name of every file in the user's Drive.
var files = DriveApp.getFiles();
while (files.hasNext()) {
  var file = files.next();
  console.log(file.getName());
}

מאפיינים

נכס	סוג	תיאור
`Access`	`Access`	טיפוסים בני מנייה (enum) שמייצגים סיווגים של משתמשים שיש להם גישה לקובץ או לתיקייה, מלבד כל אדם פרטי משתמשים שקיבלו גישה מפורשת.
`Permission`	`Permission`	טיפוסים בני מנייה (enum) שמייצג את ההרשאות שהוענקו למשתמשים שיכולים לגשת לקובץ או לתיקייה, בנוסף כל משתמש בודד שקיבל גישה מפורשת.

שיטות

שיטה	סוג הערך המוחזר	תיאור קצר
`continueFileIterator(continuationToken)`	`FileIterator`	חזרה על איטרציה של קובץ באמצעות אסימון המשך מאיטרטור קודם.
`continueFolderIterator(continuationToken)`	`FolderIterator`	חזרה על איטרציה של תיקייה באמצעות אסימון המשך מאיטרטור קודם.
`createFile(blob)`	`File`	יוצר קובץ ברמה הבסיסית (root) ב-Drive של המשתמש מ-`Blob` נתון של נתונים שרירותיים.
`createFile(name, content)`	`File`	יוצר קובץ טקסט ברמה הבסיסית (root) של Drive של המשתמש עם השם והתוכן הרשומים.
`createFile(name, content, mimeType)`	`File`	יצירת קובץ ברמה הבסיסית (root) ב-Drive של המשתמש עם השם, התוכן וסוג ה-MIME שצוינו.
`createFolder(name)`	`Folder`	יוצרת תיקייה ברמה הבסיסית (root) ב-Drive של המשתמש, עם השם שניתן.
`createShortcut(targetId)`	`File`	יוצר קיצור דרך למזהה הפריט ב-Drive שסופק ומחזיר אותו.
`createShortcutForTargetIdAndResourceKey(targetId, targetResourceKey)`	`File`	יוצרת קיצור דרך למזהה הפריט ולמפתח המשאב ב-Drive שסופקו ומחזירה אותו.
`enforceSingleParent(value)`	`void`	המדיניות הזו מפעילה או משביתה את האפשרות לאכוף התנהגות של הורה יחידה לכל הקריאות שמשפיעות על תבניות הורה.
`getFileById(id)`	`File`	הפונקציה מקבלת את הקובץ עם המזהה הנתון.
`getFileByIdAndResourceKey(id, resourceKey)`	`File`	הפונקציה מקבלת את הקובץ עם המזהה ומפתח המשאב הנתונים.
`getFiles()`	`FileIterator`	מקבל אוסף של כל הקבצים ב-Drive של המשתמש.
`getFilesByName(name)`	`FileIterator`	הפונקציה מקבלת אוסף של כל הקבצים ב-Drive של המשתמש עם השם הפרטי.
`getFilesByType(mimeType)`	`FileIterator`	מקבל אוסף של כל הקבצים ב-Drive של המשתמש עם סוג MIME הנתון.
`getFolderById(id)`	`Folder`	הפונקציה מקבלת את התיקייה עם המזהה הנתון.
`getFolderByIdAndResourceKey(id, resourceKey)`	`Folder`	הפונקציה מקבלת את התיקייה עם המזהה ומפתח המשאב הנתונים.
`getFolders()`	`FolderIterator`	מקבל אוסף של כל התיקיות ב-Drive של המשתמש.
`getFoldersByName(name)`	`FolderIterator`	מקבל אוסף של כל התיקיות ב-Drive של המשתמש שיש להן את השם הפרטי.
`getRootFolder()`	`Folder`	מקבל את התיקייה ברמה הבסיסית (root) ב-Drive של המשתמש.
`getStorageLimit()`	`Integer`	הפונקציה מקבלת את מספר הבייטים שהמשתמש מורשה לאחסן ב-Drive.
`getStorageUsed()`	`Integer`	הפונקציה מקבלת את מספר הבייטים שהמשתמש מאחסן כרגע ב-Drive.
`getTrashedFiles()`	`FileIterator`	מקבל אוסף של כל הקבצים באשפה ב-Drive של המשתמש.
`getTrashedFolders()`	`FolderIterator`	מקבל אוסף של כל התיקיות באשפה ב-Drive של המשתמש.
`searchFiles(params)`	`FileIterator`	מקבל אוסף של כל הקבצים ב-Drive של המשתמש שתואמים לחיפוש הנתון קריטריונים.
`searchFolders(params)`	`FolderIterator`	מקבל אוסף של כל התיקיות ב-Drive של המשתמש שתואמות לחיפוש הנתון קריטריונים.

שיטות שהוצאו משימוש

שיטה	סוג הערך המוחזר	תיאור קצר
`addFile(child)`	`Folder`	מוסיף את הקובץ הנתון לרמה הבסיסית (root) של Drive של המשתמש.
`addFolder(child)`	`Folder`	מוסיף את התיקייה הנתונה לרמה הבסיסית (root) של Drive של המשתמש.
`removeFile(child)`	`Folder`	מסיר את הקובץ הנתון מהרמה הבסיסית (root) של Drive של המשתמש.
`removeFolder(child)`	`Folder`	מסיר את התיקייה הנתונה מהרמה הבסיסית (root) של Drive של המשתמש.

מסמכי תיעוד מפורטים

`continueFileIterator(continuationToken)`

חזרה על איטרציה של קובץ באמצעות אסימון המשך מאיטרטור קודם. השיטה הזאת שימושי אם עיבוד איטרטור בביצוע אחד חורג מזמן הביצוע המרבי. אסימוני המשך תקפים בדרך כלל לשבוע אחד.

// 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());
}

פרמטרים

שם	סוג	תיאור
`continuationToken`	`String`	אסימון המשך מאיטרטור קודם של קובץ.

חזרה

FileIterator – אוסף של קבצים שנשארו באיטרטור קודם כשאסימון ההמשך נוצרה,

`continueFolderIterator(continuationToken)`

חזרה על איטרציה של תיקייה באמצעות אסימון המשך מאיטרטור קודם. השיטה הזאת שימושי אם עיבוד איטרטור בביצוע אחד חורג מזמן הביצוע המרבי. אסימוני המשך תקפים בדרך כלל לשבוע אחד.

// 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());
}

פרמטרים

שם	סוג	תיאור
`continuationToken`	`String`	אסימון המשך מאיטרטור קודם של תיקייה.

חזרה

FolderIterator – אוסף של תיקיות שנשארו באיטרטור קודם כשממשיכים נוצר אסימון.

`createFile(blob)`

יוצר קובץ ברמה הבסיסית (root) ב-Drive של המשתמש מ-Blob נתון של נתונים שרירותיים.

// 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);

פרמטרים

שם	סוג	תיאור
`blob`	`BlobSource`	נתונים לגבי הקובץ החדש.

חזרה

File – הקובץ החדש.

אישור

סקריפטים שמשתמשים בשיטה הזו מחייבים הרשאה עם אחד או יותר מהיקפי ההרשאות הבאים:

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

`createFile(name, content)`

יוצר קובץ טקסט ברמה הבסיסית (root) של Drive של המשתמש עם השם והתוכן הרשומים. זורק חריג אם הגודל של content גדול מ-50MB.

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

פרמטרים

שם	סוג	תיאור
`name`	`String`	שם הקובץ החדש.
`content`	`String`	תוכן הקובץ החדש.

חזרה

File – הקובץ החדש.

אישור

סקריפטים שמשתמשים בשיטה הזו מחייבים הרשאה עם אחד או יותר מהיקפי ההרשאות הבאים:

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

`createFile(name, content, mimeType)`

יצירת קובץ ברמה הבסיסית (root) ב-Drive של המשתמש עם השם, התוכן וסוג ה-MIME שצוינו. קליעות חריג אם הקובץ content גדול מ-10MB.

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

פרמטרים

שם	סוג	תיאור
`name`	`String`	שם הקובץ החדש.
`content`	`String`	תוכן הקובץ החדש.
`mimeType`	`String`	סוג ה-MIME של הקובץ החדש.

חזרה

File – הקובץ החדש.

אישור

סקריפטים שמשתמשים בשיטה הזו מחייבים הרשאה עם אחד או יותר מהיקפי ההרשאות הבאים:

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

`createFolder(name)`

יוצרת תיקייה ברמה הבסיסית (root) ב-Drive של המשתמש, עם השם שניתן.

פרמטרים

שם	סוג	תיאור
`name`	`String`	שם התיקייה החדשה.

חזרה

Folder – התיקייה החדשה.

אישור

סקריפטים שמשתמשים בשיטה הזו מחייבים הרשאה עם אחד או יותר מהיקפי ההרשאות הבאים:

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

`createShortcut(targetId)`

יוצר קיצור דרך למזהה הפריט ב-Drive שסופק ומחזיר אותו.

פרמטרים

שם	סוג	תיאור
`targetId`	`String`	מזהה הקובץ של קובץ היעד או תיקיית היעד.

חזרה

File – קיצור הדרך החדש.

אישור

סקריפטים שמשתמשים בשיטה הזו מחייבים הרשאה עם אחד או יותר מהיקפי ההרשאות הבאים:

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

`createShortcutForTargetIdAndResourceKey(targetId, targetResourceKey)`

יוצרת קיצור דרך למזהה הפריט ולמפתח המשאב ב-Drive שסופקו ומחזירה אותו. משאב המפתח הוא פרמטר נוסף שצריך להעביר כדי לגשת לקובץ היעד או לתיקיית היעד שותף באמצעות קישור.

// 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());
}

פרמטרים

שם	סוג	תיאור
`targetId`	`String`	המזהה של קובץ היעד או תיקיית היעד.
`targetResourceKey`	`String`	מפתח המשאב של קובץ היעד או תיקיית היעד.

חזרה

File – קיצור הדרך החדש.

אישור

סקריפטים שמשתמשים בשיטה הזו מחייבים הרשאה עם אחד או יותר מהיקפי ההרשאות הבאים:

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

`enforceSingleParent(value)`

המדיניות הזו מפעילה או משביתה את האפשרות לאכוף התנהגות של הורה יחידה לכל הקריאות שמשפיעות על תבניות הורה.

אפשר לקרוא בבלוג פישוט של מבנה התיקיות ומודלים של שיתוף ב-Google Drive. פרטים נוספים.

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

פרמטרים

שם	סוג	תיאור
`value`	`Boolean`	המצב החדש של דגלEnforceSingleParent.

אישור

סקריפטים שמשתמשים בשיטה הזו מחייבים הרשאה עם אחד או יותר מהיקפי ההרשאות הבאים:

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

`getFileById(id)`

הפונקציה מקבלת את הקובץ עם המזהה הנתון. גורם לחריגה מכתיבת סקריפטים אם הקובץ לא קיים, או למשתמש אין הרשאת גישה אליו.

// 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());
}

פרמטרים

שם	סוג	תיאור
`id`	`String`	המזהה של הקובץ.

חזרה

File – הקובץ עם המזהה הנתון.

אישור

סקריפטים שמשתמשים בשיטה הזו מחייבים הרשאה עם אחד או יותר מהיקפי ההרשאות הבאים:

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

`getFileByIdAndResourceKey(id, resourceKey)`

הפונקציה מקבלת את הקובץ עם המזהה ומפתח המשאב הנתונים. מפתחות המשאבים הם פרמטר נוסף שצריך להעביר כדי לגשת לקבצים ששותפו באמצעות קישור.

גורם לחריגה מכתיבת סקריפטים אם הקובץ לא קיים או שלמשתמש אין הרשאה כדי לגשת אליו.

// 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());
}

פרמטרים

שם	סוג	תיאור
`id`	`String`	המזהה של הקובץ.
`resourceKey`	`String`	מפתח המשאב של התיקייה.

חזרה

File – הקובץ עם המזהה הנתון.

אישור

סקריפטים שמשתמשים בשיטה הזו מחייבים הרשאה עם אחד או יותר מהיקפי ההרשאות הבאים:

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

`getFiles()`

מקבל אוסף של כל הקבצים ב-Drive של המשתמש.

חזרה

FileIterator – אוסף של כל הקבצים ב-Drive של המשתמש.

אישור

סקריפטים שמשתמשים בשיטה הזו מחייבים הרשאה עם אחד או יותר מהיקפי ההרשאות הבאים:

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

`getFilesByName(name)`

הפונקציה מקבלת אוסף של כל הקבצים ב-Drive של המשתמש עם השם הפרטי.

פרמטרים

שם	סוג	תיאור
`name`	`String`	שמות הקבצים לחיפוש.

חזרה

FileIterator – אוסף של כל הקבצים ב-Drive של המשתמש עם השם הנתון.

אישור

סקריפטים שמשתמשים בשיטה הזו מחייבים הרשאה עם אחד או יותר מהיקפי ההרשאות הבאים:

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

`getFilesByType(mimeType)`

מקבל אוסף של כל הקבצים ב-Drive של המשתמש עם סוג MIME הנתון.

פרמטרים

שם	סוג	תיאור
`mimeType`	`String`	סוג ה-MIME של הקבצים לחיפוש.

חזרה

FileIterator – אוסף של כל הקבצים ב-Drive של המשתמש שמכילים את ה-MIME הנתון מהסוג הזה.

אישור

סקריפטים שמשתמשים בשיטה הזו מחייבים הרשאה עם אחד או יותר מהיקפי ההרשאות הבאים:

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

`getFolderById(id)`

הפונקציה מקבלת את התיקייה עם המזהה הנתון. גורם חריג של סקריפטים אם התיקייה לא קיימת, או למשתמש אין הרשאת גישה אליו.

פרמטרים

שם	סוג	תיאור
`id`	`String`	המזהה של התיקייה.

חזרה

Folder – התיקייה עם המזהה הנתון.

אישור

סקריפטים שמשתמשים בשיטה הזו מחייבים הרשאה עם אחד או יותר מהיקפי ההרשאות הבאים:

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

`getFolderByIdAndResourceKey(id, resourceKey)`

הפונקציה מקבלת את התיקייה עם המזהה ומפתח המשאב הנתונים. מפתחות המשאבים הם פרמטר נוסף שצריך להעביר כדי לגשת לתיקיות ששותפו באמצעות קישור.

גורם לחריגה מכתיבת סקריפטים אם התיקייה לא קיימת או שלמשתמש אין הרשאה כדי לגשת אליו.

פרמטרים

שם	סוג	תיאור
`id`	`String`	המזהה של התיקייה.
`resourceKey`	`String`	מפתח המשאב של התיקייה.

חזרה

Folder – התיקייה עם המזהה הנתון.

אישור

סקריפטים שמשתמשים בשיטה הזו מחייבים הרשאה עם אחד או יותר מהיקפי ההרשאות הבאים:

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

`getFolders()`

מקבל אוסף של כל התיקיות ב-Drive של המשתמש.

חזרה

FolderIterator – אוסף של כל התיקיות ב-Drive של המשתמש.

אישור

סקריפטים שמשתמשים בשיטה הזו מחייבים הרשאה עם אחד או יותר מהיקפי ההרשאות הבאים:

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

`getFoldersByName(name)`

מקבל אוסף של כל התיקיות ב-Drive של המשתמש שיש להן את השם הפרטי.

פרמטרים

שם	סוג	תיאור
`name`	`String`	שמות התיקיות שרוצים לחפש.

חזרה

FolderIterator – אוסף של כל התיקיות ב-Drive של המשתמש עם השם הפרטי.

אישור

סקריפטים שמשתמשים בשיטה הזו מחייבים הרשאה עם אחד או יותר מהיקפי ההרשאות הבאים:

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

`getRootFolder()`

מקבל את התיקייה ברמה הבסיסית (root) ב-Drive של המשתמש.

// 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());

חזרה

Folder – תיקיית הבסיס ב-Drive של המשתמש.

אישור

סקריפטים שמשתמשים בשיטה הזו מחייבים הרשאה עם אחד או יותר מהיקפי ההרשאות הבאים:

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

`getStorageLimit()`

הפונקציה מקבלת את מספר הבייטים שהמשתמש מורשה לאחסן ב-Drive.

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

חזרה

Integer – מספר הבייטים שהמשתמש מורשה לאחסן ב-Drive.

אישור

סקריפטים שמשתמשים בשיטה הזו מחייבים הרשאה עם אחד או יותר מהיקפי ההרשאות הבאים:

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

`getStorageUsed()`

הפונקציה מקבלת את מספר הבייטים שהמשתמש מאחסן כרגע ב-Drive.

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

חזרה

Integer – מספר הבייטים שהמשתמש מאחסן כרגע ב-Drive.

אישור

סקריפטים שמשתמשים בשיטה הזו מחייבים הרשאה עם אחד או יותר מהיקפי ההרשאות הבאים:

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

`getTrashedFiles()`

מקבל אוסף של כל הקבצים באשפה ב-Drive של המשתמש.

// 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());
}

חזרה

FileIterator – אוסף של קבצים באשפה.

אישור

סקריפטים שמשתמשים בשיטה הזו מחייבים הרשאה עם אחד או יותר מהיקפי ההרשאות הבאים:

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

`getTrashedFolders()`

מקבל אוסף של כל התיקיות באשפה ב-Drive של המשתמש.

// 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());
}

חזרה

FolderIterator – אוסף של תיקיות באשפה.

אישור

סקריפטים שמשתמשים בשיטה הזו מחייבים הרשאה עם אחד או יותר מהיקפי ההרשאות הבאים:

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

`searchFiles(params)`

מקבל אוסף של כל הקבצים ב-Drive של המשתמש שתואמים לחיפוש הנתון קריטריונים. הקריטריונים לחיפוש מפורטים בתיעוד של Google Drive SDK. שימו לב ש-Drive השירות משתמש בגרסה 2 של Drive API וחלק משדות השאילתה שונים מ-v3. בודקים את השדה ההבדלים בין גרסה 2 ל-3.

הארגומנט params הוא מחרוזת שאילתה שיכולה להכיל ערכי מחרוזות, לכן חשוב לשים לב כדי לסמן מירכאות כראוי (לדוגמה "title contains 'Gulliver\\'s Travels'" או '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());
}

פרמטרים

שם	סוג	תיאור
`params`	`String`	הקריטריונים לחיפוש, כפי שמפורט במסמכי התיעוד של Google Drive SDK.

חזרה

FileIterator – אוסף של כל הקבצים ב-Drive של המשתמש שתואמים לחיפוש קריטריונים.

אישור

סקריפטים שמשתמשים בשיטה הזו מחייבים הרשאה עם אחד או יותר מהיקפי ההרשאות הבאים:

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

`searchFolders(params)`

מקבל אוסף של כל התיקיות ב-Drive של המשתמש שתואמות לחיפוש הנתון קריטריונים. הקריטריונים לחיפוש מפורטים בתיעוד של Google Drive SDK. שימו לב ש-Drive השירות משתמש בגרסה 2 של Drive API וחלק משדות השאילתה שונים מ-v3. בודקים את השדה ההבדלים בין גרסה 2 ל-3.

// 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());
}

פרמטרים

שם	סוג	תיאור
`params`	`String`	הקריטריונים לחיפוש, כפי שמפורט במסמכי התיעוד של Google Drive SDK.

חזרה

FolderIterator – אוסף של כל התיקיות ב-Drive של המשתמש שתואמות לחיפוש קריטריונים.

אישור

סקריפטים שמשתמשים בשיטה הזו מחייבים הרשאה עם אחד או יותר מהיקפי ההרשאות הבאים:

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

שיטות שהוצאו משימוש

`addFile(child)`

הוצא משימוש. במקומו צריך להשתמש ב-File.moveTo(destination) או ב-Folder.createShortcut(targetId).

מוסיף את הקובץ הנתון לרמה הבסיסית (root) של Drive של המשתמש. השיטה הזאת לא מעבירה את הקובץ אל מחוץ לו תיקיית הורה קיימת; בקובץ יכול להיות יותר מהורה אחד בו-זמנית.

פרמטרים

שם	סוג	תיאור
`child`	`File`	קובץ הצאצא להוספה

חזרה

Folder – ההורה החדש של הקובץ נוסף כצאצא.

אישור

סקריפטים שמשתמשים בשיטה הזו מחייבים הרשאה עם אחד או יותר מהיקפי ההרשאות הבאים:

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

`addFolder(child)`

הוצא משימוש. במקומו צריך להשתמש ב-Folder.moveTo(destination) או ב-Folder.createShortcut(targetId).

מוסיף את התיקייה הנתונה לרמה הבסיסית (root) של Drive של המשתמש. שיטה זו לא מעבירה את התיקייה אל מחוץ תיקיית ההורה הקיימת שלו; תיקייה יכולה להיות עם יותר מהורה אחד בו-זמנית.

פרמטרים

שם	סוג	תיאור
`child`	`Folder`	תיקיית הצאצא להוספה.

חזרה

Folder – ההורה החדש של התיקייה שנוספה כצאצא.

אישור

סקריפטים שמשתמשים בשיטה הזו מחייבים הרשאה עם אחד או יותר מהיקפי ההרשאות הבאים:

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

`removeFile(child)`

הוצא משימוש. במקום זאת, צריך להשתמש ב-File.moveTo(destination).

מסיר את הקובץ הנתון מהרמה הבסיסית (root) של Drive של המשתמש. השיטה הזו לא מוחקת את הקובץ, אבל אם קובץ הוסר מכל ההורים שלו, לא ניתן לראות אותו ב-Drive חוץ מאשר על ידי חיפוש עליו או להשתמש באפשרות 'כל הפריטים' צפייה.

פרמטרים

שם	סוג	תיאור
`child`	`File`	קובץ הצאצא להסרה.

חזרה

Folder – ההורה הקודם של הילד או הילדה.

אישור

סקריפטים שמשתמשים בשיטה הזו מחייבים הרשאה עם אחד או יותר מהיקפי ההרשאות הבאים:

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

`removeFolder(child)`

הוצא משימוש. במקום זאת, צריך להשתמש ב-Folder.moveTo(destination).

מסיר את התיקייה הנתונה מהרמה הבסיסית (root) של Drive של המשתמש. השיטה הזו לא מוחקת את התיקייה או את התוכן שלה, אבל אם תיקייה הוסרה מכל ההורים שלה, לא ניתן יהיה לראות אותה ב-Drive חוץ מאשר על ידי חיפוש הפריט או שימוש באפשרות 'כל הפריטים' צפייה.

פרמטרים

שם	סוג	תיאור
`child`	`Folder`	תיקיית הצאצא להסרה.

חזרה

Folder – ההורה הקודם של הילד או הילדה.

אישור

סקריפטים שמשתמשים בשיטה הזו מחייבים הרשאה עם אחד או יותר מהיקפי ההרשאות הבאים:

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