ประเภททรัพยากร API ของปฏิทิน

พื้นหลัง API ของปฏิทิน

แนวคิดของปฏิทิน

Google ปฏิทินสร้างขึ้นจากแนวคิดพื้นฐานหลายประการ ดังนี้

เหตุการณ์
กิจกรรมเดียวในปฏิทินที่มีข้อมูล เช่น ชื่อกิจกรรม เวลาเริ่มต้นและสิ้นสุด และผู้เข้าร่วม
ปฏิทิน
รายการปฏิทินเดียวที่มีข้อมูลเมตาสำหรับปฏิทิน เช่น คำอธิบาย
รายการปฏิทิน
รายการปฏิทินทั้งหมดในรายการปฏิทินของผู้ใช้ใน UI ปฏิทิน
การเกริ่นนำ
ค่ากำหนดของผู้ใช้จาก UI ของปฏิทิน เช่น เขตเวลาของผู้ใช้
ACL
กฎควบคุมการเข้าถึงกฎเดียวซึ่งมีข้อมูลต่างๆ เช่น ประเภทและขอบเขตของกฎ

โมเดลข้อมูล API ของปฏิทิน

ทรัพยากรเป็นเอนทิตีข้อมูลแต่ละรายการที่มีตัวระบุที่ไม่ซ้ำกัน API ของปฏิทินทำงานกับทรัพยากร 5 ประเภทดังนี้

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

โมเดลข้อมูล API ของปฏิทินจะอิงตามกลุ่มทรัพยากรที่เรียกว่า "คอลเล็กชัน" ดังนี้

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