ทำให้ผู้ใช้บางรายในองค์กร 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 หากต้องการอัปเดตสิทธิ์สำหรับพื้นที่ทำงานที่มีอยู่ ให้ใช้วิธี update เนื่องจากแชร์ได้เฉพาะพื้นที่ทำงานที่มีชื่อกับกลุ่มเป้าหมายเท่านั้น ประเภทพื้นที่ทำงาน (แสดงในช่อง spaceType) จึงต้องเป็น SPACE

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

  • ค้นพบได้: ใช้ discoverSpaceSetting เพื่อกำหนดว่าใครค้นหาชื่อ และคำอธิบายของพื้นที่ทำงาน รวมถึงเรียกดูพื้นที่ทำงานนั้นใน Google Chat ได้ คุณ ระบุกลุ่มเป้าหมายหลายกลุ่มสำหรับการค้นพบได้
  • เข้าร่วมได้: ใช้ joinSpaceSetting เพื่อกำหนดผู้ที่เข้าร่วมพื้นที่ทำงานได้โดยไม่ต้องมีคำเชิญที่ชัดเจนและดูตัวอย่างข้อความในพื้นที่ทำงาน ผู้ใช้ที่เข้าร่วมพื้นที่ทำงานได้ต้องค้นพบพื้นที่ทำงานได้ด้วย Google Chat รองรับ กลุ่มเป้าหมายเดียวสำหรับสิทธิ์นี้
  • ดูการเป็นสมาชิก: ใช้ viewSpaceMembershipSetting เพื่อกำหนดผู้ที่ดูรายชื่อสมาชิกในพื้นที่ทำงานได้ เมื่ออัปเดตผู้ที่มีสิทธิ์ดูการเป็นสมาชิกพื้นที่ทำงาน accessSettings.accessPermissionSettings.viewSpaceMembershipSetting ต้อง ระบุพร้อมกับ permissionSettings.viewSpaceMembership ทั้งใน updateMask และเนื้อหาคำขอ เมื่อกำหนดค่ากลุ่มเป้าหมายใน viewSpaceMembershipSetting แล้ว ต้องให้สิทธิ์ viewSpaceMembership แก่สมาชิกทุกคน (managersAllowed, assistantManagersAllowed และ membersAllowed ตั้งค่าเป็น true)

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

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

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

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

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

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

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

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