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

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

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

יצירת פרויקט בענן

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

‫CLI של gcloud

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

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

  gcloud projects create PROJECT_ID

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

הפעלת ממשקי ה-API

כל האפליקציות ל-Chat צריכות להפעיל את Google Chat API. יכול להיות שתצטרכו להפעיל ממשקי 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 בפרויקט החדש בענן כמו בפרויקט הישן בענן.

כדי להפעיל API:

מסוף Google Cloud

1. במסוף Google Cloud, עוברים אל תפריט > APIs & Services > Library > Google Workspace.

   לדף API 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

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

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

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

1. ב-Google API Console, נכנסים לתפריט > Google Auth platform > Branding.

   מעבר לדף Branding

2. אם כבר הגדרתם את פלטפורמת האימות של Google, אתם יכולים לקבוע את ההגדרות הבאות של מסך ההסכמה ל-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.

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

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

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

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

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

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

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

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

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

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

העתקת מספר הפרויקט בענן

1. ב-Google API Console, עוברים אל תפריט > 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 API Console, מחפשים את 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. כדי להשלים את שאר ההגדרות, אפשר לעיין בטבלה שבמאמר הגדרת אפליקציית הצ'אט בפרויקט בענן החדש

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

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

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

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

אם אפליקציית 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.