Class File

קובץ

קובץ ב-Google Drive. אפשר לגשת לקבצים או ליצור אותם דרך DriveApp. 

// Trash every untitled spreadsheet that hasn't been updated in a week.
const files = DriveApp.getFilesByName('Untitled spreadsheet');
while (files.hasNext()) {
  const file = files.next();
  if (new Date() - file.getLastUpdated() > 7 * 24 * 60 * 60 * 1000) {
    file.setTrashed(true);
  }
}

Methods

שיטהסוג הערך המוחזרתיאור קצר
addCommenter(emailAddress)Fileהוספת המשתמש הנתון לרשימת המגיבים ב-File.
addCommenter(user)Fileהוספת המשתמש הנתון לרשימת המגיבים ב-File.
addCommenters(emailAddresses)Fileהוספת המערך של המשתמשים לרשימה של המגיבים ל-File.
addEditor(emailAddress)Fileהוספת המשתמש הנתון לרשימת העורכים של File.
addEditor(user)Fileהוספת המשתמש הנתון לרשימת העורכים של File.
addEditors(emailAddresses)Fileהוספת מערך המשתמשים הנתון לרשימת העורכים של File.
addViewer(emailAddress)Fileהוספת המשתמש הנתון לרשימת הצופים ב-File.
addViewer(user)Fileהוספת המשתמש הנתון לרשימת הצופים ב-File.
addViewers(emailAddresses)Fileהפונקציה מוסיפה את מערך המשתמשים הנתון לרשימת הצופים ב-File.
getAccess(email)Permissionהפונקציה מקבלת את ההרשאה שהוענקה למשתמש ספציפי.
getAccess(user)Permissionהפונקציה מקבלת את ההרשאה שהוענקה למשתמש ספציפי.
getAs(contentType)Blobהחזרת הנתונים שבתוך האובייקט הזה כ-blob שהומר לסוג התוכן שצוין.
getBlob()Blobהחזרת הנתונים שבתוך האובייקט הזה כ-blob.
getDateCreated()Dateהפונקציה מקבלת את התאריך שבו ה-File נוצר.
getDescription()Stringהפונקציה מקבלת את התיאור של ה-File.
getDownloadUrl()Stringהפונקציה מקבלת את כתובת ה-URL שאפשר להשתמש בה כדי להוריד את הקובץ.
getEditors()User[]הפונקציה מקבלת את רשימת העורכים של File הזה.
getId()Stringהפונקציה מקבלת את המזהה של ה-File.
getLastUpdated()Dateהפונקציה מקבלת את התאריך שבו File עודכן לאחרונה.
getMimeType()Stringהפונקציה מקבלת את סוג ה-MIME של הקובץ.
getName()Stringהפונקציה מקבלת את השם של ה-File.
getOwner()Userהצגת הבעלים של הקובץ.
getParents()FolderIteratorהפונקציה מקבלת אוסף של תיקיות שהן תיקיות הורה מיידיות של File.
getResourceKey()Stringהפונקציה מקבלת את מפתח המשאב של File שנדרש כדי לגשת לפריטים ששותפו באמצעות קישור.
getSecurityUpdateEligible()Booleanהפונקציה קובעת אם החשבון File עומד בדרישות להחלה של עדכון האבטחה, שמחייב קוד גישה כדי לגשת לקבצים כשהם משותפים באמצעות קישור.
getSecurityUpdateEnabled()Booleanהפונקציה מקבלת את הערך שמציין אם File הזה מחייב מפתח משאב לגישה כשהוא שותף באמצעות קישור.
getSharingAccess()Accessהפונקציה מקבלת את סוג המשתמשים שיכולים לגשת ל-File, מלבד משתמשים ספציפיים שקיבלו גישה באופן מפורש.
getSharingPermission()Permissionהפונקציה מקבלת את ההרשאה שהוענקה למשתמשים שיכולים לגשת ל-File, מלבד משתמשים ספציפיים שקיבלו גישה באופן מפורש.
getSize()Integerהפונקציה מקבלת את מספר הבייטים ששימשו לאחסון ה-File ב-Drive.
getTargetId()Stringאם מדובר בקיצור דרך, הפונקציה מחזירה את המזהה של הפריט שאליו הוא מפנה.
getTargetMimeType()Stringאם מדובר בקיצור דרך, הפונקציה מחזירה את סוג ה-MIME של הפריט שאליו הוא מפנה.
getTargetResourceKey()Stringאם הקובץ הוא קיצור דרך, הפונקציה מחזירה את מפתח המשאב של הפריט שאליו הוא מפנה.
getThumbnail()Blobהפונקציה מקבלת תמונה ממוזערת של הקובץ, או את הערך null אם אין תמונה ממוזערת.
getUrl()Stringהפונקציה מקבלת את כתובת ה-URL שאפשר להשתמש בה כדי לפתוח את File באפליקציית Google כמו Drive או Docs.
getViewers()User[]הפונקציה מקבלת את רשימת הצופים והמגיבים ב-File הזה.
isShareableByEditors()Booleanההגדרה קובעת אם משתמשים עם הרשאות עריכה ב-File מורשים לשתף עם משתמשים אחרים או לשנות את ההרשאות.
isStarred()Booleanקובעת אם ה-File סומן בכוכב ב-Drive של המשתמש.
isTrashed()Booleanקובעת אם הקובץ File נמצא באשפה ב-Drive של המשתמש.
makeCopy()Fileיצירת עותק של הקובץ.
makeCopy(destination)Fileיצירת עותק של הקובץ בספריית היעד.
makeCopy(name)Fileיצירת עותק של הקובץ והענקת שם לפי השם שצוין.
makeCopy(name, destination)Fileיצירת עותק של הקובץ בספריית היעד והענקת שם לקובץ.
moveTo(destination)Fileהעברת הפריט הזה לתיקיית היעד שצוינה.
removeCommenter(emailAddress)Fileהסרת המשתמש הנתון מרשימת המגיבים ב-File.
removeCommenter(user)Fileהסרת המשתמש הנתון מרשימת המגיבים ב-File.
removeEditor(emailAddress)Fileהסרת המשתמש הנתון מרשימת העורכים של File.
removeEditor(user)Fileהסרת המשתמש הנתון מרשימת העורכים של File.
removeViewer(emailAddress)Fileהסרת המשתמש מהרשימה של הצופים והמגיבים ב-File.
removeViewer(user)Fileהסרת המשתמש מהרשימה של הצופים והמגיבים ב-File.
revokePermissions(emailAddress)Fileביטול הגישה ל-File שהוקצה למשתמש הנתון.
revokePermissions(user)Fileביטול הגישה ל-File שהוקצה למשתמש הנתון.
setContent(content)Fileמחליף את תוכן הקובץ בתוכן חלופי נתון.
setDescription(description)Fileהגדרת התיאור של File.
setName(name)Fileהגדרת השם של File.
setOwner(emailAddress)Fileשינוי הבעלים של File.
setOwner(user)Fileשינוי הבעלים של File.
setSecurityUpdateEnabled(enabled)Fileמגדיר אם File מחייב מפתח משאב לגישה כשהוא שותף באמצעות קישור.
setShareableByEditors(shareable)Fileההגדרה קובעת אם משתמשים עם הרשאות עריכה ב-File מורשים לשתף את הקובץ עם משתמשים אחרים או לשנות את ההרשאות.
setSharing(accessType, permissionType)Fileמגדיר לאילו משתמשים תהיה גישה ל-File ואילו הרשאות יוענקו להם, מלבד משתמשים ספציפיים שקיבלו גישה באופן מפורש.
setStarred(starred)Fileמגדיר אם ה-File מסומן בכוכב ב-Drive של המשתמש.
setTrashed(trashed)Fileמגדיר אם ה-File נמצא באשפה ב-Drive של המשתמש.

