สมัครรับข้อมูลกิจกรรมโดยใช้ Google Workspace Events API

หน้านี้แสดงภาพรวมของ Google Workspace Events API และอธิบายวิธีใช้ API เพื่อสมัครรับข้อมูลกิจกรรมใน Google Workspace

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

วิธีที่แอปได้รับเหตุการณ์

หากต้องการให้แอปรับกิจกรรมใน Google Workspace ให้ใช้ Google Workspace Events API เพื่อสร้างการสมัครใช้บริการทรัพยากร Google Workspace

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

1. แอป Chat สมัครใช้บริการพื้นที่ใน Chat ใน Google Chat
2. การเปลี่ยนแปลงพื้นที่ใน Chat เช่น มีการโพสต์ข้อความใหม่ ในพื้นที่ทำงาน
3. Chat จะส่งเหตุการณ์ไปยังหัวข้อใน Google Cloud Pub/Sub ซึ่งทำหน้าที่เป็นปลายทางการแจ้งเตือนสำหรับการสมัครใช้บริการ เหตุการณ์ มีข้อมูลเกี่ยวกับการเปลี่ยนแปลง ตัวอย่างเช่น สำหรับเหตุการณ์เกี่ยวกับข้อความใหม่ เหตุการณ์จะมีรายละเอียดเกี่ยวกับMessageทรัพยากรที่สร้างขึ้น
4. แอป Chat จะประมวลผลข้อความ Pub/Sub ของ Google Cloud ที่มีเหตุการณ์ และดำเนินการหากจำเป็น

คำศัพท์สำคัญ

คำศัพท์ทั่วไปที่ใช้ใน Google Workspace Events API ได้แก่

กิจกรรม Google Workspace

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

กิจกรรมการสมัครใช้บริการ

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

เหตุการณ์ในวงจร

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

การสมัครใช้บริการ Google Workspace

เอนทิตีที่มีชื่อซึ่งตรวจสอบทรัพยากรจากแอปพลิเคชัน Google Workspace การสมัครใช้บริการจะแสดงด้วยทรัพยากร Subscription การสมัครใช้บริการจะกำหนดโดยข้อมูลต่อไปนี้

ทรัพยากรเป้าหมาย

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

ประเภทเหตุการณ์

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

ปลายทางการแจ้งเตือน

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

ตัวเลือกเพย์โหลด

ข้อมูลเหตุการณ์ที่ต้องการรับเกี่ยวกับทรัพยากรที่มีการเปลี่ยนแปลง

กิจกรรม Google Workspace ที่รองรับ

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

ดูข้อมูลเพิ่มเติมได้ที่คู่มือต่อไปนี้

• ติดตามกิจกรรมใน Chat
• ติดตามเหตุการณ์ในไดรฟ์
• ติดตามกิจกรรมของ Meet

โครงสร้างของกิจกรรม Google Workspace

เหตุการณ์ใน Google Workspace เป็นไปตามข้อกำหนด CloudEvents ซึ่งเป็นวิธีมาตรฐานในอุตสาหกรรม ในการอธิบายข้อมูลเหตุการณ์ กิจกรรมใน Google Workspace ประกอบด้วยข้อมูลต่อไปนี้

• แอตทริบิวต์ของ CloudEvent
• ข้อมูลเกี่ยวกับทรัพยากร Google Workspace ที่เปลี่ยนแปลงอันเป็นผลมาจากเหตุการณ์

ส่วนต่อไปนี้จะอธิบายโครงสร้างของแอตทริบิวต์และข้อมูลสำหรับ กิจกรรมใน Google Workspace

แอตทริบิวต์ CloudEvent

เหตุการณ์ใน Google Workspace มีแอตทริบิวต์ CloudEvents ที่จำเป็นต่อไปนี้

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

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

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

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

ตัวเลือกเหล่านี้สำหรับข้อมูลเหตุการณ์จะแสดงในฟิลด์ payloadOptions ของการสมัครใช้บริการ

เหตุการณ์เป็นข้อความ Google Cloud Pub/Sub

การสมัครใช้บริการ Google Workspace Events API จะใช้หัวข้อ Google Cloud Pub/Sub เป็นปลายทางการแจ้งเตือนที่รับ เหตุการณ์ใน Google Workspace ระบบจะเข้ารหัสเหตุการณ์เป็นข้อความ Google Cloud Pub/Sub แอปของคุณสามารถประมวลผลข้อความ Google Cloud Pub/Sub เพื่อดำเนินการหรือตอบสนองต่อเหตุการณ์ได้

ตัวอย่างต่อไปนี้แสดงข้อความ Google Cloud Pub/Sub ที่มี เหตุการณ์เกี่ยวกับข้อความที่อัปเดตในพื้นที่ใน Chat

 {
    "message":
    {
        "attributes":
        {
            "ce-datacontenttype": "application/json",
            "ce-id": "spaces/SPACE_ID/spaceEvents/SPACE_EVENT_ID",
            "ce-source": "//workspaceevents.googleapis.com/subscriptions/SUBSCRIPTION_ID",
            "ce-specversion": "1.0",
            "ce-subject": "//chat.googleapis.com/spaces/SPACE_ID",
            "ce-time": "2023-09-07T21:37:53.274191Z",
            "ce-type": "google.workspace.chat.message.v1.updated"
        },
        "data": "EVENT_DATA",
        "messageId": "PUBSUB_MESSAGE_ID",
        "orderingKey": "//workspaceevents.googleapis.com/subscriptions/SUBSCRIPTION_ID",
        "publishTime": "2023-09-07T21:37:53.713Z"
    }
}

ตัวอย่างนี้ประกอบด้วยช่องต่อไปนี้

• attributes: แอตทริบิวต์สำหรับ CloudEvent ซึ่งรวมถึง ประเภทเหตุการณ์ ในกรณีนี้ เหตุการณ์จะเกี่ยวกับข้อความที่อัปเดตในพื้นที่ทำงาน
• data: ข้อมูลเหตุการณ์ที่มีรายละเอียดเกี่ยวกับทรัพยากรที่อัปเดต spaces.message ซึ่งจัดรูปแบบเป็นสตริงที่เข้ารหัส Base64
• messageId: ตัวระบุสำหรับข้อความ Google Cloud Pub/Sub

ดูข้อมูลเพิ่มเติมเกี่ยวกับวิธีระบุ CloudEvents ในข้อความ Google Cloud Pub/Sub ได้ที่การเชื่อมโยงโปรโตคอล Google Cloud Pub/Sub สำหรับ CloudEvents

หัวข้อที่เกี่ยวข้อง

• เลือกขอบเขต Google Workspace Events API
• สร้างการสมัครใช้บริการ Google Workspace