איך מגדירים מרחב משותף ב-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 יש תמיכה בקהל יעד אחד להרשאה הזו.
  • הצגת רשימת המשתתפים: משתמשים בviewSpaceMembershipSetting כדי להגדיר מי יכול לראות את רשימת המשתתפים במרחב. כשמעדכנים את ההרשאה לראות את חברי המרחב, צריך לציין את accessSettings.accessPermissionSettings.viewSpaceMembershipSetting יחד עם permissionSettings.viewSpaceMembership גם ב-updateMask וגם בגוף הבקשה. כשמגדירים קהל יעד ב-viewSpaceMembershipSetting, צריך להעניק את ההרשאה viewSpaceMembership לכל חברי המועדון (managersAllowed,‏ assistantManagersAllowed ו-membersAllowed מוגדרים ל-true).

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

{
  "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" } }
        ]
      },
      "viewSpaceMembershipSetting": {
        "principals": [
          { "audience": { "name": "audiences/TARGET_AUDIENCE_ID_1" } },
          { "audience": { "name": "audiences/TARGET_AUDIENCE_ID_2" } }
        ]
      }
    }
  },
  "permissionSettings": {
    "viewSpaceMembership": {
      "managersAllowed": true,
      "assistantManagersAllowed": true,
      "membersAllowed": true
    }
  }
}

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

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

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

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

  "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, אפשר לעיין במדריכים הבאים: