ทำให้ผู้ใช้บางรายในองค์กร Google Workspace ค้นพบพื้นที่ใน Google Chat ได้

หน้านี้อธิบายวิธีใช้ Google Chat API เพื่อแชร์พื้นที่ทำงานใน Google Chat กับผู้ใช้ที่เฉพาะเจาะจงในองค์กร Google Workspace เพื่อให้ผู้ใช้เหล่านั้น ค้นพบและเข้าร่วมพื้นที่ทำงานได้

หากต้องการระบุผู้ใช้ในองค์กรที่ค้นพบและเข้าร่วมพื้นที่ทำงานได้ คุณต้องสร้างกลุ่มเป้าหมาย กลุ่มเป้าหมายคือกลุ่มคน เช่น แผนกที่เฉพาะเจาะจงหรือทั้งองค์กรที่คุณแชร์ พื้นที่ทำงานใน Chat ด้วยได้ เพื่อปรับปรุงการรับรู้และความสามารถในการแชร์ของพื้นที่ทำงาน นอกจากนี้ กลุ่มเป้าหมายยังช่วยให้คุณจัดการและปรับแต่งการเป็นสมาชิกในพื้นที่ทำงานได้โดยไม่ต้องเชิญผู้ใช้แต่ละรายไปยังพื้นที่ทำงาน ดูข้อมูลเพิ่มเติมได้ที่เกี่ยวกับกลุ่มเป้าหมาย

คุณจะทำให้พื้นที่ทำงานที่มีชื่อค้นพบได้เฉพาะกลุ่มเป้าหมายเท่านั้น คุณไม่สามารถแชร์พื้นที่ทำงานประเภทอื่นๆ เช่น ข้อความส่วนตัวหรือการสนทนากลุ่ม กับกลุ่มเป้าหมายได้

ข้อกำหนดเบื้องต้น

รับรหัสกลุ่มเป้าหมาย

หากต้องการรับรหัสของกลุ่มเป้าหมาย ให้ทำดังนี้

  1. ในคอนโซลผู้ดูแลระบบของ Google ให้ไปที่ เมนู > ไดเรกทอรี > กลุ่มเป้าหมาย

    ไปที่กลุ่มเป้าหมาย

  2. ในตารางกลุ่มเป้าหมาย ให้คลิกช่องชื่อของกลุ่มเป้าหมาย

  3. ค้นหารหัสกลุ่มเป้าหมายใน URL ของหน้าเว็บ รูปแบบ URL คือ https://admin.google.com/ac/targetaudiences/TARGET_AUDIENCE_ID โดยที่ TARGET_AUDIENCE_ID คือรหัสตัวอักษรและตัวเลขสำหรับ กลุ่มเป้าหมาย

ในส่วนถัดไป คุณจะใช้รหัสกลุ่มเป้าหมายเพื่อสร้าง พื้นที่ที่ค้นพบได้ หรืออัปเดตพื้นที่ที่มีอยู่ให้กลุ่มเป้าหมาย ค้นพบได้

ระบุกลุ่มเป้าหมายและสิทธิ์แบบละเอียด

หากต้องการสร้างพื้นที่ทำงานที่มีสิทธิ์เข้าถึงที่เฉพาะเจาะจง ให้ใช้วิธี create หรือ setup ใน Space resource หากต้องการอัปเดตสิทธิ์สำหรับพื้นที่ทำงานที่มีอยู่ ให้ใช้เมธอด update เนื่องจากแชร์ได้เฉพาะพื้นที่ทำงานที่มีชื่อกับกลุ่มเป้าหมาย ประเภทพื้นที่ทำงาน (แสดงในช่อง spaceType) จึงต้องเป็น SPACE

หากต้องการระบุว่าใครค้นพบหรือเข้าร่วมพื้นที่ทำงานได้ ให้รวมออบเจ็กต์ AccessSettings ไว้ในทรัพยากร Space ในออบเจ็กต์ ให้ใช้ฟิลด์ accessPermissionSettings เพื่อระบุสิทธิ์ต่อไปนี้อย่างน้อย 1 รายการ

  • ค้นพบได้: ใช้ discoverSpaceSetting เพื่อกำหนดว่าใครค้นหาชื่อ และคำอธิบายของพื้นที่ทำงานได้ รวมถึงเรียกดูพื้นที่ทำงานนั้นใน Google Chat ได้ คุณ ระบุกลุ่มเป้าหมายหลายกลุ่มสำหรับการค้นพบได้
  • เข้าร่วมได้: ใช้ joinSpaceSetting เพื่อกำหนดผู้ที่เข้าร่วมพื้นที่ทำงานได้โดยไม่ต้องมีคำเชิญที่ชัดเจนและดูตัวอย่างข้อความในพื้นที่ทำงาน ผู้ใช้ที่เข้าร่วมพื้นที่ทำงานได้ต้องค้นพบพื้นที่ทำงานได้ด้วย Google Chat รองรับ กลุ่มเป้าหมายเดียวสำหรับสิทธิ์นี้

ตัวอย่างต่อไปนี้แสดงวิธีทำให้พื้นที่สามารถค้นพบได้โดยกลุ่มเป้าหมาย 2 กลุ่ม และกลุ่มใดกลุ่มหนึ่งจะเข้าร่วมได้

  "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) หากให้สิทธิ์การค้นพบแก่กลุ่มเป้าหมายอย่างน้อย 1 กลุ่ม ฟิลด์นี้จะเป็น DISCOVERABLE มิเช่นนั้นจะเป็น PRIVATE
  • audience: แมปกับการให้สิทธิ์เข้าร่วมโดยเฉพาะ (joinSpaceSetting) หากกลุ่มเป้าหมายเดียวได้รับสิทธิ์เข้าร่วม ฟีลด์นี้จะมีชื่อทรัพยากรของกลุ่มเป้าหมายนั้น

พื้นที่ทำงานที่ค้นพบได้ซึ่งไม่มีกลุ่มเป้าหมายที่เข้าร่วม

กลุ่มเป้าหมายอาจค้นพบพื้นที่ทำงานได้ แต่จะเข้าร่วมโดยตรงไม่ได้ (เช่น หากต้องเชิญผู้ใช้ให้เข้าร่วมอย่างชัดเจน)

ในกรณีนี้ ออบเจ็กต์ AccessSettings จะมีค่าต่อไปนี้

  • accessState: DISCOVERABLE
  • audience: ละเว้นหรือ null

หากเห็น accessState ตั้งค่าเป็น DISCOVERABLE แต่ไม่มี audience แสดงว่ากลุ่มเป้าหมายที่ระบุใน discoverSpaceSetting จะค้นพบพื้นที่ทำงานได้ แต่จะเข้าร่วมได้ก็ต่อเมื่อได้รับคำเชิญเท่านั้น หากต้องการดูว่ากลุ่มเป้าหมายใดค้นพบพื้นที่ทำงานได้ ให้ตรวจสอบช่องaccessPermissionSettings.discoverSpaceSetting

ดูรายละเอียดเกี่ยวกับกลุ่มเป้าหมายได้ในคำแนะนำต่อไปนี้

ดูรายละเอียดเกี่ยวกับการสร้างหรืออัปเดตพื้นที่ทำงานโดยใช้ Chat API ได้ในคำแนะนำต่อไปนี้