מסמכים מפורטים

addCommenter(emailAddress)

הוספת המשתמש הנתון לרשימת המגיבים ב-File. אם המשתמש כבר נכלל ברשימת הצופים, השיטה הזו תגרום להסרת המשתמש מרשימת הצופים. 

const files = DriveApp.getFilesByName('Test');

// Loops through the files
while (files.hasNext()) {
  const file = files.next();
  file.addCommenter('hello@example.com');
}

פרמטרים

שםסוגתיאור
emailAddressStringכתובת האימייל של המשתמש שרוצים להוסיף.

חזרה

File — השדה File, לצורך קישור.

אישור

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

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

addCommenter(user)

הוספת המשתמש הנתון לרשימת המגיבים ב-File. אם המשתמש כבר נכלל ברשימת הצופים, השיטה הזו תגרום להסרת המשתמש מרשימת הצופים. 

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

// Adds the active user as a commenter.
while (files.hasNext()) {
  const file = files.next();
  file.addCommenter(Session.getActiveUser());
}

פרמטרים

שםסוגתיאור
userUserייצוג של המשתמש שרוצים להוסיף.

חזרה

File — השדה File, לצורך קישור.

אישור

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

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

addCommenters(emailAddresses)

הוספת המערך של המשתמשים לרשימה של המגיבים ל-File. אם משתמשים מסוימים כבר נמצאים ברשימת הצופים, השיטה הזו תגרום להסרתם מרשימת הצופים. 

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

while (files.hasNext()) {
  const file = files.next();
  // TODO(developer): Replace 'cloudysanfrancisco@gmail.com' and
  // 'baklavainthebalkans@gmail.com' with the email addresses to add as
  // commenters.
  const emails = [
    'cloudysanfrancisco@gmail.com',
    'baklavainthebalkans@gmail.com',
  ];
  console.log(file.addCommenters(emails));
}

פרמטרים

שםסוגתיאור
emailAddressesString[]מערך של כתובות האימייל של המשתמשים שרוצים להוסיף.

חזרה

File — השדה File, לצורך קישור.

אישור

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

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

addEditor(emailAddress)

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

פרמטרים

שםסוגתיאור
emailAddressStringכתובת האימייל של המשתמש שרוצים להוסיף.

חזרה

File — השדה File, לצורך קישור.

אישור

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

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

addEditor(user)

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

פרמטרים

שםסוגתיאור
userUserייצוג של המשתמש שרוצים להוסיף.

חזרה

File — השדה File, לצורך קישור.

אישור

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

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

addEditors(emailAddresses)

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

פרמטרים

שםסוגתיאור
emailAddressesString[]מערך של כתובות האימייל של המשתמשים שרוצים להוסיף.

חזרה

File — השדה File, לצורך קישור.

אישור

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

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

addViewer(emailAddress)

הוספת המשתמש הנתון לרשימת הצופים ב-File. אם המשתמש כבר נכלל ברשימת העורכים, לשיטה הזו אין השפעה.

פרמטרים

שםסוגתיאור
emailAddressStringכתובת האימייל של המשתמש שרוצים להוסיף.

חזרה

File — השדה File, לצורך קישור.

אישור

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

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

addViewer(user)

הוספת המשתמש הנתון לרשימת הצופים ב-File. אם המשתמש כבר נכלל ברשימת העורכים, לשיטה הזו אין השפעה.

פרמטרים

שםסוגתיאור
userUserייצוג של המשתמש שרוצים להוסיף.

חזרה

File — השדה File, לצורך קישור.

אישור

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

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

addViewers(emailAddresses)

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

פרמטרים

שםסוגתיאור
emailAddressesString[]מערך של כתובות האימייל של המשתמשים שרוצים להוסיף.

חזרה

File — השדה File, לצורך קישור.

אישור

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

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

getAccess(email)

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

פרמטרים

שםסוגתיאור
emailStringכתובת האימייל של המשתמש שרוצים לבדוק את ההרשאות שלו. אין תמיכה בקבוצות Google.

חזרה

Permission – ההרשאות שהוקצו למשתמש.

אישור

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

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

getAccess(user)

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

פרמטרים

שםסוגתיאור
userUserייצוג של המשתמש שצריך לבדוק את ההרשאות שלו.

חזרה

Permission – ההרשאות שהוקצו למשתמש.

אישור

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

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

getAs(contentType)

