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

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

   כניסה לדף Create a Project

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

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

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

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

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

  gcloud projects create PROJECT_ID

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

הפעלת ממשקי API

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

כדי להפעיל ממשק API:

מסוף Google CloudGoogle Cloud CLI

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

   כניסה לספריית המוצרים

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

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, נכנסים לתפריט > > Branding.

   כניסה לדף Branding

2. אם כבר הגדרתם את , תוכלו להגדיר את ההגדרות הבאות של מסך ההסכמה ל-OAuth בקטע מיתוג, קהל וגישה לנתונים. אם מופיעה ההודעה not configured yet, לוחצים על Get Started:
1. בקטע פרטי האפליקציה, בשדה שם האפליקציה, מזינים שם לאפליקציה.
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.
   • בודקים את ההיקפים שמפורטים בכל אחד משלושת הקטעים: היקפים לא רגישים, היקפים רגישים והיקפים מוגבלים. לגבי כל ההיקפים שמפורטים בקטעים 'ההיקפים הרגישים שלך' או 'ההיקפים המוגבלים שלך', נסו לזהות היקפים חלופיים שאינם רגישים כדי למנוע בדיקות נוספות מיותרות.
   • לחלק מההיקפים נדרשות בדיקות נוספות מצד Google. באפליקציות שמשמשות רק באופן פנימי בארגון שלכם ב-Google Workspace, ההיקפים לא מופיעים במסך ההסכמה, והשימוש בהיקפים מוגבלים או רגישים לא מחייב בדיקה נוספת על ידי Google. מידע נוסף זמין במאמר קטגוריות היקף.
4. אחרי שבוחרים את ההיקפים הנדרשים לאפליקציה, לוחצים על Save.

למידע נוסף על הגדרת הסכמה ל-OAuth, עיינו במאמר תחילת העבודה עם .

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

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

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

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

• באפליקציות 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 > Settings.

   כניסה לדף IAM & Admin

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 project number, מדביקים את מספר הפרויקט ב-Google Cloud.

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

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

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

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

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

   לדף Chat API

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

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

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

4. בקטע Connection settings (הגדרות החיבור), בוחרים באפשרות Apps Script project (פרויקט Apps Script).

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

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

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

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

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

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

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

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

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

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

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

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