העברה של אפליקציית Google Chat

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

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

אחרי שתחליטו שאתם צריכים להעביר את אפליקציית Chat, תצטרכו לבצע את שלושת השלבים הבאים:

1. כדי להגדיר את הסביבה לאפליקציית Chat, צריך ליצור פרויקט ב-Google Cloud בארגון שמוזג, להפעיל ממשקי API ואולי גם להגדיר את מסך ההסכמה של OAuth 2.0.
2. פורסים מחדש את אפליקציית Chat מהפרויקט החדש ב-Cloud.
3. מוסיפים את אפליקציית Chat שנוצרה מחדש למרחבים משותפים או לשיחות ב-Chat, ומשביתים את אפליקציית Chat המקורית.

יצירת פרויקט בענן בארגון הממוזג והפעלת ממשקי API

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

יצירת פרויקט חדש ב-Cloud

מסוף Google Cloud

1. במסוף Google Cloud, נכנסים לתפריט > IAM & Admin > Create a Project.

   כניסה לדף Create a Project

2. בשדה Project Name (שם הפרויקט), מזינים שם תיאורי לפרויקט.

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

3. בשדה Location לוחצים על Browse כדי להציג את המיקומים הפוטנציאליים של הפרויקט. לאחר מכן לוחצים על בחירה.
   זהירות: לא מצאת את הארגון שלך ב-Google Workspace?
   המשמעות היא שלא נכנסתם לחשבון Google Workspace. חלק מהתכונות שמתוארות במסמכי התיעוד של Google Workspace למפתחים זמינות רק לפרויקטים שמשויכים לארגון.
4. לוחצים על יצירה. נכנסים לדף Dashboard במסוף Google Cloud ותוך כמה דקות נוצר הפרויקט.

CLI של gcloud

נכנסים ל-CLI של Google Cloud ('gcloud'): באחת מסביבות הפיתוח הבאות:

• Cloud Shell: כדי להשתמש בטרמינל אונליין שבו כבר מוגדר ה-CLI של gcloud, צריך להפעיל את Cloud Shell.
  הפעלת Cloud Shell
• Local Shell: כדי להשתמש בסביבת פיתוח מקומית צריך להתקין וinitialize את ה-CLI של gcloud.
  כדי ליצור פרויקט ב-Cloud, משתמשים בפקודה 'gcloud projects create':

  gcloud projects create PROJECT_ID

  מחליפים את PROJECT_ID על ידי הגדרת המזהה של הפרויקט שרוצים ליצור.

הפעלת ממשקי API

Google Chat API צריך להיות מופעל בכל האפליקציות של Chat. יכול להיות שתצטרכו להפעיל ממשקי API אחרים, בהתאם לצורת הפיתוח של אפליקציית Chat. לדוגמה, אם יצרתם את אפליקציית Chat באמצעות Google Cloud Functions, עליכם להפעיל את Cloud Build API, Cloud Functions API, Pub/Sub API, Cloud Logging API, Artifact Registry API ו-Cloud Run API. כדי לוודא שהאפליקציה שהועברה פועלת, מומלץ להפעיל את אותם ממשקי API בפרויקט החדש ב-Cloud שמופעלים בפרויקט הישן ב-Cloud.

כדי להפעיל API:

מסוף Google Cloud

1. במסוף Google Cloud, נכנסים לתפריט > מוצרים נוספים > Google Workspace > ספריית מוצרים.

   מעבר אל ספריית המוצרים

2. לוחצים על ה-API שרוצים להפעיל.
3. לוחצים על Enable.
4. כדי להפעיל ממשקי API נוספים, חוזרים על השלבים האלה.

Google Cloud CLI

1. מתקינים או פותחים את Google Cloud Command Line Interface (CLI).

2. מריצים את הפקודה services enable ומציינים איזה שירות API להפעיל.

   gcloud services enable API_SERVICE_ID

הגדרת מסך ההסכמה של OAuth

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

1. במסוף Google Cloud, נכנסים לתפריט > APIs & Services > מסך ההסכמה של OAuth.

   מעבר למסך ההסכמה של OAuth

2. בוחרים את סוג המשתמש לאפליקציה ולוחצים על יצירה.
3. ממלאים את טופס ההרשמה לאפליקציה ולוחצים על שמירה והמשך.

4. אם יוצרים אפליקציה לשימוש מחוץ לארגון ב-Google Workspace, לוחצים על הוספה או הסרה של היקפים. כשבוחרים היקפים, מומלץ ליישם את השיטות המומלצות הבאות:

   • בוחרים את היקפי ההרשאות שמעניקים את רמת הגישה המינימלית שנדרשת לאפליקציה. רשימה של היקפי ההרשאות הזמינים זמינה במאמר היקפי ההרשאות של OAuth 2.0 ל-Google APIs.
   • בודקים את היקפי ההרשאות המפורטים בכל אחד משלושת הקטעים: היקפים לא רגישים, היקפים רגישים והיקפים מוגבלים. להיקפים שמפורטים בקטעים 'ההיקפים הרגישים שלך' או 'ההיקפים המוגבלים', כדאי לנסות לזהות היקפים חלופיים לא רגישים כדי להימנע מבדיקות נוספות מיותרות.
   • היקפי הרשאות מסוימים מחייבים בדיקות נוספות של Google. באפליקציות שמיועדות לשימוש פנימי של הארגון שלך ב-Google Workspace בלבד, היקפי ההרשאות לא מופיעים במסך ההסכמה, והשימוש בהיקפים רגישים או מוגבל לא מצריך בדיקה נוספת של Google. למידע נוסף, אפשר לעיין במאמר קטגוריות של היקפים.