החזרת הנתונים שבתוך האובייקט הזה כ-blob שהומר לסוג התוכן שצוין. השיטה הזו מוסיפה את הסיומת המתאימה לשם הקובץ – לדוגמה, 'myfile.pdf'. עם זאת, ההנחה היא שחלק משם הקובץ שמופיע אחרי הנקודה האחרונה (אם יש כזו) הוא סיומת קיימת שצריך להחליף. כתוצאה מכך, הקובץ ShoppingList.12.25.2014 הופך לקובץ ShoppingList.12.25.pdf.

כדי לראות את המכסות היומיות להמרות, אפשר לעיין במאמר מכסות לשירותי Google. יכול להיות שדומיינים חדשים של Google Workspace יהיו כפופים באופן זמני למכסות מחמירות יותר.

פרמטרים

שםסוגתיאור
contentTypeStringסוג ה-MIME שאליו רוצים להמיר. ברוב ה-blobs, 'application/pdf' היא האפשרות היחידה התקפה. בתמונות בפורמט BMP,‏ GIF,‏ JPEG או PNG, אפשר להשתמש גם ב-'image/bmp',‏ 'image/gif',‏ 'image/jpeg' או 'image/png'. במסמך ב-Google Docs, הערך 'text/markdown' תקף גם כן.

חזרה

Blob – הנתונים כ-blob.

getBlob()

החזרת הנתונים שבתוך האובייקט הזה כ-blob.

חזרה

Blob – הנתונים כ-blob.

getDateCreated()

הפונקציה מקבלת את התאריך שבו ה-File נוצר.

חזרה

Date – התאריך שבו נוצר ה-File

אישור

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

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

getDescription()

הפונקציה מקבלת את התיאור של ה-File.

חזרה

String – התיאור של File

אישור

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

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

getDownloadUrl()

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

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

// Loops through the files and logs the download URLs to the console.
while (files.hasNext()) {
  const file = files.next();
  console.log(file.getDownloadUrl());
}

חזרה

String – כתובת ה-URL שאפשר להשתמש בה כדי להוריד את הקובץ.

אישור

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

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

getEditors()

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

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

// Loops through the files.
while (files.hasNext()) {
  const file = files.next();

  // Adds the email addresses in the array as editors of each file.
  // TODO(developer): Replace 'cloudysanfrancisco@gmail.com'
  // and 'baklavainthebalkans@gmail.com' with valid email addresses.
  file.addEditors([
    'cloudysanfrancisco@gmail.com',
    'baklavainthebalkans@gmail.com',
  ]);

  // Gets a list of the file editors.
  const editors = file.getEditors();

  // For each file, logs the editors' email addresses to the console.
  for (const editor of editors) {
    console.log(editor.getEmail());
  }
}

חזרה

User[] — אם למשתמש יש הרשאת עריכה ב-File הזה, הפונקציה מחזירה את רשימת העריכה. אם למשתמש אין הרשאת עריכה, הפונקציה מחזירה מערך ריק.

אישור

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

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

getId()

הפונקציה מקבלת את המזהה של ה-File.

חזרה

String – המזהה של File

אישור

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

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

getLastUpdated()

הפונקציה מקבלת את התאריך שבו File עודכן לאחרונה.

חזרה

Date – התאריך שבו File עודכן לאחרונה

אישור

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

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

getMimeType()

הפונקציה מקבלת את סוג ה-MIME של הקובץ. 

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

// Loops through the files and logs the MIME type to the console.
while (files.hasNext()) {
  const file = files.next();
  console.log(file.getMimeType());
}

חזרה

String – סוג ה-MIME של הקובץ.

אישור

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

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

getName()

הפונקציה מקבלת את השם של ה-File.

חזרה

String – השם של File

אישור

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

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

getOwner()

הצגת הבעלים של הקובץ. 

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

// Loops through the files and logs the names of the file owners to the console.
while (files.hasNext()) {
  const file = files.next();
  console.log(file.getOwner().getName());
}

חזרה

User – הבעלים של הקובץ.

אישור

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

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

getParents()

הפונקציה מקבלת אוסף של תיקיות שהן תיקיות הורה מיידיות של File.

חזרה

FolderIterator – אוסף של תיקיות שהן הורים מיידיים של File

