הגדרת האפליקציה ב-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 כדי לנהל את ההגדרות של זירת המסחר, כמו:

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

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

הפעלת Google Workspace Marketplace SDK

צריך להפעיל את Google Workspace Marketplace SDK בפרויקט Google Cloud (אם עדיין לא עשיתם זאת):

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

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

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

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

הזנת הגדרות של אפליקציות ב-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. לוחצים על שמירה.

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

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

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

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

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

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

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

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

הגדרות התקנה

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

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

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

שילוב אפליקציה

צריך לבחור את השירותים של 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' שבדף 'הגדרות האפליקציה', לוחצים על פריסה באמצעות משאב לפריסה בענן > בחירת פריסה.
2. בוחרים את הפריסה שרוצים לפרסם.
3. לוחצים על בחירה.

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

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

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

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

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

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

אפליקציית Google Chat

כדי לפרסם אפליקציית Google Chat, צריך להגדיר את Google Chat API. למידע נוסף, ניתן לקרוא את המאמר פרסום אפליקציות.

אפליקציית Drive

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

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

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

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

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

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

היקפי ההרשאות של OAuth

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

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

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

מידע נוסף על פרויקטים ב-Apps Script זמין במאמר היקפים.

מידע על המפתח

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

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