ติดตามกิจกรรมใน Google Chat

หน้านี้อธิบายเหตุการณ์ของ Chat ที่แอป Chat สามารถสมัครรับข้อมูลได้โดยใช้ Google Workspace Events API หลังจากตัดสินใจเลือกประเภทเหตุการณ์ที่ต้องการแล้ว ให้สร้างการสมัครรับข้อมูลเพื่อเริ่ม รับเหตุการณ์จาก Chat

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

เหตุการณ์ของ Chat ที่รองรับ

การสมัครใช้บริการ Google Workspace ช่วยให้คุณรับเหตุการณ์เกี่ยวกับการเปลี่ยนแปลงประเภทต่อไปนี้ใน Chat ได้

  • ข้อความใหม่ อัปเดต หรือลบ ข้อความ ในพื้นที่ทำงาน
  • การแสดงความรู้สึกใหม่หรือนำออก ต่อข้อความ
  • สมาชิกใหม่ อัปเดต หรือนำออก สมาชิก ในพื้นที่ทำงาน
  • การเปลี่ยนแปลงพื้นที่ทำงาน ที่คุณสมัครรับข้อมูล เช่น ชื่อหรือคำอธิบายพื้นที่ทำงานที่อัปเดต

ทรัพยากรที่คุณตรวจสอบหาเหตุการณ์ได้

หากต้องการรับเหตุการณ์ ให้ระบุทรัพยากร Chat ที่จะตรวจสอบ ซึ่งเรียกว่า ทรัพยากรเป้าหมายของการสมัครรับข้อมูล

Google Workspace Events API รองรับทรัพยากรเป้าหมายต่อไปนี้สำหรับ Chat

ทรัพยากรเป้าหมาย รูปแบบ ข้อจำกัด
พื้นที่ทำงาน

//chat.googleapis.com/spaces/SPACE

โดยที่ SPACE คือรหัสใน ชื่อทรัพยากรของทรัพยากร space ใน Chat API คุณดูรหัสได้จาก URL ของพื้นที่ทำงานหรือใช้เมธอด spaces.list()

 ผู้ใช้ Chat หรือแอป Chat ที่ให้สิทธิ์การสมัครรับข้อมูลต้อง เป็นสมาชิกของพื้นที่ทำงานผ่านบัญชี Google Workspace หรือบัญชี Google รองรับสิ่งต่อไปนี้
พื้นที่ทำงานทั้งหมดของผู้ใช้

//chat.googleapis.com/spaces/-

 การสมัครรับข้อมูลจะรับเหตุการณ์สำหรับพื้นที่ทำงานที่ผู้ใช้เป็นสมาชิกผ่านบัญชี Google Workspace หรือบัญชี Google เท่านั้น รองรับเฉพาะการตรวจสอบสิทธิ์ของผู้ใช้
ผู้ใช้

//cloudidentity.googleapis.com/users/USER

โดยที่ USER คือรหัสใน ชื่อทรัพยากรของทรัพยากร user ใน Chat API ดูรายละเอียดได้ที่ ระบุและระบุ ผู้ใช้ Google Chat

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

ประเภทเหตุการณ์สำหรับการสร้างการสมัครรับข้อมูล

เมื่อสร้างการสมัครรับข้อมูล ให้ใช้ช่อง eventTypes[] เพื่อระบุประเภทเหตุการณ์ที่ต้องการรับ ประเภทเหตุการณ์จะ จัดรูปแบบตามข้อกำหนด CloudEvents เช่น google.workspace.APPLICATION.RESOURCE.VERSION.ACTION