אישור

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

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

getResourceKey()

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

חזרה

String – מפתח המשאב של File.

אישור

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

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

getSecurityUpdateEligible()

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

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

מידע נוסף על עדכון האבטחה ל-Google Drive

חזרה

Boolean – האם ניתן להחיל את הדרישה למפתח המשאב על File.

אישור

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

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

getSecurityUpdateEnabled()

הפונקציה מקבלת את הערך שמציין אם File הזה מחייב מפתח משאב לגישה כשהוא שותף באמצעות קישור. הדרישה הזו מופעלת כברירת מחדל בקבצים ובתיקיות שעומדים בדרישות. כדי להפעיל או להשבית את הדרישה למפתח משאב בקבצים שעומדים בדרישות, משתמשים ב- setSecurityUpdateEnabled.

מידע נוסף על עדכון האבטחה ל-Google Drive

חזרה

Boolean – האם הדרישה למפתח משאב מופעלת עבור File הזה.

אישור

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

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

getSharingAccess()

הפונקציה מקבלת את סוג המשתמשים שיכולים לגשת ל-File, מלבד משתמשים ספציפיים שקיבלו גישה באופן מפורש.

חזרה

Access – קבוצת המשתמשים שיכולה לגשת ל-File

אישור

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

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

getSharingPermission()

הפונקציה מקבלת את ההרשאה שהוענקה למשתמשים שיכולים לגשת ל-File, מלבד משתמשים ספציפיים שקיבלו גישה באופן מפורש.

חזרה

Permission – ההרשאות שהוקצו למשתמשים שיש להם גישה ל-File

אישור

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

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

getSize()

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

חזרה

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

אישור

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

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

getTargetId()

אם מדובר בקיצור דרך, הפונקציה מחזירה את המזהה של הפריט שאליו הוא מפנה.

אחרת, הפונקציה מחזירה את הערך null. 

// The ID of the file for which to make a shortcut and the ID of
// the folder to which you want to add the shortcut.
// TODO(developer): Replace the file and folder IDs with your IDs.
const fileId = 'abc123456';
const folderId = 'xyz987654';

// Gets the folder to add the shortcut to.
const folder = DriveApp.getFolderById(folderId);

// Creates a shortcut of the file and moves it to the specified folder.
const shortcut = DriveApp.createShortcut(fileId).moveTo(folder);

// Logs the target ID of the shortcut.
console.log(`${shortcut.getName()}=${shortcut.getTargetId()}`);

חזרה

String – מזהה הפריט היעד.

getTargetMimeType()

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

אחרת, הפונקציה מחזירה את הערך null. 

// The ID of the file for which to make a shortcut and the ID of
// the folder to which you want to add the shortcut.
// TODO(developer): Replace the file and folder IDs with your IDs.
const fileId = 'abc123456';
const folderId = 'xyz987654';

// Gets the folder to add the shortcut to.
const folder = DriveApp.getFolderById(folderId);

// Creates a shortcut of the file and moves it to the specified folder.
const shortcut = DriveApp.createShortcut(fileId).moveTo(folder);

// Logs the MIME type of the file that the shortcut points to.
console.log(`MIME type of the shortcut: ${shortcut.getTargetMimeType()}`);

חזרה

String – סוג ה-MIME של פריט היעד.

getTargetResourceKey()

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

אם הקובץ הוא לא קיצור דרך, הפונקציה מחזירה את הערך null. 

//  Gets a file by its ID.
//  TODO(developer): Replace 'abc123456' with your file ID.
const file = DriveApp.getFileById('abc123456');

// If the file is a shortcut, returns the resource key of the file that it
// points to.
console.log(file.getTargetResourceKey());

חזרה

String – מפתח המשאב של פריט היעד, או null אם הקובץ הוא לא קיצור דרך.

אישור

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

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

getThumbnail()

הפונקציה מקבלת תמונה ממוזערת של הקובץ, או את הערך null אם אין תמונה ממוזערת. 

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

// Loops through the files.
while (files.hasNext()) {
  const file = files.next();

  // Logs the thumbnail image for each file to the console as a blob,
  // or null if no thumbnail exists.
  console.log(file.getThumbnail());
}

