תיקייה ב-Google Drive. אפשר לגשת לתיקיות או ליצור אותן מ-Drive.
// Log the name of every folder in the user's Drive. const folders = DriveApp.getFolders(); while (folders.hasNext()) { const folder = folders.next(); Logger.log(folder.getName()); }
Methods
| שיטה | סוג הערך שמוחזר | תיאור קצר |
|---|---|---|
add | Folder | הפונקציה מוסיפה את המשתמש שצוין לרשימת העורכים של Folder. |
add | Folder | הפונקציה מוסיפה את המשתמש שצוין לרשימת העורכים של Folder. |
add | Folder | מוסיף את מערך המשתמשים שצוין לרשימת בעלי הרשאת העריכה של Folder. |
add | Folder | הפונקציה מוסיפה את המשתמש שצוין לרשימת הצופים של Folder. |
add | Folder | הפונקציה מוסיפה את המשתמש שצוין לרשימת הצופים של Folder. |
add | Folder | הפונקציה מוסיפה את מערך המשתמשים שצוין לרשימת הצופים של Folder. |
create | File | יוצר קובץ בתיקייה הנוכחית מ-Blob נתון של נתונים שרירותיים. |
create | File | יוצר קובץ טקסט בתיקייה הנוכחית עם השם והתוכן שצוינו. |
create | File | יוצרת קובץ בתיקייה הנוכחית עם השם, התוכן וסוג ה-MIME שצוינו. |
create | Folder | יוצר תיקייה בתיקייה הנוכחית עם השם שצוין. |
create | File | יוצרת קיצור דרך למזהה הפריט שצוין ב-Drive ומחזירה אותו. |
create | File | יוצרת קיצור דרך למזהה הפריט ולמפתח המשאב שצוינו ב-Drive, ומחזירה אותו. |
get | Permission | מקבל את ההרשאה שניתנה למשתמש ספציפי. |
get | Permission | מקבל את ההרשאה שניתנה למשתמש ספציפי. |
get | Date | הפונקציה מחזירה את התאריך שבו נוצר Folder. |
get | String | הפונקציה מחזירה את התיאור של Folder. |
get | User[] | מחזירה את רשימת העורכים של ה-Folder הזה. |
get | File | מקבל אוסף של כל הקבצים שהם צאצאים של התיקייה הנוכחית. |
get | File | מחזירה אוסף של כל הקבצים שהם צאצאים של התיקייה הנוכחית ויש להם את השם שצוין. |
get | File | הפונקציה מחזירה אוסף של כל הקבצים שהם צאצאים של התיקייה הנוכחית ושיש להם את סוג ה-MIME שצוין. |
get | Folder | מחזירה אוסף של כל התיקיות שהן צאצאים של התיקייה הנוכחית. |
get | Folder | הפונקציה מחזירה אוסף של כל התיקיות שהן צאצאים של התיקייה הנוכחית ויש להן את השם שצוין. |
get | String | הפונקציה מחזירה את המזהה של Folder. |
get | Date | מחזירה את התאריך שבו Folder עודכן לאחרונה. |
get | String | הפונקציה מחזירה את השם של Folder. |
get | User | הפונקציה מחזירה את הבעלים של ה-Folder הזה. |
get | Folder | מחזירה אוסף של תיקיות שהן תיקיות אב ישירות של Folder. |
get | String | מקבל את מפתח המשאב של Folder שנדרש לגישה לפריטים ששותפו באמצעות קישור. |
get | Boolean | מחזירה אם אפשר להחיל על Folder את עדכון האבטחה שדורש קוד גישה כדי לגשת אליו כשמשתפים אותו באמצעות קישור. |
get | Boolean | הפונקציה מחזירה את הערך true אם נדרש מפתח משאב כדי לגשת ל-Folder כשמשתפים אותו באמצעות קישור, אחרת היא מחזירה את הערך false. |
get | Access | הפונקציה מחזירה את סוג המשתמשים שיכולים לגשת אל Folder, בנוסף למשתמשים פרטיים שקיבלו גישה באופן מפורש. |
get | Permission | מקבל את ההרשאה שניתנה למשתמשים שיכולים לגשת אל Folder, בנוסף לכל משתמש בודד שקיבל גישה באופן מפורש. |
get | Integer | הפונקציה מחזירה את מספר הבייטים שמשמשים לאחסון Folder ב-Drive. |
get | String | מחזירה את כתובת ה-URL שאפשר להשתמש בה כדי לפתוח את Folder באפליקציית Google כמו Drive או Docs. |
get | User[] | הפונקציה מחזירה את רשימת הצופים והמגיבים של ה-Folder הזה. |
is | Boolean | ההגדרה קובעת אם משתמשים עם הרשאות עריכה ב-Folder יכולים לשתף עם משתמשים אחרים או לשנות את ההרשאות. |
is | Boolean | ההגדרה קובעת אם Folder סומן בכוכב ב-Drive של המשתמש. |
is | Boolean | ההגדרה קובעת אם הקובץ Folder נמצא באשפה ב-Drive של המשתמש. |
move | Folder | העברת הפריט לתיקיית היעד שצוינה. |
remove | Folder | מסיר את המשתמש שצוין מרשימת העורכים של Folder. |
remove | Folder | מסיר את המשתמש שצוין מרשימת העורכים של Folder. |
remove | Folder | הסרת המשתמש שצוין מרשימת הצופים והמגיבים של Folder. |
remove | Folder | הסרת המשתמש שצוין מרשימת הצופים והמגיבים של Folder. |
revoke | Folder | מבטלת את הגישה אל Folder שהוענקה למשתמש מסוים. |
revoke | Folder | מבטלת את הגישה אל Folder שהוענקה למשתמש מסוים. |
search | File | מקבל אוסף של כל הקבצים שהם צאצאים של התיקייה הנוכחית ותואמים לקריטריוני החיפוש שצוינו. |
search | Folder | מאחזר אוסף של כל התיקיות שהן צאצאים של התיקייה הנוכחית ותואמות לקריטריוני החיפוש שצוינו. |
set | Folder | מגדיר את התיאור של Folder. |
set | Folder | מגדיר את השם של Folder. |
set | Folder | שינוי הבעלים של Folder. |
set | Folder | שינוי הבעלים של Folder. |
set | Folder | ההגדרה קובעת אם נדרש מפתח משאב לגישה ל-Folder כשהוא משותף באמצעות קישור. |
set | Folder | ההגדרה קובעת אם משתמשים עם הרשאת עריכה ב-Folder יכולים לשתף עם משתמשים אחרים או לשנות את ההרשאות. |
set | Folder | ההגדרה הזו קובעת לאיזה סוג של משתמשים תהיה גישה ל-Folder ואילו הרשאות יקבלו המשתמשים האלה, בנוסף למשתמשים ספציפיים שקיבלו גישה באופן מפורש. |
set | Folder | הגדרה של סימון Folder בכוכב ב-Drive של המשתמש. |
set | Folder | קובעת אם Folder נמצא באשפה ב-Drive של המשתמש. |
תיעוד מפורט
add Editor(emailAddress)
הפונקציה מוסיפה את המשתמש שצוין לרשימת העורכים של Folder. אם המשתמש כבר היה ברשימת הצופים, השיטה הזו מוציאה את המשתמש מרשימת הצופים.
פרמטרים
| שם | סוג | תיאור |
|---|---|---|
email | String | כתובת האימייל של המשתמש שרוצים להוסיף. |
חזרה
אישור
סקריפטים שמשתמשים בשיטה הזו דורשים הרשאה עם אחת או יותר מההיקפים הבאים:
-
https://www.googleapis.com/auth/drive
add Editor(user)
הפונקציה מוסיפה את המשתמש שצוין לרשימת העורכים של Folder. אם המשתמש כבר היה ברשימת הצופים, השיטה הזו מוציאה את המשתמש מרשימת הצופים.
פרמטרים
| שם | סוג | תיאור |
|---|---|---|
user | User | ייצוג של המשתמש שרוצים להוסיף. |
חזרה
אישור
סקריפטים שמשתמשים בשיטה הזו דורשים הרשאה עם אחת או יותר מההיקפים הבאים:
-
https://www.googleapis.com/auth/drive
add Editors(emailAddresses)
מוסיף את מערך המשתמשים שצוין לרשימת בעלי הרשאת העריכה של Folder. אם חלק מהמשתמשים כבר היו ברשימת הצופים, השיטה הזו תוציא אותם מרשימת הצופים.
פרמטרים
| שם | סוג | תיאור |
|---|---|---|
email | String[] | מערך של כתובות אימייל של המשתמשים שרוצים להוסיף. |
חזרה
אישור
סקריפטים שמשתמשים בשיטה הזו דורשים הרשאה עם אחת או יותר מההיקפים הבאים:
-
https://www.googleapis.com/auth/drive
add Viewer(emailAddress)
הפונקציה מוסיפה את המשתמש שצוין לרשימת הצופים של Folder. אם המשתמש כבר נמצא ברשימת העורכים, לשיטה הזו אין השפעה.
פרמטרים
| שם | סוג | תיאור |
|---|---|---|
email | String | כתובת האימייל של המשתמש שרוצים להוסיף. |
חזרה
אישור
סקריפטים שמשתמשים בשיטה הזו דורשים הרשאה עם אחת או יותר מההיקפים הבאים:
-
https://www.googleapis.com/auth/drive
add Viewer(user)
add Viewers(emailAddresses)
הפונקציה מוסיפה את מערך המשתמשים שצוין לרשימת הצופים של Folder. אם חלק מהמשתמשים כבר היו ברשימת העורכים, השיטה הזו לא תשפיע עליהם.
פרמטרים
| שם | סוג | תיאור |
|---|---|---|
email | String[] | מערך של כתובות אימייל של המשתמשים שרוצים להוסיף. |
חזרה
אישור
סקריפטים שמשתמשים בשיטה הזו דורשים הרשאה עם אחת או יותר מההיקפים הבאים:
-
https://www.googleapis.com/auth/drive
create File(blob)
יוצר קובץ בתיקייה הנוכחית מ-Blob נתון של נתונים שרירותיים.
פרמטרים
| שם | סוג | תיאור |
|---|---|---|
blob | Blob | הנתונים של הקובץ החדש. |
חזרה
File – הקובץ החדש.
אישור
סקריפטים שמשתמשים בשיטה הזו דורשים הרשאה עם אחת או יותר מההיקפים הבאים:
-
https://www.googleapis.com/auth/drive
create File(name, content)
יוצר קובץ טקסט בתיקייה הנוכחית עם השם והתוכן שצוינו. הפונקציה זורקת חריגה אם content גדול מ-50MB.
// Create a text file with the content "Hello, world!" DriveApp.getRootFolder().createFile('New Text File', 'Hello, world!');
פרמטרים
| שם | סוג | תיאור |
|---|---|---|
name | String | השם של הקובץ החדש. |
content | String | התוכן של הקובץ החדש. |
חזרה
File – הקובץ החדש.
אישור
סקריפטים שמשתמשים בשיטה הזו דורשים הרשאה עם אחת או יותר מההיקפים הבאים:
-
https://www.googleapis.com/auth/drive
create File(name, content, mimeType)
יוצרת קובץ בתיקייה הנוכחית עם השם, התוכן וסוג ה-MIME שצוינו. מוחזרת שגיאה אם content גדול מ-10MB.
// Create an HTML file with the content "Hello, world!" DriveApp.getRootFolder().createFile('New HTML File', '<b>Hello, world!</b>', MimeType.HTML);
פרמטרים
| שם | סוג | תיאור |
|---|---|---|
name | String | השם של הקובץ החדש. |
content | String | התוכן של הקובץ החדש. |
mime | String | סוג ה-MIME של הקובץ החדש. |
חזרה
File – הקובץ החדש.
אישור
סקריפטים שמשתמשים בשיטה הזו דורשים הרשאה עם אחת או יותר מההיקפים הבאים:
-
https://www.googleapis.com/auth/drive
create Folder(name)
create Shortcut(targetId)
create Shortcut For Target Id And Resource Key(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(), ); }
פרמטרים
| שם | סוג | תיאור |
|---|---|---|
target | String | המזהה של קובץ היעד או תיקיית היעד. |
target | String | מפתח המשאבים של קובץ היעד או תיקיית היעד. |
חזרה
File – קיצור הדרך החדש.
אישור
סקריפטים שמשתמשים בשיטה הזו דורשים הרשאה עם אחת או יותר מההיקפים הבאים:
-
https://www.googleapis.com/auth/drive
get Access(email)
מקבל את ההרשאה שניתנה למשתמש ספציפי. השיטה לא תומכת בהחזרת הרשאות לקבוצת Google או בהרשאות שמתקבלות בירושה דרך קבוצות Google.
פרמטרים
| שם | סוג | תיאור |
|---|---|---|
email | String | כתובת האימייל של המשתמש שההרשאות שלו צריכות להיבדק. אין תמיכה ב-Google Groups. |
חזרה
Permission – ההרשאות שניתנו למשתמש.
אישור
סקריפטים שמשתמשים בשיטה הזו דורשים הרשאה עם אחת או יותר מההיקפים הבאים:
-
https://www.googleapis.com/auth/drive.readonly -
https://www.googleapis.com/auth/drive
get Access(user)
מקבל את ההרשאה שניתנה למשתמש ספציפי. השיטה לא תומכת בהחזרת הרשאות לקבוצת Google או בהרשאות שמתקבלות בירושה דרך קבוצות Google.
פרמטרים
| שם | סוג | תיאור |
|---|---|---|
user | User | ייצוג של המשתמש שההרשאות שלו צריכות להיבדק. |
חזרה
Permission – ההרשאות שניתנו למשתמש.
אישור
סקריפטים שמשתמשים בשיטה הזו דורשים הרשאה עם אחת או יותר מההיקפים הבאים:
-
https://www.googleapis.com/auth/drive.readonly -
https://www.googleapis.com/auth/drive
get Date Created()
get Description()
get Editors()
מחזירה את רשימת העורכים של ה-Folder הזה. אם למשתמש שמריץ את הסקריפט אין גישת עריכה ל-Folder, השיטה הזו מחזירה מערך ריק.
// Gets a folder by its ID. // TODO(developer): Replace the folder ID with your own. const folder = DriveApp.getFolderById('1234567890abcdefghijklmnopqrstuvwxyz'); // Gets the list of editors and logs their names to the console. const editors = folder.getEditors(); for (const editor of editors) { console.log(editor.getName()); }
חזרה
User[] — רשימת העורכים של Folder אם למשתמש יש הרשאת עריכה, או מערך ריק אחרת.
אישור
סקריפטים שמשתמשים בשיטה הזו דורשים הרשאה עם אחת או יותר מההיקפים הבאים:
-
https://www.googleapis.com/auth/drive.readonly -
https://www.googleapis.com/auth/drive
get Files()
מקבל אוסף של כל הקבצים שהם צאצאים של התיקייה הנוכחית.
חזרה
File – אוסף של כל הקבצים שהם צאצאים של התיקייה הנוכחית.
אישור
סקריפטים שמשתמשים בשיטה הזו דורשים הרשאה עם אחת או יותר מההיקפים הבאים:
-
https://www.googleapis.com/auth/drive.readonly -
https://www.googleapis.com/auth/drive
get Files By Name(name)
מחזירה אוסף של כל הקבצים שהם צאצאים של התיקייה הנוכחית ויש להם את השם שצוין.
פרמטרים
| שם | סוג | תיאור |
|---|---|---|
name | String | שם הקבצים שרוצים למצוא. |
חזרה
File — אוסף של כל הקבצים שהם צאצאים של התיקייה הנוכחית ויש להם את השם שצוין.
אישור
סקריפטים שמשתמשים בשיטה הזו דורשים הרשאה עם אחת או יותר מההיקפים הבאים:
-
https://www.googleapis.com/auth/drive.readonly -
https://www.googleapis.com/auth/drive
get Files By Type(mimeType)
הפונקציה מחזירה אוסף של כל הקבצים שהם צאצאים של התיקייה הנוכחית ושיש להם את סוג ה-MIME שצוין.
פרמטרים
| שם | סוג | תיאור |
|---|---|---|
mime | String | סוג ה-MIME של הקבצים לחיפוש. |
חזרה
File – אוסף של כל הקבצים שהם צאצאים של התיקייה הנוכחית ושיש להם את סוג ה-MIME שצוין.
אישור
סקריפטים שמשתמשים בשיטה הזו דורשים הרשאה עם אחת או יותר מההיקפים הבאים:
-
https://www.googleapis.com/auth/drive.readonly -
https://www.googleapis.com/auth/drive
get Folders()
מחזירה אוסף של כל התיקיות שהן צאצאים של התיקייה הנוכחית.
חזרה
Folder – אוסף של כל התיקיות שהן צאצאים של התיקייה הנוכחית.
אישור
סקריפטים שמשתמשים בשיטה הזו דורשים הרשאה עם אחת או יותר מההיקפים הבאים:
-
https://www.googleapis.com/auth/drive.readonly -
https://www.googleapis.com/auth/drive
get Folders By Name(name)
הפונקציה מחזירה אוסף של כל התיקיות שהן צאצאים של התיקייה הנוכחית ויש להן את השם שצוין.
פרמטרים
| שם | סוג | תיאור |
|---|---|---|
name | String | שם התיקייה שרוצים למצוא. |
חזרה
Folder — אוסף של כל התיקיות שהן צאצאים של התיקייה הנוכחית ויש להן את השם שצוין.
אישור
סקריפטים שמשתמשים בשיטה הזו דורשים הרשאה עם אחת או יותר מההיקפים הבאים:
-
https://www.googleapis.com/auth/drive.readonly -
https://www.googleapis.com/auth/drive
get Id()
get Last Updated()
get Name()
get Owner()
הפונקציה מחזירה את הבעלים של ה-Folder הזה.
// Gets a folder by its ID. // TODO(developer): Replace the folder ID with your own. const folder = DriveApp.getFolderById('1234567890abcdefghijklmnopqrstuvwxyz'); // Gets the owner of the folder and logs the name to the console. const folderOwner = folder.getOwner(); console.log(folderOwner.getName());
חזרה
אישור
סקריפטים שמשתמשים בשיטה הזו דורשים הרשאה עם אחת או יותר מההיקפים הבאים:
-
https://www.googleapis.com/auth/drive.readonly -
https://www.googleapis.com/auth/drive
get Parents()
מחזירה אוסף של תיקיות שהן תיקיות אב ישירות של Folder.
חזרה
Folder – אוסף של תיקיות שהן תיקיות אב מיידיות של Folder
אישור
סקריפטים שמשתמשים בשיטה הזו דורשים הרשאה עם אחת או יותר מההיקפים הבאים:
-
https://www.googleapis.com/auth/drive.readonly -
https://www.googleapis.com/auth/drive
get Resource Key()
get Security Update Eligible()
מחזירה אם אפשר להחיל על Folder את עדכון האבטחה שדורש קוד גישה כדי לגשת אליו כשמשתפים אותו באמצעות קישור.
כדי לגשת לקבצים או לתיקיות מסוימים ששותפו באמצעות קישור, צריך מפתח משאב ב-Drive. השינוי הזה הוא חלק מעדכון אבטחה. העדכון מופעל כברירת מחדל לקבצים ולתיקיות שעומדים בדרישות. כדי להפעיל או להשבית את הדרישה למפתח משאב בקבצים שעומדים בדרישות, משתמשים ב-set.
מידע נוסף על עדכון האבטחה ל-Google Drive
חזרה
Boolean – האם אפשר להחיל את הדרישה למפתח משאב על Folder.
אישור
סקריפטים שמשתמשים בשיטה הזו דורשים הרשאה עם אחת או יותר מההיקפים הבאים:
-
https://www.googleapis.com/auth/drive.readonly -
https://www.googleapis.com/auth/drive
get Security Update Enabled()
הפונקציה מחזירה את הערך true אם נדרש מפתח משאב כדי לגשת ל-Folder כשמשתפים אותו באמצעות קישור, אחרת היא מחזירה את הערך false. הדרישה הזו מופעלת כברירת מחדל לגבי קבצים ותיקיות שעומדים בדרישות.
כדי להפעיל או להשבית את הדרישה למפתח משאב בקבצים שעומדים בדרישות, משתמשים ב-
setSecurityUpdateEnabled.
מידע נוסף על עדכון האבטחה ל-Google Drive
חזרה
Boolean – האם הדרישה למפתח משאב מופעלת עבור Folder.
אישור
סקריפטים שמשתמשים בשיטה הזו דורשים הרשאה עם אחת או יותר מההיקפים הבאים:
-
https://www.googleapis.com/auth/drive.readonly -
https://www.googleapis.com/auth/drive
get Sharing Access()
הפונקציה מחזירה את סוג המשתמשים שיכולים לגשת אל Folder, בנוסף למשתמשים פרטיים שקיבלו גישה באופן מפורש.
חזרה
Access — איזו קבוצת משתמשים יכולה לגשת ל-Folder
אישור
סקריפטים שמשתמשים בשיטה הזו דורשים הרשאה עם אחת או יותר מההיקפים הבאים:
-
https://www.googleapis.com/auth/drive.readonly -
https://www.googleapis.com/auth/drive
get Sharing Permission()
מקבל את ההרשאה שניתנה למשתמשים שיכולים לגשת אל Folder, בנוסף לכל משתמש בודד שקיבל גישה באופן מפורש.
חזרה
Permission – ההרשאות שניתנות למשתמשים שיכולים לגשת אל Folder
אישור
סקריפטים שמשתמשים בשיטה הזו דורשים הרשאה עם אחת או יותר מההיקפים הבאים:
-
https://www.googleapis.com/auth/drive.readonly -
https://www.googleapis.com/auth/drive
get Size()
הפונקציה מחזירה את מספר הבייטים שמשמשים לאחסון Folder ב-Drive. שימו לב: קבצים של אפליקציות Google Workspace לא נכללים במגבלות האחסון ב-Drive, ולכן מחזירים 0 בייטים.
חזרה
Integer – מספר הבייטים שמשמשים לאחסון Folder ב-Drive
אישור
סקריפטים שמשתמשים בשיטה הזו דורשים הרשאה עם אחת או יותר מההיקפים הבאים:
-
https://www.googleapis.com/auth/drive.readonly -
https://www.googleapis.com/auth/drive
get Url()
מחזירה את כתובת ה-URL שאפשר להשתמש בה כדי לפתוח את Folder באפליקציית Google כמו Drive או Docs.
חזרה
String – כתובת ה-URL שאפשר להשתמש בה כדי להציג את Folder באפליקציית Google כמו Drive או Docs
אישור
סקריפטים שמשתמשים בשיטה הזו דורשים הרשאה עם אחת או יותר מההיקפים הבאים:
-
https://www.googleapis.com/auth/drive.readonly -
https://www.googleapis.com/auth/drive
get Viewers()
הפונקציה מחזירה את רשימת הצופים והמגיבים של ה-Folder הזה. אם למשתמש שמריץ את הסקריפט אין גישת עריכה ל-Folder, השיטה הזו מחזירה מערך ריק.
// Gets a folder by its ID. // TODO(developer): Replace the folder ID with your own. const folder = DriveApp.getFolderById('1234567890abcdefghijklmnopqrstuvwxyz'); // Gets the list of viewers and logs their names to the console. const viewers = folder.getViewers(); for (const viewer of viewers) { console.log(viewer.getName()); }
חזרה
User[] — רשימת הצופים והמגיבים של Folder אם למשתמש יש גישת עריכה, או מערך ריק אחרת.
אישור
סקריפטים שמשתמשים בשיטה הזו דורשים הרשאה עם אחת או יותר מההיקפים הבאים:
-
https://www.googleapis.com/auth/drive.readonly -
https://www.googleapis.com/auth/drive
is Starred()
is Trashed()
move To(destination)
העברת הפריט לתיקיית היעד שצוינה.
כדי להעביר פריט לתיקיית היעד, המשתמש הנוכחי צריך להיות הבעלים של הקובץ או שתהיה לו לפחות הרשאת עריכה בתיקיית ההורה הנוכחית של הפריט.
פרמטרים
| שם | סוג | תיאור |
|---|---|---|
destination | Folder | התיקייה שתהפוך לתיקיית האב החדשה. |
חזרה
אישור
סקריפטים שמשתמשים בשיטה הזו דורשים הרשאה עם אחת או יותר מההיקפים הבאים:
-
https://www.googleapis.com/auth/drive
remove Editor(emailAddress)
מסיר את המשתמש שצוין מרשימת העורכים של Folder. השיטה הזו לא חוסמת את הגישה של משתמשים ל-Folder אם הם שייכים לסוג משתמשים שיש להם גישה כללית – לדוגמה, אם ה-Folder משותף עם כל הדומיין של המשתמש, או אם ה-Folder נמצא באחסון שיתופי שהמשתמש יכול לגשת אליו.
בקבצים ב-Drive, הפעולה הזו מסירה את המשתמש גם מרשימת הצופים.
פרמטרים
| שם | סוג | תיאור |
|---|---|---|
email | String | כתובת האימייל של המשתמש שרוצים להסיר. |
חזרה
אישור
סקריפטים שמשתמשים בשיטה הזו דורשים הרשאה עם אחת או יותר מההיקפים הבאים:
-
https://www.googleapis.com/auth/drive
remove Editor(user)
מסיר את המשתמש שצוין מרשימת העורכים של Folder. השיטה הזו לא חוסמת את הגישה של משתמשים ל-Folder אם הם שייכים לסוג משתמשים שיש להם גישה כללית – לדוגמה, אם ה-Folder משותף עם כל הדומיין של המשתמש, או אם ה-Folder נמצא באחסון שיתופי שהמשתמש יכול לגשת אליו.
בקבצים ב-Drive, הפעולה הזו מסירה את המשתמש גם מרשימת הצופים.
פרמטרים
| שם | סוג | תיאור |
|---|---|---|
user | User | ייצוג של המשתמש שרוצים להסיר. |
חזרה
אישור
סקריפטים שמשתמשים בשיטה הזו דורשים הרשאה עם אחת או יותר מההיקפים הבאים:
-
https://www.googleapis.com/auth/drive
remove Viewer(emailAddress)
הסרת המשתמש שצוין מרשימת הצופים והמגיבים של Folder. לשיטה הזו אין השפעה אם המשתמש הוא עורך ולא צופה או מגיב. השיטה הזו גם לא חוסמת את הגישה של משתמשים אל Folder אם הם שייכים לסוג משתמשים שיש להם גישה כללית – לדוגמה, אם Folder משותף עם כל הדומיין של המשתמש, או אם Folder נמצא באחסון שיתופי שהמשתמש יכול לגשת אליו.
במקרה של קבצים ב-Drive, הפעולה הזו מסירה את המשתמש גם מרשימת העורכים.
פרמטרים
| שם | סוג | תיאור |
|---|---|---|
email | String | כתובת האימייל של המשתמש שרוצים להסיר. |
חזרה
Folder — This Folder for chaining.
אישור
סקריפטים שמשתמשים בשיטה הזו דורשים הרשאה עם אחת או יותר מההיקפים הבאים:
-
https://www.googleapis.com/auth/drive
remove Viewer(user)
הסרת המשתמש שצוין מרשימת הצופים והמגיבים של Folder. לשיטה הזו אין השפעה אם המשתמש הוא עורך ולא צופה. השיטה הזו גם לא חוסמת את הגישה של משתמשים ל-Folder אם הם שייכים לקבוצת משתמשים שיש להם גישה כללית – לדוגמה, אם ה-Folder משותף עם כל הדומיין של המשתמש, או אם ה-Folder נמצא באחסון שיתופי שהמשתמש יכול לגשת אליו.
במקרה של קבצים ב-Drive, הפעולה הזו מסירה את המשתמש גם מרשימת העורכים.
פרמטרים
| שם | סוג | תיאור |
|---|---|---|
user | User | ייצוג של המשתמש שרוצים להסיר. |
חזרה
Folder — This Folder for chaining.
אישור
סקריפטים שמשתמשים בשיטה הזו דורשים הרשאה עם אחת או יותר מההיקפים הבאים:
-
https://www.googleapis.com/auth/drive
revoke Permissions(emailAddress)
מבטלת את הגישה אל Folder שהוענקה למשתמש מסוים. השיטה הזו לא חוסמת את הגישה של משתמשים אל Folder אם הם שייכים לקבוצת משתמשים שיש להם גישה כללית – לדוגמה, אם Folder משותף עם כל הדומיין של המשתמש.
פרמטרים
| שם | סוג | תיאור |
|---|---|---|
email | String | כתובת האימייל של המשתמש שרוצים לבטל את הגישה שלו. |
חזרה
אישור
סקריפטים שמשתמשים בשיטה הזו דורשים הרשאה עם אחת או יותר מההיקפים הבאים:
-
https://www.googleapis.com/auth/drive
revoke Permissions(user)
מבטלת את הגישה אל Folder שהוענקה למשתמש מסוים. השיטה הזו לא חוסמת את הגישה של משתמשים אל Folder אם הם שייכים לקבוצת משתמשים שיש להם גישה כללית – לדוגמה, אם Folder משותף עם כל הדומיין של המשתמש.
פרמטרים
| שם | סוג | תיאור |
|---|---|---|
user | User | ייצוג של המשתמש שהגישה שלו צריכה להישלל. |
חזרה
אישור
סקריפטים שמשתמשים בשיטה הזו דורשים הרשאה עם אחת או יותר מההיקפים הבאים:
-
https://www.googleapis.com/auth/drive
search Files(params)
מקבל אוסף של כל הקבצים שהם צאצאים של התיקייה הנוכחית ותואמים לקריטריוני החיפוש שצוינו. הקריטריונים לחיפוש מפורטים בתיעוד של Google Drive SDK. שימו לב ששירות Drive משתמש בגרסה 2 של Drive API, וחלק משדות השאילתות שונים מגרסה 3. בודקים את ההבדלים בין השדות בגרסה 2 ובגרסה 3.
הארגומנט params הוא מחרוזת שאילתה שיכולה להכיל ערכי מחרוזת, לכן חשוב להשתמש בתו בריחה למרכאות בצורה נכונה (למשל "title contains 'Gulliver\\'s
Travels'" או 'title contains "Gulliver\'s Travels"').
// Logs the name of every file that are children of the current folder and modified after February 28, // 2022 whose name contains "untitled."" const files = DriveApp.getRootFolder().searchFiles( 'modifiedDate > "2022-02-28" and title contains "untitled"'); while (files.hasNext()) { const file = files.next(); console.log(file.getName()); }
פרמטרים
| שם | סוג | תיאור |
|---|---|---|
params | String | קריטריונים לחיפוש, כפי שמפורט במסמכי התיעוד של Google Drive SDK. |
חזרה
File – אוסף של כל הקבצים שהם צאצאים של התיקייה הנוכחית ותואמים לקריטריוני החיפוש.
אישור
סקריפטים שמשתמשים בשיטה הזו דורשים הרשאה עם אחת או יותר מההיקפים הבאים:
-
https://www.googleapis.com/auth/drive.readonly -
https://www.googleapis.com/auth/drive
search Folders(params)
מאחזר אוסף של כל התיקיות שהן צאצאים של התיקייה הנוכחית ותואמות לקריטריוני החיפוש שצוינו. הקריטריונים לחיפוש מפורטים בתיעוד של Google Drive SDK. שימו לב ששירות Drive משתמש בגרסה 2 של Drive API, וחלק משדות השאילתות שונים מגרסה 3. בודקים את ההבדלים בין השדות בגרסה 2 ובגרסה 3.
הארגומנט params הוא מחרוזת שאילתה שיכולה להכיל ערכי מחרוזת, לכן חשוב להשתמש בתו בריחה למרכאות בצורה נכונה (למשל "title contains 'Gulliver\\'s
Travels'" או 'title contains "Gulliver\'s Travels"').
// Logs the name of every folder that are children of the current folder and you own and is starred. const folders = DriveApp.getRootFolder().searchFolders('starred = true and "me" in owners'); while (folders.hasNext()) { const folder = folders.next(); console.log(folder.getName()); }
פרמטרים
| שם | סוג | תיאור |
|---|---|---|
params | String | קריטריונים לחיפוש, כפי שמפורט במסמכי התיעוד של Google Drive SDK. |
חזרה
Folder — אוסף של כל התיקיות שהן צאצא של התיקייה הנוכחית ותואמות לקריטריונים של החיפוש.
אישור
סקריפטים שמשתמשים בשיטה הזו דורשים הרשאה עם אחת או יותר מההיקפים הבאים:
-
https://www.googleapis.com/auth/drive.readonly -
https://www.googleapis.com/auth/drive
set Description(description)
set Name(name)
set Owner(emailAddress)
שינוי הבעלים של Folder. השיטה הזו גם מעניקה לבעלים הקודם גישת עריכה מפורשת ל-Folder.
ב-Drive אי אפשר לשנות את הבעלות על פריטים שנמצאים בבעלות של חשבונות gmail.com. האפשרות הזו נתמכת בחשבונות Workspace.
פרמטרים
| שם | סוג | תיאור |
|---|---|---|
email | String | כתובת האימייל של המשתמש שרוצים להגדיר כבעלים החדש. |
חזרה
אישור
סקריפטים שמשתמשים בשיטה הזו דורשים הרשאה עם אחת או יותר מההיקפים הבאים:
-
https://www.googleapis.com/auth/drive
set Owner(user)
שינוי הבעלים של Folder. השיטה הזו גם מעניקה לבעלים הקודם גישת עריכה מפורשת ל-Folder.
ב-Drive אי אפשר לשנות את הבעלות על פריטים שנמצאים בבעלות של חשבונות gmail.com. האפשרות הזו נתמכת בחשבונות Workspace.
פרמטרים
| שם | סוג | תיאור |
|---|---|---|
user | User | ייצוג של המשתמש שצריך להפוך לבעלים החדש. |
חזרה
אישור
סקריפטים שמשתמשים בשיטה הזו דורשים הרשאה עם אחת או יותר מההיקפים הבאים:
-
https://www.googleapis.com/auth/drive
set Security Update Enabled(enabled)
ההגדרה קובעת אם נדרש מפתח משאב לגישה ל-Folder כשהוא משותף באמצעות קישור. קבצים ותיקיות שעומדים בדרישות מופעלים כברירת מחדל.
מידע נוסף על עדכון האבטחה ל-Google Drive
פרמטרים
| שם | סוג | תיאור |
|---|---|---|
enabled | Boolean | האם להפעיל את הדרישה למפתח משאב עבור Folder. |
חזרה
אישור
סקריפטים שמשתמשים בשיטה הזו דורשים הרשאה עם אחת או יותר מההיקפים הבאים:
-
https://www.googleapis.com/auth/drive
set Sharing(accessType, permissionType)
ההגדרה הזו קובעת לאיזה סוג של משתמשים תהיה גישה ל-Folder ואילו הרשאות יקבלו המשתמשים האלה, בנוסף למשתמשים ספציפיים שקיבלו גישה באופן מפורש.
// 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);
פרמטרים
| שם | סוג | תיאור |
|---|---|---|
access | Access | לאיזו קבוצת משתמשים תהיה גישה ל-Folder |
permission | Permission | ההרשאות שצריך להעניק למשתמשים שיכולים לגשת אל Folder |
חזרה
אישור
סקריפטים שמשתמשים בשיטה הזו דורשים הרשאה עם אחת או יותר מההיקפים הבאים:
-
https://www.googleapis.com/auth/drive
set Starred(starred)
הגדרה של סימון Folder בכוכב ב-Drive של המשתמש. ערך ברירת המחדל של Folder חדשים הוא false.
פרמטרים
| שם | סוג | תיאור |
|---|---|---|
starred | Boolean | true אם צריך לסמן בכוכב את Folder ב-Drive של המשתמש, false אם לא |
חזרה
אישור
סקריפטים שמשתמשים בשיטה הזו דורשים הרשאה עם אחת או יותר מההיקפים הבאים:
-
https://www.googleapis.com/auth/drive
set Trashed(trashed)
קובעת אם Folder נמצא באשפה ב-Drive של המשתמש. רק הבעלים יכול להעביר את Folder לאשפה. ברירת המחדל של Folder חדשים היא false.
פרמטרים
| שם | סוג | תיאור |
|---|---|---|
trashed | Boolean | true אם צריך להעביר את Folder לאשפה ב-Drive של המשתמש, false אם לא |
חזרה
אישור
סקריפטים שמשתמשים בשיטה הזו דורשים הרשאה עם אחת או יותר מההיקפים הבאים:
-
https://www.googleapis.com/auth/drive