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

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

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

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

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

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

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

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

מסוף Google Cloud

  1. במסוף Google Cloud, נכנסים לתפריט > IAM & אדמין > יצירת פרויקט.

    כניסה לדף Create a Project

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

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

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

CLI של gcloud

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

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

הפעלת ממשקי API

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

    לדף Product Library

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

Google Cloud CLI

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

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

    gcloud services enable API_SERVICE_ID

הגדרה של Chat API

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

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

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

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

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

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

    • צריך לבחור את היקפי ההרשאות שמספקים את רמת הגישה המינימלית שנדרשת על ידי האפליקציה. לרשימה של להיקפים זמינים: היקפי OAuth 2.0 ל-Google APIs.
    • חשוב לעיין בהיקפים שמפורטים בכל אחד משלושת הסעיפים: לא רגיש היקפים, היקפים רגישים והיקפים מוגבלים. בכל ההיקפים שמופיעים "היקפי ההרשאות הרגישים" או 'ההיקפים המוגבלים שלך' מנסים לזהות היקפים חלופיים לא רגישים כדי למנוע בדיקות נוספות מיותרות.
    • בחלק מההיקפים צריך לבצע בדיקות נוספות של Google. לאפליקציות בשימוש בלבד באופן פנימי על ידי הארגון שלך ב-Google Workspace, ההיקפים לא מפורטים לא נדרשים מסך הסכמה ושימוש בהיקפים מוגבלים או רגישים לבדיקה נוספת על ידי Google. מידע נוסף זמין במאמר הבא: קטגוריות היקפים.
  5. אחרי שבוחרים את ההיקפים הנדרשים ליד האפליקציה, לוחצים על שמירה והמשך.
  6. אם בחרתם בסוג המשתמש חיצוני, עליכם להוסיף משתמשים לבדיקה:
    1. בקטע Test users לוחצים על Add users.
    2. מזינים את כתובת האימייל שלכם ואת כל המשתמשים המורשים האחרים לבדיקה, ולאחר מכן לוחצים על שמירה והמשך.
  7. מעיינים בסיכום של רישום האפליקציה. כדי לבצע שינויים, לוחצים על עריכה. אם האפליקציה ההרשמה נראית תקינה, לוחצים על חזרה ללוח הבקרה.

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

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

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

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

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

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

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

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

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

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

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

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

    כניסה לדף IAM & הגדרות אדמין

  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, לוחצים על פריסה > ניהול הפריסות.
  2. בקטע Deployment ID (מזהה פריסה), לוחצים על Copy (העתקה).
  3. לוחצים על סיום.

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

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

    כניסה ל-Chat API

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

    • שם האפליקציה: השם שאנשים משתמשים בו במהלך אינטראקציה עם אפליקציית Chat.
    • כתובת URL של הדמות: כתובת URL מסוג HTTPS שמפנה לתמונה גרפית מרובעת (לדוגמה, PNG או JPEG), לפחות 128x128, שמופיעה הדמות שלך באפליקציית Chat.
    • Description: תיאור של המטרה של אפליקציית 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

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

    כניסה ל-Chat

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

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

  4. לוחצים על Add apps (הוספת אפליקציות).

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

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

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

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

    כניסה ל-Chat

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

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

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

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

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

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