חזרה

Blob — התמונה הממוזערת של הקובץ.

אישור

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

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

getUrl()

הפונקציה מקבלת את כתובת ה-URL שאפשר להשתמש בה כדי לפתוח את File באפליקציית Google כמו Drive או Docs.

חזרה

String – כתובת ה-URL שבאמצעותה אפשר להציג את File באפליקציית Google כמו Drive או Docs

אישור

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

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

getViewers()

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

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

// Loops through the files.
while (files.hasNext()) {
  const file = files.next();

  // For each file, logs the viewers' email addresses to the console.
  const viewers = file.getViewers();
  for (const viewer of viewers) {
    console.log(viewer.getEmail());
  }
}

חזרה

User[] — אם למשתמש יש גישת עריכה ל-File הזה, הפונקציה מחזירה את רשימת הצופים והמגיבים. אם למשתמש אין הרשאת עריכה, הפונקציה מחזירה מערך ריק.

אישור

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

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

isShareableByEditors()

ההגדרה קובעת אם משתמשים עם הרשאות עריכה ב-File מורשים לשתף עם משתמשים אחרים או לשנות את ההרשאות.

חזרה

Boolean — true אם משתמשים עם הרשאת עריכה מורשים לשתף עם משתמשים אחרים או לשנות את ההרשאות, false אם לא

אישור

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

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

isStarred()

קובעת אם ה-File סומן בכוכב ב-Drive של המשתמש.

חזרה

Boolean — true אם ה-File מסומן בכוכב ב-Drive של המשתמש, false אם לא

אישור

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

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

isTrashed()

קובעת אם הקובץ File נמצא באשפה ב-Drive של המשתמש.

חזרה

Boolean — true אם ה-File נמצא באשפה של Drive של המשתמש, false אם לא

אישור

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

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

makeCopy()

יצירת עותק של הקובץ. 

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

// Loops through the files.
while (files.hasNext()) {
  const file = files.next();

  // Creates a copy of each file and logs the file name to the console.
  console.log(file.makeCopy().getName());
}

חזרה

File – העותק החדש.

אישור

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

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

makeCopy(destination)

יצירת עותק של הקובץ בספריית היעד. 

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

// Loops through the files.
while (files.hasNext()) {
  const file = files.next();

  // Creates a copy of each file and adds it to the specified folder.
  // TODO(developer): Replace the folder ID with your own.
  const destination = DriveApp.getFolderById('123456abcxyz');
  const copiedFile = file.makeCopy(destination);

  // Logs the file names to the console.
  console.log(copiedFile.getName());
}

פרמטרים

שםסוגתיאור
destinationFolderהספרייה שאליה רוצים להעתיק את הקובץ.

חזרה

File – העותק החדש.

אישור

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

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

makeCopy(name)

יצירת עותק של הקובץ והענקת שם לפי השם שצוין. 

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

// Loops through the files.
while (files.hasNext()) {
  const file = files.next();

  // Creates a copy of each file and sets the name to 'Test-Copy.'
  const filename = file.makeCopy('Test-Copy');

  // Logs the copied file's name to the console.
  console.log(filename.getName());
}

פרמטרים

שםסוגתיאור
nameStringשם הקובץ שצריך להחיל על העותק החדש.

חזרה

File – העותק החדש.

אישור

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

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

makeCopy(name, destination)

יצירת עותק של הקובץ בספריית היעד והענקת שם לקובץ. 

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

// Loops through the files.
while (files.hasNext()) {
  const file = files.next();

  // Creates a copy of each file, sets the file name, and adds the copied file
  // to the specified folder.
  // TODO(developer): Replace the folder ID with your own.
  const destination = DriveApp.getFolderById('123456abcxyz');
  const copiedFile = file.makeCopy('Test-Copy', destination);

  // Logs the file names to the console.
  console.log(copiedFile.getName());
}

פרמטרים

שםסוגתיאור
nameStringשם הקובץ שצריך להחיל על העותק החדש.
destinationFolderהספרייה שאליה רוצים להעתיק את הקובץ.

חזרה

File – העותק החדש.

