Class File

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

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

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

פרמטרים

חזרה

‫File — File, לשרשור.

אישור

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

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

הוספת המשתמש שצוין לרשימת המגיבים של 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());
}

פרמטרים

חזרה

‫File — File, לשרשור.

אישור

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

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

הוספת מערך המשתמשים שצוין לרשימת המגיבים של 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));
}

פרמטרים

חזרה

‫File — File, לשרשור.

אישור

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

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

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

פרמטרים

חזרה

‫File — File, לשרשור.

אישור

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

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

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

פרמטרים

חזרה

‫File — File, לשרשור.

אישור

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

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

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

פרמטרים

חזרה

‫File — File, לשרשור.

אישור

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

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

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

פרמטרים

חזרה

‫File — File, לשרשור.

אישור

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

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

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

פרמטרים

חזרה

‫File — File, לשרשור.

אישור

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

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

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

פרמטרים

חזרה

‫File — File, לשרשור.

אישור

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

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

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

פרמטרים

חזרה

‫Permission – ההרשאות שניתנו למשתמש.

אישור

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

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

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

פרמטרים

חזרה

‫Permission – ההרשאות שניתנו למשתמש.

אישור

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

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

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

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

פרמטרים

חזרה

‫Blob — הנתונים כ-blob.

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

חזרה

‫Blob — הנתונים כ-blob.

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

חזרה

‫Date — התאריך שבו נוצר File

אישור

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

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

מחזירה את התיאור של File.

חזרה

‫String – התיאור של File

אישור

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

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

מחזירה את כתובת ה-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

מקבל את רשימת העורכים של 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

הפונקציה מחזירה את המזהה של File.

חזרה

‫String — המזהה של File

אישור

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

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

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

חזרה

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

אישור

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

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

מחזירה את סוג ה-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

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

חזרה

‫String – השם של File

אישור

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

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

מחזירה את הבעלים של הקובץ.

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

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

חזרה

‫FolderIterator — אוסף של תיקיות שהן הורים ישירים של File

אישור

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

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

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

חזרה

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

אישור

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

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

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

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

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

חזרה

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

אישור

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

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

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

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

חזרה

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

אישור

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

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

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

חזרה

‫Access — איזו קבוצת משתמשים יכולה לגשת ל-File

אישור

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

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

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

חזרה

‫Permission — ההרשאות שניתנות למשתמשים שיכולים לגשת אל File

אישור

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

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

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

חזרה

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

אישור

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

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

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

אחרת, הפונקציה מחזירה את הערך 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 – מזהה פריט היעד.

אם מדובר בקיצור דרך, הפונקציה מחזירה את סוג ה-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 של פריט היעד.

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

אם הקובץ הוא לא קיצור דרך, הפונקציה מחזירה 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

מחזירה תמונה ממוזערת של הקובץ, או 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|null – התמונה הממוזערת של הקובץ.

אישור

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

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

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

חזרה

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

אישור

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

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

מחזירה את רשימת הצופים והמגיבים של 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

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

חזרה

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

אישור

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

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

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

חזרה

‫Boolean – true אם File מסומן בכוכב ב-Drive של המשתמש; false אם לא

אישור

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

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

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

חזרה

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

אישור

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

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

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

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

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

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

פרמטרים

חזרה

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

אישור

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

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

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

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

פרמטרים

חזרה

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

אישור

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

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

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

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

פרמטרים

חזרה

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

אישור

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

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

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

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

פרמטרים

חזרה

‫File — File, לשרשור.

אישור

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

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

מסיר את המשתמש שצוין מרשימת המגיבים של 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');
}

פרמטרים

חזרה

‫File — File, לשרשור.

אישור

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

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

מסיר את המשתמש שצוין מרשימת המגיבים של 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()));
}

פרמטרים

חזרה

‫File — File, לשרשור.

אישור

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

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

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

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

פרמטרים

חזרה

‫File — File, לשרשור.

אישור

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

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

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

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

פרמטרים

חזרה

‫File — File, לשרשור.

אישור

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

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

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

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

פרמטרים

חזרה

‫File — This File for chaining.

אישור

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

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

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

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

פרמטרים

חזרה

‫File — This File for chaining.

אישור

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

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

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

פרמטרים

חזרה

‫File — File, לשרשור.

אישור

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

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

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

פרמטרים

חזרה

‫File — File, לשרשור.

אישור

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

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

התוכן של הקובץ נכתב מחדש עם ההחלפה שצוינה. הפונקציה מחזירה חריגה אם 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());

פרמטרים

חזרה

‫File — File, לשרשור.

אישור

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

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

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

פרמטרים

חזרה

‫File — ‏File, לשרשור

אישור

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

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

מגדיר את השם של File.

פרמטרים

חזרה

‫File — ‏File, לשרשור

אישור

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

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

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

פרמטרים

חזרה

‫File — ‏File, לשרשור

אישור

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

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

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

פרמטרים

חזרה

‫File — ‏File, לשרשור

אישור

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

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

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

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

פרמטרים

חזרה

‫File — File, לשרשור.

אישור

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

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

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

פרמטרים

חזרה

‫File — ‏File, לשרשור

אישור

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

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

ההגדרה הזו קובעת לאיזה סוג של משתמשים תהיה גישה ל-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);

פרמטרים

חזרה

‫File — ‏File, לשרשור

אישור

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

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

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

פרמטרים

חזרה

‫File — ‏File, לשרשור

אישור

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

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

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

פרמטרים

חזרה

‫File — ‏File, לשרשור

אישור

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

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