ตัวอย่างเช่น หากต้องการรับเหตุการณ์เกี่ยวกับผู้ใช้ที่เข้าร่วมพื้นที่ทำงาน Chat ให้ระบุพื้นที่ทำงานเป็นทรัพยากรเป้าหมาย และประเภทเหตุการณ์เป็น google.workspace.chat.membership.v1.created หากต้องการรับเหตุการณ์เกี่ยวกับผู้ใช้ที่เข้าร่วมพื้นที่ทำงาน ให้ระบุผู้ใช้เป็นทรัพยากรเป้าหมาย และประเภทเหตุการณ์เป็น google.workspace.chat.membership.v1.created ดูข้อมูลเพิ่มเติมเกี่ยวกับ วิธีทำงานของเหตุการณ์ได้ที่ โครงสร้างของเหตุการณ์ Google Workspace เหตุการณ์

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

ประเภทเหตุการณ์ รูปแบบ ข้อมูลทรัพยากร
การสมัครรับข้อมูลพื้นที่ทำงาน  
มีการโพสต์ข้อความ

google.workspace.chat.message.v1.created

space.message
มีการอัปเดตข้อความ

google.workspace.chat.message.v1.updated

space.message
มีการลบข้อความ

google.workspace.chat.message.v1.deleted

space.message
มีการสร้างการแสดงความรู้สึก

google.workspace.chat.reaction.v1.created

space.message.reaction
มีการลบการแสดงความรู้สึก

google.workspace.chat.reaction.v1.deleted

space.message.reaction
มีการเพิ่มสมาชิกในพื้นที่ทำงาน

google.workspace.chat.membership.v1.created

space.membership
มีการอัปเดตสมาชิกในพื้นที่ทำงาน

google.workspace.chat.membership.v1.updated

space.membership
มีการนำสมาชิกออกจากพื้นที่ทำงาน

google.workspace.chat.membership.v1.deleted

space.membership
มีการอัปเดตพื้นที่ทำงาน

google.workspace.chat.space.v1.updated

space
มีการลบพื้นที่ทำงาน

google.workspace.chat.space.v1.deleted

space
การสมัครรับข้อมูลผู้ใช้  
ผู้ใช้กลายเป็นสมาชิกของพื้นที่ทำงาน

ไม่ใช่สมาชิกใหม่ทั้งหมดที่จะทริกเกอร์เหตุการณ์ ดูรายละเอียดได้ที่ ข้อจำกัด

google.workspace.chat.membership.v1.created

space.membership
มีการอัปเดตการเป็นสมาชิกพื้นที่ทำงานของผู้ใช้

google.workspace.chat.membership.v1.updated

space.membership
มีการนำผู้ใช้ออกจากการเป็นสมาชิกโดยตรงของพื้นที่ทำงาน

google.workspace.chat.membership.v1.deleted

space.membership
มีการอัปเดตสถานะการอ่านพื้นที่ทำงานของผู้ใช้ ( Developer Preview)

google.workspace.chat.spaceReadState.v1.updated

spaceReadState
มีการอัปเดตสถานะการอ่านเธรดของผู้ใช้ ( Developer Preview)

google.workspace.chat.threadReadState.v1.updated

threadReadState

ประเภทเหตุการณ์แบบกลุ่ม (เอาต์พุตเท่านั้น)

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

ตัวอย่างเช่น หากผู้ใช้เพิ่มผู้ใช้ 20 คนลงในพื้นที่ทำงานพร้อมกัน แอป Chat ของคุณอาจได้รับเหตุการณ์แบบกลุ่ม (google.workspace.chat.membership.v1.batchCreated) เพย์โหลดของเหตุการณ์จะมีรายการทรัพยากร Membership ใหม่ทั้งหมดที่สร้างขึ้นเมื่อผู้ใช้เพิ่มสมาชิกลงในพื้นที่ทำงาน

คุณจะได้รับเหตุการณ์แบบกลุ่มสำหรับประเภทเหตุการณ์ที่คุณสมัครรับข้อมูล ดังนั้นจึงไม่จำเป็นต้องระบุเหตุการณ์แบบกลุ่มเมื่อสร้างการสมัครรับข้อมูล ตัวอย่างเช่น หากคุณสมัครรับข้อมูลการแสดงความรู้สึกใหม่ (google.workspace.chat.reaction.v1.created) ระบบจะกำหนดค่าแอป Chat ของคุณโดยอัตโนมัติให้รับเหตุการณ์การแสดงความรู้สึกแบบกลุ่ม (google.workspace.chat.reaction.v1.batchCreated)

