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

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

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

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

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

הפעלת ה-SDK של Marketplace

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

פותחים את פרויקט Cloud במסוף Google Cloud

אם הוא עדיין לא פתוח, פותחים את פרויקט Cloud שבו אתם מתכוונים להשתמש לדוגמה הזו:

1. נכנסים לדף Select a project במסוף Google Cloud.

   בחירת פרויקט ב-Cloud

2. בוחרים את הפרויקט ב-Google Cloud שבו רוצים להשתמש. לחלופין, לוחצים על Create project (יצירת פרויקט) ופועלים לפי ההוראות במסך. אם יוצרים פרויקט ב-Google Cloud, יכול להיות שתצטרכו להפעיל את החיוב בפרויקט.

הפעלת Google Workspace Marketplace SDK

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

• במסוף Google Cloud, מפעילים את Google Workspace Marketplace SDK.

  הפעלת ה-SDK

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

במסמך העזרה הבא מפורטות ההגדרות הזמינות בדף App Configuration ב-Marketplace SDK.

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

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

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

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

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

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

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

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

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

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

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

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

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

• התקנה על ידי משתמשים ספציפיים וגם על ידי אדמינים (ברירת המחדל): משתמשים ספציפיים או אדמינים יכולים להתקין את האפליקציה בדומיין, ביחידה הארגונית או בקבוצה שלהם. מדיניות הדומיין של המשתמש עשויה למנוע ממנו להתקין אפליקציה, גם אם ההתקנות הספציפיות מופעלות.
• התקנה על ידי אדמינים בלבד: רק אדמינים יכולים להתקין את האפליקציה בדומיין, ביחידה הארגונית או בקבוצת המשתמשים שלהם. האפליקציה שלכם תופיע בתוצאות החיפוש ב-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. בטבלה הבאה מתואר מה צריך להגדיר בכל אחת מהאפשרויות:

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

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

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

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

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

מתן מידע על מפתח האפליקציה

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

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

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

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

1. נכנסים לדף Configuration של Marketplace SDK במסוף Google Cloud:

   כניסה לדף ההגדרה של SDK של Marketplace

2. ממלאים כל סעיף על סמך מה שקבעתם בסעיף הקודם.

3. לוחצים על שמירה.

4. (אופציונלי) אתם יכולים לקבל ניתוח נתונים על השימוש באפליקציה ב-Google Analytics. לשם כך, מוסיפים מזהה Google Analytics ב-Marketplace SDK.

   1. עוברים לכרטיסייה Analytics.
   2. מזינים את מזהה Google Analytics.
   3. לוחצים על שמירה.