הגדרת המשאב שמשמשת להגדרת התוכן וההתנהגות של תוסף Google Workspace בכלי העריכה. אם התוספים מורחבים ל-Editor, כל הרכיבים שלהם חייבים להיות מסומנים בתווית Required במניפסטים שלהם ב-Google Workspace.
עורכים
הגדרת המניפסט של תוסף Google Workspace לתוספים של עורך. למידע נוסף, ראו הרחבת עורכי Google Workspace באמצעות תוספים.
ייצוג ב-JSON |
---|
{ "homepageTrigger": { object (HomepageTrigger) }, "onFileScopeGrantedTrigger": { object (OnFileScopeGrantedTrigger) }, "linkPreviewTriggers": [ { object (LinkPreviewTriggers) } ], "createActionTriggers": [ { object (CreateActionTriggers) } } |
שדות | |
---|---|
homepageTrigger |
פונקציית הטריגר הזו יוצרת את דף הבית של התוסף באפליקציית המארח. הפעולה הזו מבטלת את ההגדרה של
|
onFileScopeGrantedTrigger |
חובה אם התוסף כולל התנהגות ספציפית למסמך הנוכחי ב-Editor, שמופעל כשהמשתמש מאשר את ההיקף |
linkPreviewTriggers[] |
חובה להצגת תצוגות מקדימות של קישורים. רשימה של טריגרים להצגת תצוגה מקדימה של קישורים בקובץ Google Docs, Sheets או Slides. פרטים נוספים זמינים במאמר תצוגה מקדימה של קישורים באמצעות צ'יפים חכמים. |
createActionTriggers[] |
נדרש ליצירת משאבים של צד שלישי. רשימת טריגרים ליצירת משאבים בשירות של צד שלישי מהתפריט '@'. פרטים נוספים זמינים במאמר יצירת משאבים של צד שלישי באמצעות צ'יפים חכמים. |
OnFileScopeGrantedTrigger
הגדרה של טריגר לפי הקשר שפועל כשתיבת הדו-שיח של בקשת היקף הקובץ מוצגת באמצעות CardService.newEditorFileScopeActionResponseBuilder()
.requestFileScopeForActiveDocument().build();
והמשתמש מעניק הרשאת היקף drive.file
.
ייצוג ב-JSON |
---|
{ "runFunction": string } |
שדות | |
---|---|
runFunction |
drive.file יוקצה. אם צוין, צריך להטמיע את הפונקציה הזו כדי ליצור ולהחזיר מערך של אובייקטים מסוג
Card להצגה בממשק המשתמש של התוסף.
|
LinkPreviewTriggers
ההגדרה של הטריגר שמופעל כשמשתמש מקלידים או מדביקים קישור משירות של צד שלישי או משירות שאינו של Google בקובץ Docs, Sheets או Slides.
במאמר תצוגה מקדימה של קישורים באמצעות צ'יפים חכמים מוסבר איך מגדירים את הטריגר הזה לתוסף ל-Google Workspace.
ייצוג ב-JSON |
---|
{ "labelText": string, "localizedLabelText": { string: string, ... }, "runFunction": string, "logoUrl": string, "patterns": [ { object(patterns) } ] } |
שדות | |
---|---|
labelText |
Example: Support case . הטקסט הזה סטטי ומוצג לפני שהמשתמשים מפעילים את התוסף.
|
localizedLabelText |
labelText להתאמה לשפות אחרות. צריך לעצב את השפה לפי ISO 639 ואת המדינה או האזור לפי ISO 3166, ולהפריד ביניהם באמצעות מקף - . לדוגמה, en-US .
אם השפה והאזור של המשתמש נמצאים במפתחות המפה, המשתמש יראה את הגרסה המקומית של |
patterns[] |
|
runFunction |
https://www.googleapis.com/auth/workspace.linkpreview .
אם מציינים את הפונקציה הזו, צריך להטמיע אותה כך שתקבל אובייקט אירוע שמכיל את EDITOR_NAME.matchedUrl.url כארגומנטים ותחזיר אובייקט
Card יחיד שמוצג בו קטע מקדים של הקישור בממשק המשתמש של התוסף.
|
logoUrl |
logoUrl .
|
UriPattern
ההגדרה של כל תבנית URL שמפעילה תצוגה מקדימה של קישור.
ייצוג ב-JSON |
---|
{ "hostPattern": string, "pathPrefix" : string } |
שדות | |
---|---|
hostPattern |
subdomain.example.com , צריך לכלול את תת-הדומיין.
כדי להציג תצוגה מקדימה של הקישורים בדומיין כולו, צריך לציין תו כללי לחיפוש עם כוכבית (* ) בתור תת-הדומיין.
לדוגמה, הערך |
pathPrefix |
hostPattern .
לדוגמה, אם תבנית המארח של כתובת ה-URL היא כדי להתאים לכל כתובות ה-URL בדומיין של תבנית המארח, משאירים את השדה |
CreateActionTriggers
ההגדרה של טריגר שפועל כשמשתמש בוחר פריט תפריט של שילוב עם צד שלישי בתפריט @ של Google Docs.
במאמר יצירת משאבים של צד שלישי באמצעות צ'יפים חכמים מוסבר איך מגדירים את הטריגר הזה לתוסף של Google Workspace.
ייצוג ב-JSON |
---|
{ "id": string, "labelText": string, "localizedLabelText": { string: string, ... }, "runFunction": string, "logoUrl": string, } |
שדות | |
---|---|
id |
[a-zA-Z0-9-]+. .
|
labelText |
Create support case .
|
localizedLabelText |
labelText להתאמה לשפות אחרות. צריך לעצב את השפה לפי ISO 639 ואת המדינה או האזור לפי ISO 3166, ולהפריד ביניהם באמצעות מקף - . לדוגמה, en-US .
אם השפה והאזור של המשתמש נמצאים במפתחות המפה, המשתמש יראה את הגרסה המקומית של |
runFunction |
|
logoUrl |
logoUrl .
|