ตารางต่อไปนี้แสดงเหตุการณ์แบบกลุ่มที่เป็นไปได้สำหรับการสมัครรับข้อมูล

ประเภทเหตุการณ์แบบกลุ่ม รูปแบบ
มีการโพสต์ข้อความหลายรายการ

google.workspace.chat.message.v1.batchCreated
มีการอัปเดตข้อความหลายรายการ

google.workspace.chat.message.v1.batchUpdated
มีการลบข้อความหลายรายการ

google.workspace.chat.message.v1.batchDeleted
มีการสร้างการแสดงความรู้สึกหลายรายการ

google.workspace.chat.reaction.v1.batchCreated
มีการลบการแสดงความรู้สึกหลายรายการ

google.workspace.chat.reaction.v1.batchDeleted
มีการเพิ่มสมาชิกหลายคนลงในพื้นที่ทำงานที่สมัครรับข้อมูล หรือมีการเพิ่มผู้ใช้ที่สมัครรับข้อมูลลงในพื้นที่ทำงานหลายแห่ง

google.workspace.chat.membership.v1.batchCreated
มีการอัปเดตการเป็นสมาชิกหลายรายการในพื้นที่ทำงานที่สมัครรับข้อมูล หรือสำหรับผู้ใช้ที่สมัครรับข้อมูล

google.workspace.chat.membership.v1.batchUpdated
มีการนำสมาชิกหลายคนออกจากพื้นที่ทำงานที่สมัครรับข้อมูล หรือมีการนำผู้ใช้ที่สมัครรับข้อมูลออกจากพื้นที่ทำงานหลายแห่ง

google.workspace.chat.membership.v1.batchDeleted
พื้นที่ทำงานมีการอัปเดตหลายรายการ

google.workspace.chat.space.v1.batchUpdated
มีการอัปเดตสถานะการอ่านพื้นที่ทำงานหลายรายการสำหรับผู้ใช้ที่สมัครรับข้อมูล ( Developer Preview)

google.workspace.chat.spaceReadState.v1.batchUpdated
มีการอัปเดตสถานะการอ่านเธรดหลายรายการสำหรับผู้ใช้ที่สมัครรับข้อมูล ( Developer Preview)

google.workspace.chat.threadReadState.v1.batchUpdated

ข้อมูลเหตุการณ์

ส่วนนี้อธิบายข้อมูลเหตุการณ์และเพย์โหลดตัวอย่างสำหรับเหตุการณ์ใน Chat

เมื่อการสมัครใช้บริการ Google Workspace ได้รับเหตุการณ์จาก Chat, dataช่อง จะมีเพย์โหลดสำหรับเหตุการณ์ เพย์โหลดนี้มีข้อมูลเกี่ยวกับทรัพยากร Google Workspace ที่เปลี่ยนแปลง ตัวอย่างเช่น หากคุณสมัครรับข้อมูลเหตุการณ์การเป็นสมาชิกในพื้นที่ทำงาน เพย์โหลดสำหรับเหตุการณ์เหล่านี้มีข้อมูลเกี่ยวกับทรัพยากร spaces.membership ที่เปลี่ยนแปลง

ข้อมูลทรัพยากรในเพย์โหลดของเหตุการณ์

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

ตารางต่อไปนี้แสดงตัวอย่างเพย์โหลด JSON สำหรับการสมัครรับข้อมูลพื้นที่ใน Chat spaces/AAAABBBBBB สำหรับแต่ละเหตุการณ์ที่การสมัครรับข้อมูลได้รับ เพย์โหลดจะปรากฏในช่อง data ของเหตุการณ์

ตัวอย่าง ประเภทเหตุการณ์ เพย์โหลด JSON

ผู้ใช้โพสต์ข้อความในพื้นที่ทำงานว่า "Hello world"

