משאב של מניפסט יומן

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

יומן

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

ייצוג ב-JSON 
{
  "createSettingsUrlFunction": string,
  "conferenceSolution": [
    {
      object (ConferenceSolution)
    }
  ],
  "currentEventAccess": string,
  "eventOpenTrigger": {
    object (EventOpenTrigger)
  },
  "eventUpdateTrigger": {
    object (EventUpdateTrigger)
  },
  "eventAttachmentTrigger": {
    object (EventAttachmentTrigger)
  },
  "homepageTrigger": {
    object (HomepageTrigger)
  }
}
שדות
createSettingsUrlFunction

string

בשימוש רק אם התוסף מספק פתרונות לשיחות ועידה. אופציונלי. השם של פונקציית Apps Script שיוצרת כתובת URL שמובילה לדף הגדרות של התוסף.

פרטים נוספים זמינים במאמר הוספת הגדרות לתוסף של כלי ועידה.
conferenceSolution[]

object (ConferenceSolution)

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

string

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

  • ‫METADATA מציין שלתוסף יש גישה רק למטא נתונים בסיסיים של האירוע.
  • ‫READ מציין שהתוסף יכול לקרוא נתוני אירועים שנוצרו על ידי המשתמשים, בנוסף למטא-נתונים הבסיסיים של האירועים.
  • ‫WRITE מציין שהתוסף יכול לכתוב נתוני אירועים שנוצרו על ידי משתמשים.
  • ‫READ_WRITE מציין שהתוסף יכול לקרוא ולכתוב נתוני אירועים שנוצרו על ידי המשתמש, וגם לקרוא מטא-נתונים בסיסיים.

אם המדיניות מוגדרת לערך READ או READ_WRITE, לתוסף צריך להיות https://www.googleapis.com/auth/calendar.addons.current.event.read היקף.

אם המדיניות מוגדרת לערך WRITE או READ_WRITE, לתוסף צריך להיות https://www.googleapis.com/auth/calendar.addons.current.event.write היקף.
eventOpenTrigger

object (EventOpenTrigger)

הגדרת הטריגרים לפתיחת אירועים ביומן.

eventUpdateTrigger

object (EventUpdateTrigger)

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

eventAttachmentTrigger

object (EventAttachmentTrigger)

הגדרת הטריגר לטריגרים של צירוף קבצים לאירועים ביומן.

homepageTrigger

object (HomepageTrigger)

הגדרת פונקציית הטריגר ליצירת דף הבית של התוסף במארח של היומן. האפשרות הזו מבטלת את addOns.common.homepageTrigger.

ConferenceSolution

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

ייצוג ב-JSON 
{
  "id": string,
  "logoUrl": string,
  "name": string,
  "onCreateFunction": string
}
שדות
id

string

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

string

קישור לסמל שמייצג את הפתרון. גודל התמונה צריך להיות 96 x 96 dp.

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

אם מציינים תמונה, יכול להיות שהיא תהיה שונה מהתמונה של התוסף calendar.logoUrl, שמשמשת לייצוג התוסף באפליקציות המארחות שהוא מרחיב. אם לא מספקים תמונת לוגו לפתרון מסוים, המערכת משתמשת ב- calendar.logoUrl במקום זאת.
name

string

נדרש. השם של פתרון הוועידה שמוצג בממשק המשתמש של יומן Google כשמשתמש יוצר או עורך אירוע.
onCreateFunction

string

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

EventOpenTrigger

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

ייצוג ב-JSON 
{
  "runFunction": string
}
שדות
runFunction

string

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

EventUpdateTrigger

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

ייצוג ב-JSON 
{
  "runFunction": string
}
שדות
runFunction

string

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

EventAttachmentTrigger

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

ייצוג ב-JSON 
{
  "runFunction": string,
  "label": string,
}
שדות
runFunction

string

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

string

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