Class PropertiesService

PropertiesService

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

// Sets three properties of different types.
const documentProperties = PropertiesService.getDocumentProperties();
const scriptProperties = PropertiesService.getScriptProperties();
const userProperties = PropertiesService.getUserProperties();

documentProperties.setProperty('DAYS_TO_FETCH', '5');
scriptProperties.setProperty(
    'SERVER_URL',
    'http://www.example.com/MyWeatherService/',
);
userProperties.setProperty('DISPLAY_UNITS', 'metric');

Methods

שיטהסוג הערך המוחזרתיאור קצר
getDocumentProperties()Propertiesהפונקציה מקבלת מאגר נכסים (לסקריפט הזה בלבד) שכל המשתמשים יכולים לגשת אליו בתוך המסמך, הגיליון האלקטרוני או הטופס הפתוחים.
getScriptProperties()Propertiesהפונקציה מקבלת מאגר נכסים שכל המשתמשים יכולים לגשת אליו, אבל רק בתוך הסקריפט הזה.
getUserProperties()Propertiesהפונקציה מקבלת מאגר נכסים שרק למשתמש הנוכחי יש גישה אליו, ורק בתוך הסקריפט הזה.

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

getDocumentProperties()

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

חזרה

Properties – מאגר נכסים של הסקריפט הזה בלבד, שכל המשתמשים במסמך הנוכחי יכולים לגשת אליו, או null אם הסקריפט הוא לא תוסף או לא מקושר לקובץ ב-Google Workspace


getScriptProperties()

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

חזרה

Properties – מאגר נכסים שכל המשתמשים בסקריפט יכולים לגשת אליו


getUserProperties()

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

חזרה

Properties – מאגר נכסים שרק המשתמש הנוכחי של הסקריפט יכול לגשת אליו