5. אחרי שבוחרים את ההיקפים הנדרשים לאפליקציה, לוחצים על Save and Continue (שמירה והמשך).
6. אם בחרתם בסוג המשתמש חיצוני, מוסיפים משתמשי בדיקה:
   1. בקטע משתמשים לבדיקה, לוחצים על הוספת משתמשים.
   2. מזינים את כתובת האימייל שלכם ואת שאר המשתמשים המורשים לבדיקה, ואז לוחצים על Save and Continue (שמירה והמשך).
7. לבדוק את הסיכום של רישום האפליקציה. כדי לבצע שינויים, לוחצים על עריכה. אם הרישום של האפליקציה נראה בסדר, לוחצים על Back to Dashboard (חזרה למרכז השליטה).

פורסים מחדש את אפליקציית Chat לפרויקט החדש ב-Cloud

הפריסה מחדש של אפליקציית Chat משתנה מעט, בהתאם לאופן שבו אפליקציית Chat בנויה באמצעות Apps Script, AppSheet או סוג חיבור אחר, כמו Python או Java. בכל מקרה, לא תצטרכו ליצור מחדש את כל הקוד, אבל תצטרכו לבצע שינויים מסוימים.

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

בהתאם לארכיטקטורה של אפליקציית Chat, יכול להיות שתצטרכו להעביר שירותים אחרים לפרויקט החדש ב-Cloud:

• באפליקציות HTTP צריך גם להעביר את שאר הלוגיקה של האפליקציה שנוצרה באמצעות Cloud Functions, Cloud Run או App Engine.
• באפליקציות של Chat בממשק שיחה שמשתמשות בשפה טבעית, צריך להעביר גם את סוכני Dialogflow.
• באפליקציות ל-Chat שנבנו מאחורי חומת אש, תצטרכו להעביר גם את נושאי Pub/Sub.

הגדרה של אפליקציית Chat בפרויקט החדש ב-Cloud

כדי לפרוס מחדש את אפליקציית Chat שפותחה בשפה כמו Python או Java, צריך להגדיר את אפליקציית Chat בפרויקט החדש ב-Cloud.

1. במסוף Google Cloud, מחפשים את Google Chat API, לוחצים על Google Chat API ואז לוחצים על Manage (ניהול).

   כניסה ל-Chat API

2. לוחצים על הכרטיסייה Configuration (הגדרה) ומזינים את הפרטים הנדרשים הבאים:

   • שם האפליקציה: השם שאנשים משתמשים בו במהלך האינטראקציה עם אפליקציית Chat.
   • כתובת URL של Avatar: כתובת URL מסוג HTTPS שמפנה לתמונת גרפיקה ריבועית (לדוגמה, PNG או JPEG), בגודל של לפחות 128x128, שמופיעה כדמות של אפליקציית Chat.
   • תיאור: תיאור של המטרה של אפליקציית Chat, שמופיע מתחת לשם של אפליקציית Chat.

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

   שדה	תיאור
   פונקציונליות	קבוצת שדות שקובעים איך אפליקציית Chat יכולה לתקשר עם המשתמשים: קבלת הודעות אישיות: המשתמשים יכולים למצוא את אפליקציית Chat ולשלוח הודעות ישירות ב-Google Chat. הצטרפות למרחבים משותפים ולשיחות קבוצתיות: המשתמשים יכולים להוסיף את אפליקציית Chat למרחבים משותפים ולשיחות קבוצתיות.
   הגדרות חיבור	נקודת הקצה (endpoint) של אפליקציית Chat, שהיא אחת מהאפשרויות הבאות: כתובת URL של האפליקציה: נקודת קצה (endpoint) מסוג HTTPS שמארחת את ההטמעה של אפליקציית Chat. פרויקט Apps Script: מזהה פריסה של פרויקט Apps Script שמטמיע אפליקציית Chat. שם הנושא ב-Cloud Pub/Sub: נושא Pub/Sub שאפליקציית Chat רשומה אליו כנקודת קצה. Dialogflow: רישום של אפליקציית Chat בשילוב עם Dialogflow. מידע נוסף זמין במאמר יצירת אפליקציית Dialogflow ל-Google Chat שמבינה שפה טבעית.
   פקודות דרך שורת הפקודות	פקודות שאפשר להציג למשתמשים ב-Google Chat. המשתמשים יכולים לראות את הפעולות העיקריות של אפליקציית Chat בתוך Google Chat, ולבחור פעולה ספציפית שהם רוצים לקיים איתה אינטראקציה. מידע נוסף זמין במאמר מענה לפקודות דרך שורת הפקודות כאפליקציה של Chat.
   תצוגות מקדימות של קישורים	תבניות URL שאפליקציית Chat מזהה ומספקת תוכן נוסף בשביל המשתמשים ששולחים קישורים. מידע נוסף זמין במאמר תצוגה מקדימה של קישורים.
   חשיפה	עד 5 אנשים או קבוצת Google אחת או יותר שיכולים לראות ולהתקין את אפליקציית Chat. אפשר להשתמש בשדה הזה כדי לבדוק את אפליקציית Chat או כדי לשתף את אפליקציית Chat עם הצוות שלך. מידע נוסף זמין בהגדרות החשיפה והפרסום באפליקציית Chat.