google.workspace.chat.message.v1.created

รวมข้อมูลทรัพยากร:

{
    "message":
    {
        "name": "spaces/SPACE_ID/messages/MESSAGE_ID",
        "sender":
        {
            "name": "users/USER_ID",
            "type": "HUMAN"
        },
        "createTime": "2023-09-07T21:37:36.260127Z",
        "text": "Hello world",
        "thread":
        {
            "name": "spaces/SPACE_ID/threads/THREAD_ID"
        },
        "space":
        {
            "name": "spaces/SPACE_ID"
        },
        "argumentText": "Hello world"
    }
}

ไม่รวมข้อมูลทรัพยากร:

{
    "message":
    {
        "name": "spaces/SPACE_ID/messages/MESSAGE_ID"
    }
}
ผู้ใช้กลายเป็นผู้จัดการพื้นที่ทำงาน

google.workspace.chat.membership.v1.updated

รวมข้อมูลทรัพยากร:

{
    "membership":
    {
        "name": "spaces/SPACE_ID/members/MEMBER_ID",
        "state": "JOINED",
        "member":
        {
            "name": "users/USER_ID",
            "type": "HUMAN"
        },
        "createTime": "1970-01-01T00:00:00Z",
        "role": "ROLE_MANAGER"
    }
}

ไม่รวมข้อมูลทรัพยากร:

{
    "membership":
    {
        "name": "spaces/SPACE_ID/members/MEMBER_ID"
    }
}
ผู้ใช้อัปเดตคำอธิบายของพื้นที่ทำงานเป็น "Sales team for Cymbal Labs" google.workspace.chat.space.v1.updated

รวมข้อมูลทรัพยากร:

{
    "space":
    {
        "name": "spaces/SPACE_ID",
        "displayName": "Cymbal Sales",
        "spaceThreadingState": "THREADED_MESSAGES",
        "spaceType": "SPACE",
        "spaceDetails":
        {
            "description": "Sales team for Cymbal Labs."
        },
        "spaceHistoryState": "HISTORY_ON"
    }
}

ไม่รวมข้อมูลทรัพยากร:

{
    "space":
    {
        "name": "spaces/SPACE_ID"
    }
}
มีการเพิ่มผู้ใช้ Chat 2 คนลงในพื้นที่ทำงานพร้อมกัน google.workspace.chat.membership.v1.batchCreated

รวมข้อมูลทรัพยากร:

{
    "memberships": [
        {
          "membership": {
            "name": "spaces/SPACE_ID/members/MEMBER_ID",
            "state": "JOINED",
            "member":
            {
                "name": "users/USER_ID",
                "type": "HUMAN"
            },
            "createTime": "1970-01-01T00:00:00Z",
            "role": "ROLE_MEMBER"
          }
        },
        {
          "membership": {
            "name": "spaces/SPACE_ID/members/MEMBER_ID",
            "state": "JOINED",
            "member":
            {
                "name": "users/USER_ID",
                "type": "HUMAN"
            },
            "createTime": "1970-01-01T00:00:00Z",
            "role": "ROLE_MEMBER"
          }
        }
    ]
}

ไม่รวมข้อมูลทรัพยากร:

{
    "memberships": [
        {
          "membership": {
            "name": "spaces/SPACE_ID/members/MEMBER_ID"
          }
        },
        {
          "membership": {
            "name": "spaces/SPACE_ID/members/MEMBER_ID"
          }
        }
    ]
}
ผู้ใช้แสดงความรู้สึกต่อข้อความด้วยอีโมจิ 😊 google.workspace.chat.reaction.v1.created

รวมข้อมูลทรัพยากร:

{
    "reaction":
    {
        "name": "spaces/SPACE_ID/messages/MESSAGE_ID/reactions/REACTION_ID",
        "user":
        {
            "name": "users/USER_ID",
            "type": "HUMAN"
        },
        "emoji":
        {
            "unicode": "😊"
        }
    }
}

