איך מגדירים מרחב משותף ב-Google Chat שגלוי למשתמשים ספציפיים בארגון ב-Google Workspace

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

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

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

דרישות מוקדמות

איך מקבלים את המזהה של קהל היעד

כדי לקבל את המזהה של קהל יעד:

  1. במסוף Google Admin, לוחצים על תפריט > ספרייה > קהלים ממוקדים.

    מעבר אל משתמשי יעד

  2. בטבלה קהלים לטירגוט, לוחצים על השדה שם של קהל היעד.

  3. מאתרים את מזהה קהל היעד בכתובת ה-URL של הדף. הפורמט של כתובת ה-URL הוא https://admin.google.com/ac/targetaudiences/TARGET_AUDIENCE_ID, שבו TARGET_AUDIENCE_ID הוא המזהה האלפאנומרי של קהל היעד.

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

הגדרת קהלי יעד והרשאות מפורטות

כדי ליצור מרחב עם הרשאות גישה ספציפיות, משתמשים ב-method ‏create או setup במשאב Space. כדי לעדכן את ההרשאות במרחב קיים, משתמשים ב-method ‏update. מכיוון שאפשר לשתף קהלי יעד רק במרחבים עם שם, סוג המרחב (שמוצג בשדה spaceType) חייב להיות SPACE.

כדי לציין מי יכול למצוא מרחב או להצטרף אליו, צריך לכלול את האובייקט AccessSettings במשאב Space. באובייקט, משתמשים בשדה accessPermissionSettings כדי לציין הרשאה אחת או יותר מההרשאות הבאות:

  • גילוי: משתמשים באפשרות discoverSpaceSetting כדי להגדיר מי יכול למצוא את השם והתיאור של המרחב ולעיין בו ב-Google Chat. אפשר לציין כמה קהלי יעד לקמפיינים מסוג Discovery.
  • אפשר להצטרף: משתמשים בjoinSpaceSetting כדי להגדיר מי יכול להצטרף למרחב בלי הזמנה מפורשת ולראות את ההודעות במרחב. משתמשים שיכולים להצטרף למרחב צריכים גם להיות מסוגלים לגלות אותו. ב-Google Chat יש תמיכה בקהל יעד אחד להרשאה הזו.

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

  "accessSettings": {
    "accessPermissionSettings": {
      "discoverSpaceSetting": {
        "principals": [
          { "audience": { "name": "audiences/TARGET_AUDIENCE_ID_1" } },
          { "audience": { "name": "audiences/TARGET_AUDIENCE_ID_2" } }
        ]
      },
      "joinSpaceSetting": {
        "principals": [
          { "audience": { "name": "audiences/TARGET_AUDIENCE_ID_1" } }
        ]
      }
    }
  }

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

לצורך תאימות לאחור, משתמשים בשדה audience

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

הגדרת השדה audience שוות ערך להגדרת קהל היעד גם ב-joinSpaceSetting וגם ב-discoverSpaceSetting:

  "accessSettings": {
    "audience": "audiences/TARGET_AUDIENCE_ID"
  }

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

הסבר על הגדרות גישה בתגובות מה-API

כשמקבלים מרחבים, האובייקט AccessSettings בתגובה משקף את ההרשאות המפורטות שמוגדרות למרחב.

השדות הבאים ב-AccessSettings מציינים את האפשרות לחפש את המרחב ואת הרשאות ההצטרפות אליו:

  • ‫accessState: נגזר מהרשאות הגילוי (discoverSpaceSetting). אם הגילוי מוענק לקהל יעד אחד או יותר, השדה הזה הוא DISCOVERABLE. אחרת, היא תהיה PRIVATE.
  • ‫audience: ממופה באופן ספציפי להצטרפות להרשאות (joinSpaceSetting). אם קהל יעד יחיד מקבל הרשאת הצטרפות, השדה הזה מכיל את שם המשאב של קהל היעד הזה.

מרחב שגלוי לכולם ללא קהל שאפשר להצטרף אליו

יכול להיות שקהל יעד יוכל לגלות מרחב מסוים, אבל לא יוכל להצטרף אליו ישירות (לדוגמה, אם צריך להזמין משתמשים באופן מפורש כדי להצטרף).

במקרה הזה, לאובייקט AccessSettings יש את הערכים הבאים:

  • accessState: DISCOVERABLE
  • ‫audience: הושמט או null

אם אתם רואים את accessState מוגדר כ-DISCOVERABLE אבל audience לא מופיע, זה אומר שאפשר למצוא את המרחב באמצעות קהלי היעד שצוינו ב-discoverSpaceSetting, אבל אפשר להצטרף אליו רק בהזמנה. כדי לראות אילו קהלים יכולים לגלות את המרחב, בודקים את השדה accessPermissionSettings.discoverSpaceSetting.

במדריכים הבאים אפשר למצוא מידע נוסף על משתמשי היעד:

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