4. כדי לרשום שגיאות ב-Cloud Logging כשאפליקציית Chat מחזירה שגיאה, מסמנים את התיבה Log errors to Logging. מידע נוסף זמין במאמר יומני שגיאות של שאילתות באפליקציות ל-Chat.

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

פריסה מחדש של אפליקציית צ'אט ב-Apps Script

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

העתקת מספר הפרויקט ב-Cloud

1. במסוף Google Cloud, נכנסים לתפריט > IAM & Admin > הגדרות.

   כניסה לדף IAM & Admin Settings

2. מעתיקים את הערך בשדה Project number.

הגדרת מספר הפרויקט ב-Google Cloud בפרויקט Apps Script

1. נכנסים אל Apps Script.

   כניסה אל Apps Script

2. בפרויקט Apps Script של אפליקציית Chat, לוחצים על Project Settings (הגדרות הפרויקט) .

3. בקטע פרויקט Google Cloud Platform (GCP), לוחצים על שינוי פרויקט.

4. בקטע מספר פרויקט GCP, מדביקים את מספר הפרויקט ב-Google Cloud.

5. לוחצים על Set project.

העתקת מזהה הפריסה של פרויקט Apps Script

1. בפינה הימנית העליונה של Apps Script, לוחצים על Deploy (פריסה) > Manage deplments (ניהול הפריסות).
2. בקטע מזהה פריסה, לוחצים על העתקה.
3. לוחצים על סיום.

איך מגדירים מחדש את אפליקציית Chat ופורסים אותה מחדש

1. במסוף Google Cloud, מחפשים את Google Chat API, לוחצים על Google Chat API ואז לוחצים על Manage (ניהול).

   כניסה ל-Chat API

2. לוחצים על הכרטיסייה Configuration (הגדרה) ומזינים את הפרטים הנדרשים הבאים:

   • שם האפליקציה: השם שאנשים משתמשים בו במהלך האינטראקציה עם אפליקציית Chat.
   • כתובת URL של Avatar: כתובת URL מסוג HTTPS שמפנה לתמונת גרפיקה ריבועית (לדוגמה, PNG או JPEG), בגודל של לפחות 128x128, שמופיעה כדמות של אפליקציית Chat.
   • תיאור: תיאור של המטרה של אפליקציית Chat, שמופיע מתחת לשם של אפליקציית Chat.

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

4. בקטע 'הגדרות חיבור', בוחרים באפשרות פרויקט Apps Script.

5. בשדה Deployment ID, מדביקים את מזהה הפריסה שהעתקתם קודם.

6. כדי לסיים את שאר ההגדרות, עיינו בטבלה שבקטע הגדרת האפליקציה של Chat בפרויקט החדש ב-Cloud.

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

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

כדי לפרוס מחדש את אפליקציית Chat המבוססת על AppSheet בפרויקט החדש ב-Cloud, צריך להעתיק את האפליקציה לפרויקט החדש ב-Cloud.

עדכון של חשבון השירות

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

איך משתפים את אפליקציית Chat

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

רוצה לעבור לאפליקציית Chat החדשה?

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

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

הוספה של אפליקציית Chat החדשה למרחבים משותפים ב-Chat

1. עוברים ל-Chat.

   מעבר ל-Chat

2. לוחצים על הצ'אט האישי או על המרחב המשותף.

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

4. לוחצים על הוספת אפליקציות.

5. כותבים את שם האפליקציה, בוחרים את האפליקציה מהרשימה ולוחצים על Add.

6. חוזרים על השלבים האלה לכל מרחב משותף או צ'אט אישי שאליהם רוצים להוסיף את אפליקציית Chat.

הסרה של אפליקציית Chat הישנה ממרחבים ב-Chat

1. עוברים ל-Chat.

   מעבר ל-Chat

2. לוחצים על הצ'אט האישי או על המרחב המשותף.

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

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

5. חוזרים על השלבים האלה בכל מרחב משותף או צ'אט אישי שרוצים להסיר מהם את אפליקציית Chat הישנה.

איך משביתים את הגרסה הישנה של אפליקציית Chat

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

נושאים קשורים

• פרסום אפליקציות