אישור

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

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

moveTo(destination)

העברת הפריט הזה לתיקיית היעד שצוינה.

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

פרמטרים

שםסוגתיאור
destinationFolderהתיקייה שתהפוך לתיקיית האב החדשה.

חזרה

File — השדה File, לצורך קישור.

אישור

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

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

removeCommenter(emailAddress)

הסרת המשתמש הנתון מרשימת המגיבים ב-File. השיטה הזו לא חוסמת את הגישה של משתמשים ל-File אם הם שייכים לקבוצת משתמשים שיש להם גישה כללית – לדוגמה, אם ה-File משותף עם כל הדומיין של המשתמש. 

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

// Loops through the files.
while (files.hasNext()) {
  const file = files.next();

  // Removes the given user from the list of commenters for each file.
  // TODO(developer): Replace the email with the email of the user you want to
  // remove.
  file.removeCommenter('cloudysanfrancisco@gmail.com');
}

פרמטרים

שםסוגתיאור
emailAddressStringכתובת האימייל של המשתמש שרוצים להסיר.

חזרה

File — השדה File, לצורך קישור.

אישור

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

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

removeCommenter(user)

הסרת המשתמש הנתון מרשימת המגיבים ב-File. השיטה הזו לא חוסמת את הגישה של משתמשים ל-File אם הם שייכים לקבוצת משתמשים שיש להם גישה כללית – לדוגמה, אם ה-File משותף עם כל הדומיין של המשתמש. 

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

// Loops through the files.
while (files.hasNext()) {
  const file = files.next();

  // Removes the given user from the list of commenters for each file.
  console.log(file.removeCommenter(Session.getActiveUser()));
}

פרמטרים

שםסוגתיאור
userUserייצוג של המשתמש שרוצים להסיר.

חזרה

File — השדה File, לצורך קישור.

אישור

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

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

removeEditor(emailAddress)

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

בקבצים ב-Drive, הפעולה הזו מסירה את המשתמש גם מרשימת הצופים.

פרמטרים

שםסוגתיאור
emailAddressStringכתובת האימייל של המשתמש שרוצים להסיר.

חזרה

File — השדה File, לצורך קישור.

אישור

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

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

removeEditor(user)

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

בקבצים ב-Drive, הפעולה הזו מסירה את המשתמש גם מרשימת הצופים.

פרמטרים

שםסוגתיאור
userUserייצוג של המשתמש שרוצים להסיר.

חזרה

File — השדה File, לצורך קישור.

אישור

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

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

removeViewer(emailAddress)

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

בקבצים ב-Drive, הפעולה הזו תסיר גם את המשתמש מרשימת העריכה.

פרמטרים

שםסוגתיאור
emailAddressStringכתובת האימייל של המשתמש שרוצים להסיר.

חזרה

File — File לשרשור.

אישור

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

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

removeViewer(user)

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

בקבצים ב-Drive, הפעולה הזו תסיר גם את המשתמש מרשימת העריכה.

פרמטרים

שםסוגתיאור
userUserייצוג של המשתמש שרוצים להסיר.

חזרה

File — File לשרשור.

אישור

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

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

revokePermissions(emailAddress)

ביטול הגישה ל-File שהוקצה למשתמש הנתון. השיטה הזו לא מונעת ממשתמשים לגשת ל-File אם הם שייכים לקבוצת משתמשים שיש להם גישה כללית – לדוגמה, אם ה-File משותף עם כל הדומיין של המשתמש.

פרמטרים

שםסוגתיאור
emailAddressStringכתובת האימייל של המשתמש שרוצים לבטל את הגישה שלו.

חזרה

File — השדה File, לצורך קישור.

אישור

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

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

revokePermissions(user)

ביטול הגישה ל-File שהוקצה למשתמש הנתון. השיטה הזו לא מונעת ממשתמשים לגשת ל-File אם הם שייכים לקבוצת משתמשים שיש להם גישה כללית – לדוגמה, אם ה-File משותף עם כל הדומיין של המשתמש.

פרמטרים

שםסוגתיאור
userUserייצוג של המשתמש שצריך לבטל את הגישה שלו.

חזרה

