הגדרת האפליקציה ב-Google Workspace Marketplace SDK

בדף הזה מוסבר איך להשתמש ב-Google Workspace Marketplace SDK כדי להגדיר ולנהל ב-Google Workspace Marketplace.

כדי שהאפליקציה תהיה זמינה לשימוש, צריך להגדיר אותה ב-Google Workspace Marketplace SDK. Google Workspace Marketplace SDK הוא ערכת כלים שמאפשרת ליצור ולנהל ב-Google Workspace Marketplace. אתם משתמשים ב-Google Workspace Marketplace SDK כדי לנהל ההגדרות של Marketplace, למשל:

• אם האפליקציה זמינה לארגון ספציפי ב-Google Workspace (אפליקציה פרטית), או לכל משתמשי Marketplace ( אפליקציה ציבורית)
• סוגי המשתמשים ב-Marketplace שיכולים להתקין את יישום
• האפליקציות של Google Workspace שהאפליקציה שלך משולבת בהן
• היקפי ההרשאות של OAuth שהאפליקציה שלך דורשת
• מידע על מי שיצר ומתחזק את האפליקציה

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

הפעלת ה-SDK של Google Workspace Marketplace

אם עדיין לא עשיתם זאת, בפרויקט שלכם ב-Google Cloud: מפעילים את Google Workspace Marketplace SDK:

1. פותחים את מסוף Google Cloud.
2. בחלק העליון, לוחצים על בחירת פרויקט. אם פרויקט אחר ב-Google Cloud פתוח. צריך ללחוץ על שם הפרויקט ב-Cloud כדי להחליף אותו פרויקטים בענן.
3. בוחרים את הפרויקט של האפליקציה ב-Cloud ולוחצים על Open.
4. למעלה, בסרגל החיפוש, מקלידים Google Workspace Marketplace SDK ומקישים על Enter.

5. פותחים את הדף Google Workspace Marketplace SDK.

   אזהרה: צריך להפעיל את Google Workspace Marketplace SDK, ולא את ה-API. Google Workspace Marketplace API הוא כלי אחר שמשמש לשילוב עם שירותי הרישוי והחיוב של Google.

6. אם Google Workspace Marketplace SDK עדיין לא מופעל, לוחצים על הפעלה.

צריך לקבוע את הגדרות התצורה של האפליקציה

בחומר העזר הבא מתוארות ההגדרות הזמינות באפליקציה דף ההגדרה של ה-SDK של Google Workspace Marketplace.

בחירת האנשים שיוכלו לראות ולהתקין את האפליקציה

כשאתם מגדירים את האפליקציה, אתם מציינים אילו משתמשים יכולים לגשת אליה באמצעות ההגדרות הבאות:

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

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

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

איך האדמינים מנהלים את הגישה אל Marketplace, אפשר לעיין מסמכי העזרה לאדמינים ב-Marketplace

הגדרות הרשאות גישה לאפליקציה

אזהרה: אחרי שבוחרים אפשרות חשיפה ושומרים את הגדרת האפליקציה אי אפשר לשנות את הבחירה בשלב מאוחר יותר.

האפשרות הרשאות גישה לאפליקציה מופיעה אם אתם משתמשים ב-Google Workspace חשבון (חשבון שנוצר על ידי הארגון של מקום העבודה או מוסד הלימודים). אם אתם באמצעות חשבון פרטי (חשבון שמסתיים ב-" @gmail.com"), תוכלו רק לפרסם באופן ציבורי.

• גלויה לכולם: אנשים מחוץ לארגון יכולים למצוא את האפליקציה ולהתקין אותה דומיין. אם בוחרים בהגדרת החשיפה הציבורית, Google תבדוק ותאשר את האפליקציה לפני הפרסום.
• פרטי: רק אנשים בדומיין שלכם יכולים למצוא את האפליקציה ולהתקין אותה.

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

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

הגדרות להתקנת אפליקציות

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

