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

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

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

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

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 Workspace > ספריית מוצרים.

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

2. לוחצים על ה-API שרוצים להפעיל.
3. לוחצים על Enable.
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 עבור פרויקט Cloud. אם השתמשתם בעבר ב-OAuth 2.0 להרשאה, אתם צריכים להשתמש באותם היקפי הרשאה לגישה.

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

   מעבר לדף 'מיתוג'

2. אם כבר הגדרתם את , תוכלו להגדיר את ההגדרות הבאות של מסך ההסכמה ל-OAuth בקטעים מיתוג, קהל וגישה לנתונים. אם מופיעה ההודעה עדיין לא הוגדר, לוחצים על תחילת העבודה:
1. בקטע App Information (פרטי האפליקציה), בשדה App name (שם האפליקציה), מזינים שם לאפליקציה.
2. בקטע כתובת אימייל לתמיכה במשתמשים, בוחרים כתובת אימייל לתמיכה שדרכה משתמשים יכולים ליצור איתכם קשר אם יש להם שאלות לגבי ההסכמה שלהם.
3. לוחצים על הבא.
4. בקטע קהל, בוחרים את סוג המשתמשים באפליקציה.
5. לוחצים על הבא.
6. בקטע פרטים ליצירת קשר, מזינים כתובת אימייל שאליה אפשר לשלוח התראות על שינויים בפרויקט.
7. לוחצים על הבא.
8. בקטע סיום, קוראים את המדיניות של Google בנושא נתוני משתמשים בשירותי API. אם אתם מסכימים, מסמנים את התיבה אני מסכים/ה למדיניות של Google בנושא נתוני משתמשים בשירותי API.
9. לוחצים על המשך.
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 זמין במאמר תחילת העבודה עם .

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

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

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

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

• בנוסף, באפליקציות HTTP צריך להעביר את שאר הלוגיקה של האפליקציה שנבנתה באמצעות Cloud Functions,‏ 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 ‏(IAM ומנהל מערכת) > 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.