העברה של אפליקציית 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 המקורית.

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

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

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

מסוף Google Cloud

1. במסוף Google Cloud, עוברים אל תפריט > IAM & Admin > Create a Project (יצירת פרויקט).

   כניסה לדף Create a Project

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

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

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

CLI של gcloud

באחת מסביבות הפיתוח הבאות, ניגשים אל Google Cloud CLI‏ (gcloud):

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

  gcloud projects create PROJECT_ID

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

הפעלת ממשקי API

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

כדי להפעיל API:

מסוף Google Cloud

1. במסוף Google Cloud, עוברים אל תפריט > הצגת כל המוצרים > מוצרי Google אחרים > Google Workspace > ספריית מוצרים.

   מעבר אל Product Library

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

Google Cloud CLI

1. מתקינים או פותחים את ממשק שורת הפקודה (CLI) של Google Cloud.

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

   gcloud services enable API_SERVICE_ID

הגדרת Chat API

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

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

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

1. במסוף Google Cloud, עוברים אל תפריט > Google Auth platform > Branding.

   מעבר לדף Branding

2. אם כבר הגדרתם את Google Auth platform, אתם יכולים לקבוע את ההגדרות הבאות של מסך ההסכמה ל-OAuth בקטעים Branding,‏ Audience וData Access. אם מופיעה ההודעה Google Auth platform not configured yet, לוחצים על Get Started:
1. בקטע App Information בשדה App name, מזינים שם לאפליקציה.
2. בקטע User support email, בוחרים כתובת אימייל לתמיכה שאליה משתמשים יפנו אם יש להם שאלות לגבי ההסכמה שלהם.
3. לוחצים על הבא.
4. בקטע קהל, בוחרים את סוג המשתמשים באפליקציה.
5. לוחצים על הבא.
6. בקטע Contact Information, מזינים כתובת אימייל שאליה אפשר לשלוח התראות על שינויים בפרויקט.
7. לוחצים על Next.
8. בקטע Finish, קוראים את המדיניות של Google בנושא נתוני משתמשים בשירותי API. אם אתם מסכימים, סמנו את התיבה I agree to the Google API Services: User Data Policy.
9. לוחצים על Continue.
10. לוחצים על יצירה.
11. אם בחרתם באפשרות חיצוני לסוג המשתמש, מוסיפים משתמשי בדיקה:
    1. לוחצים על קהל.
    2. בקטע משתמשי בדיקה, לוחצים על הוספת משתמשים.
    3. מזינים את כתובת האימייל שלכם ושל משתמשים מורשים אחרים לבדיקה, ואז לוחצים על שמירה.

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

   • בוחרים את היקפי ההרשאות שמספקים את רמת הגישה המינימלית שנדרשת לאפליקציה. רשימה של היקפי ההרשאות הזמינים מופיעה במאמר היקפי הרשאות של OAuth 2.0 ל-Google APIs.
   • בודקים את ההיקפים שמפורטים בכל אחד משלושת הקטעים: היקפים לא רגישים, היקפים רגישים והיקפים מוגבלים. לגבי כל היקפי ההרשאות שמופיעים בקטע Your sensitive scopes (היקפי ההרשאות הרגישים שלך) או בקטע Your restricted scopes (היקפי ההרשאות המוגבלים שלך), כדאי לנסות לזהות היקפי הרשאות חלופיים לא רגישים כדי להימנע מבדיקות נוספות מיותרות.
   • חלק מההיקפים דורשים בדיקות נוספות על ידי Google. אם האפליקציות משמשות רק באופן פנימי בארגון Google Workspace שלכם, ההיקפים לא מפורטים במסך ההסכמה, והשימוש בהיקפים מוגבלים או רגישים לא מחייב בדיקה נוספת על ידי Google. מידע נוסף זמין במאמר בנושא קטגוריות של היקפים.
4. אחרי שבוחרים את ההיקפים הנדרשים לאפליקציה, לוחצים על שמירה.

מידע נוסף על הגדרת הסכמה ל-OAuth זמין במאמר תחילת העבודה עם Google Auth platform.

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

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

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

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

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

הגדרת תכונות אינטראקטיביות בפרויקט החדש ב-Cloud

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

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

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

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

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

1. במסוף Google Cloud, לוחצים על סמל התפריט > IAM & Admin > Settings (הגדרות).

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

2. מעתיקים את הערך בשדה מספר הפרויקט.

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

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

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

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

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

   ל-Chat API

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

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

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

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

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

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

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

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

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

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

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

שיתוף אפליקציית Chat

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

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

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

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

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

1. נכנסים ל-Chat.

   מעבר ל-Chat

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

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

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

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

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

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

1. נכנסים ל-Chat.

   מעבר ל-Chat

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

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

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

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

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

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