הערה: באפליקציות של Google Chat אפשר לבחור רק אדם פרטי + אדמין. אני רוצה להתקין, כי אנשים יכולים למצוא ולהתקין אפליקציות ל-Chat ישירות מ-Google Chat. לפרטים על אופן ההתקנה, ראו פרסום אפליקציות של Google Chat.

• התקנה בודדת + התקנה על ידי אדמין (ברירת מחדל): ניתן להתקין את האפליקציה על ידי של משתמשים בודדים או על ידי אדמינים עבור הדומיין, היחידה הארגונית שלהם או קבוצה של משתמשים. מדיניות הדומיין של המשתמש עשויה למנוע ממנו להתקין אפליקציה גם אם התקנות בודדות מופעלות.
• התקנה על ידי אדמינים בלבד: רק אדמינים יכולים להתקין את האפליקציה דומיין, יחידה ארגונית או קבוצת משתמשים. האפליקציה מופיעה רק תוצאות חיפוש של Google Workspace Marketplace לאדמינים ולאנשים לא מחוברים לחשבון Google. יש לבחור באפשרות הזו אם האפליקציה שלך דורשת התקנה של דומיין.

הגדרות נפוצות של התקנה והרשאות גישה

הטבלה הבאה מסכמת כמה מהאפשרויות הנפוצות של הגדרות אישיות עבור אפליקציות התקנה וחשיפה:

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

זיהוי האופן שבו האפליקציה שלך משתלבת עם אפליקציות של Google Workspace

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

בהתאם לשילובי האפליקציות שבחרת, ייתכן שיהיה צורך לספק פרטים נוספים ונפעיל ממשקי API רלוונטיים בפרויקט שלכם ב-Google Cloud. הבאים בטבלה מתוארת ההגדרות הנוספות של כל אחד מהרכיבים:

תוסף Google Workspace (Apps Script)

כדי לפרסם תוסף ל-Google Workspace, צריך לספק את הפרטים שלו מזהה פריסה. כדי למצוא את מזהה הפריסה:

1. פתיחת התוסף של Google Workspace ב-Apps Script עם הרשאת עריכה.
2. לחץ על פריסה > ניהול הפריסות.
3. מתחת למזהה הפריסה, לוחצים על העתקה.

תוסף Google Workspace (סביבת זמן ריצה חלופית)

אם יצרתם את התוסף ל-Google Workspace בשפת תכנות שהיא לא Google Apps Script, צריך לפעול לפי השלבים הבאים כדי לקבל את מזהה הפריסה משאב פריסה של Google Cloud.

1. בדף 'הגדרת האפליקציה', בקטע 'תוסף Google Workspace', ללחוץ פריסה באמצעות משאב לפריסה בענן > בוחרים באפשרות Deployment (פריסה).
2. בוחרים את הפריסה שרוצים לפרסם.
3. לוחצים על בחירה.

תוסף עריכה (Docs, Sheets, Slides, Forms)

כדי לפרסם תוסף עריכה צריך לספק מזהה הפרויקט והגרסה שרוצים לפרסם.

כדי למצוא את מזהה הסקריפט של הפרויקט, פועלים לפי השלבים הבאים:

1. פותחים את התוסף בעורך Apps Script.
2. בצד ימין, לוחצים על הגדרות הפרויקט. .
3. בקטע 'מזהים', מעתיקים את מזהה הסקריפט.

כדי למצוא את הגרסה, צריך לפעול לפי השלבים הבאים:

1. פותחים את התוסף בעורך Apps Script.
2. בצד שמאל למעלה, לוחצים על פריסה> ניהול הפריסות.
3. מספר הגרסה מופיע בקטע 'הגדרה'.

אפליקציית Google Chat

כדי לפרסם אפליקציית Google Chat, צריך להגדיר את Google Chat API. צפייה פרסום של Google.

אפליקציית Drive

כדי לפרסם אפליקציית Drive, צריך להפעיל ולהגדיר את Drive API

אפליקציית אינטרנט

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

כשממלאים את דף האפליקציה בחנות, צריך לספק סמלים נוספים בגודל 96x96 ו-48x48 פיקסלים.

אם יצרת את אפליקציית האינטרנט ב-Apps Script, כדי לקבל את הגרסה האוניברסלית כתובת האתר לניווט, יש לבצע את השלבים הבאים:

1. פתיחת התוסף של Google Workspace ב-Apps Script עם הרשאת עריכה.
2. לחץ על פריסה > פריסה חדשה.
3. בקטע 'בחירת סוג', לוחצים על אפליקציית אינטרנט.
4. ממלאים את האפשרויות ולוחצים על פריסה.
5. לוחצים על Copy.

צריך לציין את רמת הגישה שהאפליקציה דורשת

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

אם כוללים יותר משילוב אחד של אפליקציה, חשוב להוסיף את היקפי ההרשאות מ: כל אחד מהם בדף הגדרת האפליקציה של Google Workspace Marketplace SDK והבעת ההסכמה שלך ל-OAuth מסך.

השתמשו תמיד בהיקפים המצומצמים ביותר (לדוגמה, אל תכללו היקף ההרשאות ב-Drive, אם אתם צריכים רק היקף לקריאה בלבד).

לפרויקטים של Apps Script: היקפים אפשר לקבל פרטים נוספים.

אפשר לספק מידע על מפתח האפליקציה

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

שדות
סטטוס העסק	במסגרת חוקים להגנת הצרכן, צרכנים שנמצאים באירופה חובה ליידע את האזור הכלכלי (EEA) אם מוכר Google Workspace Marketplace הוא עסק או לא עסק: עסק – עסק הוא אדם שפועל למטרות שקשורות לתחום, לעסק, למלאכת יד או למקצוע; או בשם של מטעם עסק. לא עסק – אדם שאינו עסק (צרכן) הוא אדם שפועל עבור למטרות שאינן מקצועיות. אם לא צוין, 'סטטוס העסק לא צוין' מופיעה באפליקציה דף האפליקציה בחנות הדף הזה.
כתובת למשלוח דואר של המפתח	חובה לסוחרים. לא נאספים ממשתמשים שאינם עסקים. המיקום של העסק. יש להזין כתובת תקינה למשלוח דואר שבה ליצירת קשר.
שם המפתח	השם שיוצג בתור המחבר של האפליקציה. אם אתם עסק, לציין את השם המסחרי או את השם החוקי שלך.
כתובת אתר של המפתח	האתר שמתאר אותך (או את הארגון שלך) בתור למפתחים.
כתובת האימייל של המפתח	כתובת האימייל שתשמש כאיש קשר. זו לא נכללות בדף האפליקציה. חשוב לוודא שכתובת האימייל הזו עדכנית תאריך — נעשה בו שימוש: אם Google צריכה ליצור קשר עם המפתח - לדוגמה, במהלך תהליך הבדיקה של האפליקציות. כדי לשלוח משוב מתוספי עריכה אם לא כתובת ה-URL של הדוח על הבעיה שסופקו בדף האפליקציה בחנות.
כתובת האתר של האפליקציה	זה שינוי אופציונלי. האתר שמתאר באופן נוסף את האפליקציה.

שמירת ההגדרות של האפליקציה ב-Google Workspace Marketplace SDK

על סמך המידע מהקטע הקודם, שומרים את הגדרות האפליקציה ב-Google Workspace Marketplace SDK:

1. פותחים את Google Workspace Marketplace SDK.
2. עוברים לכרטיסייה הגדרת האפליקציה.
3. חשוב למלא כל קטע בהתאם למה שבחרתם הקטע הקודם.
4. לוחצים על שמירה.
5. (אופציונלי) אפשר לקבל ניתוח נתונים לגבי השימוש באפליקציה ב-Google Analytics. כדי לעשות את זה, צריך להוסיף מזהה Google Analytics. ב-Google Workspace Marketplace SDK.
   1. עוברים לכרטיסייה Analytics.
   2. מזינים את מזהה Google Analytics.
   3. לוחצים על שמירה.