ไม่รวมข้อมูลทรัพยากร:

{
    "reaction":
    {
        "name": "spaces/SPACE_ID/messages/MESSAGE_ID/reactions/REACTION_ID"
    }
}
ผู้ใช้แสดงความรู้สึกต่อข้อความด้วยอีโมจิ 😊 และ 😸 google.workspace.chat.reaction.v1.batchCreated

รวมข้อมูลทรัพยากร:

{
    "reactions": [
        {
          "reaction": {
            "name": "spaces/SPACE_ID/messages/MESSAGE_ID/reactions/REACTION_ID",
            "user":
            {
                "name": "users/USER_ID",
                "type": "HUMAN"
            },
            "emoji":
            {
                "unicode": "😊"
            }
          }
        },
        {
          "reaction": {
            "name": "spaces/SPACE_ID/messages/MESSAGE_ID/reactions/REACTION_ID",
            "user":
            {
                "name": "users/USER_ID",
                "type": "HUMAN"
            },
            "emoji":
            {
                "unicode": "😸"
            }
          }
        }
    ]
}

ไม่รวมข้อมูลทรัพยากร:

{
    "reactions": [
      {
        "reaction": {
            "name": "spaces/SPACE_ID/messages/MESSAGE_ID/reactions/REACTION_ID"
        },
        "reaction": {
            "name": "spaces/SPACE_ID/messages/MESSAGE_ID/reactions/REACTION_ID",
        }
      }
    ]
}
ผู้ใช้เข้าชมพื้นที่ทำงานที่ยังไม่ได้อ่าน ซึ่งจะอัปเดตสถานะการอ่านพื้นที่ทำงานของผู้ใช้ ( Developer Preview) google.workspace.chat.spaceReadState.v1.updated

รวมข้อมูลทรัพยากร:

{
  "spaceReadState": {
    "name": "users/USER_ID/spaces/SPACE_ID/spaceReadState",
    "lastReadTime": "2026-04-14T14:03:46.431760Z"
  }
}

ไม่รวมข้อมูลทรัพยากร:

{
  "spaceReadState": {
    "name": "users/USER_ID/spaces/SPACE_ID/spaceReadState"
  }
}
ผู้ใช้อ่านข้อความในเธรด ซึ่งจะอัปเดตสถานะการอ่านเธรดของผู้ใช้ ( Developer Preview) google.workspace.chat.threadReadState.v1.updated

รวมข้อมูลทรัพยากร:

{
  "threadReadState": {
    "name": "users/USER_ID/spaces/SPACE_ID/threads/THREAD_ID/threadReadState",
    "lastReadTime": "2026-04-14T14:03:46.431760Z"
  }
}

ไม่รวมข้อมูลทรัพยากร:

{
  "threadReadState": {
    "name": "users/USER_ID/spaces/SPACE_ID/threads/THREAD_ID/threadReadState"
  }
}

ข้อจำกัด
  • สำหรับการสมัครรับข้อมูลผู้ใช้ เหตุการณ์เกี่ยวกับสมาชิกใหม่ในข้อความโดยตรงหรือการแชทเป็นกลุ่มที่ไม่มีชื่อ (google.workspace.chat.membership.v1.created) จะทริกเกอร์หลังจากมีการโพสต์ข้อความแรกเท่านั้น
  • หากต้องการรับเหตุการณ์การเป็นสมาชิก ผู้ใช้หรือแอป Chat ต้องเป็นสมาชิกโดยตรงของพื้นที่ทำงาน หากมีการเพิ่ม อัปเดต หรือนำผู้ใช้หรือแอป Chat ออกจากพื้นที่ทำงานโดยอ้อมผ่าน Google Group การสมัครรับข้อมูลจะไม่ได้รับเหตุการณ์การเป็นสมาชิกเหล่านั้น ดูวิธีทำงานของการเป็นสมาชิก Google Group ได้ที่ เพิ่ม Google Group ลงในพื้นที่ทำงาน