File — השדה File, לצורך קישור.

אישור

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

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

setContent(content)

מחליף את תוכן הקובץ בתוכן חלופי נתון. אם content גדול מ-10MB, מתרחשת זריקה של חריגה. 

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

// Logs the content of the text file to the console.
console.log(file.getBlob().getDataAsString());

// Updates the content of the text file to 'Updated text!'
file.setContent('Updated text!');

// Logs content of the text file to the console.
console.log(file.getBlob().getDataAsString());

פרמטרים

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

חזרה

File — השדה File, לצורך קישור.

אישור

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

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

setDescription(description)

הגדרת התיאור של File.

פרמטרים

שםסוגתיאור
descriptionStringהתיאור החדש של File

חזרה

File — ה-File הזה, לשרשור

אישור

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

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

setName(name)

הגדרת השם של File.

פרמטרים

שםסוגתיאור
nameStringהשם החדש של File

חזרה

File — ה-File הזה, לשרשור

אישור

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

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

setOwner(emailAddress)

שינוי הבעלים של File. השיטה הזו גם מעניקה לבעלים הקודם הרשאת עריכה מפורשת ב-File.

פרמטרים

שםסוגתיאור
emailAddressStringכתובת האימייל של המשתמש שצריך להפוך לבעלים החדש

חזרה

File — ה-File הזה, לשרשור

אישור

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

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

setOwner(user)

שינוי הבעלים של File. השיטה הזו גם מעניקה לבעלים הקודם הרשאת עריכה מפורשת ב-File.

פרמטרים

שםסוגתיאור
userUserייצוג של המשתמש שצריך להפוך לבעלים החדש

חזרה

File — ה-File הזה, לשרשור

אישור

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

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

setSecurityUpdateEnabled(enabled)

מגדיר אם File מחייב מפתח משאב לגישה כשהוא שותף באמצעות קישור. קבצים ותיקיות שעומדים בדרישות מופעלים כברירת מחדל.

מידע נוסף על עדכון האבטחה ל-Google Drive

פרמטרים

שםסוגתיאור
enabledBooleanהאם להפעיל את הדרישה למפתח משאב עבור File.

חזרה

File — השדה File, לצורך קישור.

אישור

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

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

setShareableByEditors(shareable)

ההגדרה קובעת אם משתמשים עם הרשאות עריכה ב-File מורשים לשתף את הקובץ עם משתמשים אחרים או לשנות את ההרשאות. ערך ברירת המחדל של File חדש הוא true.

פרמטרים

שםסוגתיאור
shareableBooleantrue אם משתמשים עם הרשאת עריכה יכולים לשתף עם משתמשים אחרים או לשנות את ההרשאות, false אם לא

חזרה

File — ה-File הזה, לשרשור

אישור

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

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

setSharing(accessType, permissionType)

מגדיר לאילו משתמשים תהיה גישה ל-File ואילו הרשאות יוענקו להם, מלבד משתמשים ספציפיים שקיבלו גישה באופן מפורש. 

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

פרמטרים

שםסוגתיאור
accessTypeAccessלאילו משתמשים צריכה להיות גישה ל-File
permissionTypePermissionההרשאות שצריך להקצות למשתמשים שיש להם גישה ל-File

חזרה

File — ה-File הזה, לשרשור

אישור

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

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

setStarred(starred)

מגדיר אם ה-File מסומן בכוכב ב-Drive של המשתמש. ערך ברירת המחדל של File חדש הוא false.

פרמטרים

שםסוגתיאור
starredBooleantrue אם צריך לסמן את File בכוכב ב-Drive של המשתמש, false אם לא

חזרה

File — ה-File הזה, לשרשור

אישור

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

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

setTrashed(trashed)

מגדיר אם ה-File נמצא באשפה ב-Drive של המשתמש. רק הבעלים יכול להעביר את File לאשפה. ערך ברירת המחדל של File חדשים הוא false.

פרמטרים

שםסוגתיאור
trashedBooleantrue אם צריך להעביר את File לאשפה ב-Drive של המשתמש, false אם לא

חזרה

File — ה-File הזה, לשרשור

אישור

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

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