Events: insert

หมายเหตุ: ต้องมีการให้สิทธิ์

สร้างกิจกรรม ลองใช้เลย

ส่งคำขอ

คำขอ HTTP

POST https://www.googleapis.com/calendar/v3/calendars/calendarId/events

พารามิเตอร์

ชื่อพารามิเตอร์	ค่า	คำอธิบาย
พารามิเตอร์เส้นทาง
calendarId	string	ตัวระบุปฏิทิน หากต้องการดึงรหัสปฏิทิน ให้เรียกใช้เมธอด calendarList.list หากต้องการเข้าถึงปฏิทินหลักของผู้ใช้ที่เข้าสู่ระบบอยู่ในปัจจุบัน ให้ใช้คีย์เวิร์ด "primary"
พารามิเตอร์การค้นหาที่ไม่บังคับ
conferenceDataVersion	integer	หมายเลขเวอร์ชันของข้อมูลการประชุมที่ไคลเอ็นต์ API รองรับ เวอร์ชัน 0 จะถือว่าไม่มีการรองรับข้อมูลการประชุมและไม่สนใจข้อมูลการประชุมในเนื้อหาของกิจกรรม เวอร์ชัน 1 รองรับการคัดลอก ConferenceData รวมถึงการสร้างการประชุมใหม่โดยใช้ฟิลด์ createRequest ของ conferenceData ค่าเริ่มต้นคือ 0 ค่าที่ยอมรับได้คือ 0 ถึง 1
maxAttendees	integer	จำนวนผู้เข้าร่วมสูงสุดที่จะรวมไว้ในการตอบกลับ หากมีผู้เข้าร่วมมากกว่าจำนวนที่ระบุ ระบบจะแสดงผลเฉพาะผู้เข้าร่วม ไม่บังคับ
sendNotifications	boolean	เลิกใช้งานแล้ว โปรดใช้ sendUpdates แทน เลือกว่าจะส่งการแจ้งเตือนเกี่ยวกับการสร้างกิจกรรมใหม่หรือไม่ โปรดทราบว่าระบบอาจยังส่งอีเมลบางฉบับแม้ว่าคุณจะตั้งค่าเป็น false แล้วก็ตาม ค่าเริ่มต้นคือ false
sendUpdates	string	จะส่งการแจ้งเตือนเกี่ยวกับการสร้างกิจกรรมใหม่หรือไม่ โปรดทราบว่าระบบอาจยังส่งอีเมลบางฉบับ โดยมีค่าเริ่มต้นเป็น false ค่าที่ยอมรับมีดังนี้ "all": ระบบจะส่งการแจ้งเตือนไปยังผู้เข้าร่วมทุกคน "externalOnly": ระบบจะส่งการแจ้งเตือนไปยังผู้เข้าร่วมที่ไม่ได้ใช้ Google ปฏิทินเท่านั้น "none": ไม่มีการส่งการแจ้งเตือน คำเตือน: การใช้ค่า none อาจส่งผลเสียอย่างมาก รวมถึงกิจกรรมไม่ซิงค์กับปฏิทินภายนอก หรือผู้ใช้บางรายอาจสูญเสียกิจกรรมไปโดยสิ้นเชิง สำหรับงานการย้ายข้อมูลปฏิทิน ให้ลองใช้เมธอด events.import แทน
supportsAttachments	boolean	ระบุว่าไคลเอ็นต์ API ที่ดำเนินการรองรับไฟล์แนบของกิจกรรมหรือไม่ ไม่บังคับ ค่าเริ่มต้นคือ False

การให้สิทธิ์

คำขอนี้ต้องมีการให้สิทธิ์ที่มีขอบเขตต่อไปนี้อย่างน้อย 1 รายการ

ขอบเขต
https://www.googleapis.com/auth/calendar
https://www.googleapis.com/auth/calendar.events
https://www.googleapis.com/auth/calendar.app.created
https://www.googleapis.com/auth/calendar.events.owned

ดูข้อมูลเพิ่มเติมได้ที่หน้าการตรวจสอบสิทธิ์และการให้สิทธิ์

เนื้อความของคำขอ

ในเนื้อหาของคำขอ ให้ระบุทรัพยากรเหตุการณ์ที่มีพร็อพเพอร์ตี้ต่อไปนี้

ชื่อพร็อพเพอร์ตี้	ค่า	คำอธิบาย	หมายเหตุ
พร็อพเพอร์ตี้ที่จำเป็น
end	nested object	เวลาสิ้นสุด (ไม่รวม) ของกิจกรรม สำหรับกิจกรรมที่เกิดซ้ำ นี่คือเวลาสิ้นสุดของอินสแตนซ์แรก
start	nested object	เวลาเริ่มต้นของกิจกรรม (รวมวันที่เริ่มต้น) สำหรับกิจกรรมที่เกิดซ้ำ นี่คือเวลาเริ่มต้นของอินสแตนซ์แรก
พร็อพเพอร์ตี้ที่ไม่บังคับ
anyoneCanAddSelf	boolean	ไม่ว่าใครจะเชิญตัวเองเข้าร่วมกิจกรรมได้หรือไม่ (เลิกใช้งานแล้ว) ไม่บังคับ ค่าเริ่มต้นคือ False	เขียนได้
attachments[].fileUrl	string	ลิงก์ URL ไปยังไฟล์แนบ หากต้องการเพิ่มไฟล์แนบจาก Google ไดรฟ์ ให้ใช้รูปแบบเดียวกับในพร็อพเพอร์ตี้ alternateLink ของทรัพยากร Files ใน Drive API ต้องระบุเมื่อเพิ่มไฟล์แนบ	เขียนได้
attendees[]	list	ผู้เข้าร่วมกิจกรรม ดูข้อมูลเพิ่มเติมเกี่ยวกับการกำหนดเวลากิจกรรมร่วมกับผู้ใช้ปฏิทินรายอื่นได้ในคู่มือกิจกรรมที่มีผู้เข้าร่วม บัญชีบริการต้องใช้การมอบสิทธิ์ทั้งโดเมนเพื่อสร้างรายการผู้เข้าร่วม	เขียนได้
attendees[].additionalGuests	integer	จำนวนแขกเพิ่มเติม ไม่บังคับ ค่าเริ่มต้นคือ 0	เขียนได้
attendees[].comment	string	ความคิดเห็นตอบกลับของผู้เข้าร่วม ไม่บังคับ	เขียนได้
attendees[].displayName	string	ชื่อผู้เข้าร่วม (หากมี) ไม่บังคับ	เขียนได้
attendees[].email	string	อีเมลของผู้เข้าร่วม (หากมี) ต้องระบุช่องนี้เมื่อเพิ่มผู้เข้าร่วม ต้องเป็นอีเมลที่ถูกต้องตาม RFC5322 ต้องระบุเมื่อเพิ่มผู้เข้าร่วม	เขียนได้
attendees[].optional	boolean	ระบุว่าผู้เข้าร่วมเป็นผู้เข้าร่วมที่ไม่บังคับหรือไม่ ไม่บังคับ ค่าเริ่มต้นคือ False	เขียนได้
attendees[].resource	boolean	ผู้เข้าร่วมเป็นทรัพยากรหรือไม่ ตั้งค่าได้เมื่อเพิ่มผู้เข้าร่วมลงในกิจกรรมเป็นครั้งแรกเท่านั้น ระบบจะไม่สนใจการแก้ไขในภายหลัง ไม่บังคับ ค่าเริ่มต้นคือ False	เขียนได้
attendees[].responseStatus	string	สถานะการตอบกลับของผู้เข้าร่วม ค่าที่เป็นไปได้มีดังนี้ "needsAction" - ผู้เข้าร่วมยังไม่ได้ตอบรับคำเชิญ (แนะนำสำหรับกิจกรรมใหม่) "declined" - ผู้เข้าร่วมปฏิเสธคำเชิญ "tentative" - ผู้เข้าร่วมตอบรับคำเชิญชั่วคราว "accepted" - ผู้เข้าร่วมยอมรับคำเชิญแล้ว คำเตือน: หากคุณเพิ่มกิจกรรมโดยใช้ค่า declined, tentative หรือ accepted ผู้เข้าร่วมที่มีการตั้งค่า "เพิ่มคำเชิญในปฏิทินของฉัน" เป็น "เมื่อฉันตอบรับคำเชิญในอีเมล" หรือ "เมื่อฉันรู้จักผู้ส่งเท่านั้น" อาจได้รับการรีเซ็ตคำตอบเป็น needsAction และจะไม่เห็นกิจกรรมในปฏิทิน เว้นแต่จะเปลี่ยนคำตอบในอีเมลคำเชิญเข้าร่วมกิจกรรม นอกจากนี้ หากมีการเชิญผู้เข้าร่วมมากกว่า 200 คนไปยังกิจกรรม ระบบจะไม่ส่งต่อสถานะการตอบกลับไปยังผู้เข้าร่วม	เขียนได้
birthdayProperties	nested object	ข้อมูลวันเกิดหรือกิจกรรมพิเศษ ใช้ในกรณีที่ eventType เป็น "birthday" เปลี่ยนแปลงไม่ได้	เขียนได้
birthdayProperties.type	string	ประเภทวันเกิดหรือกิจกรรมพิเศษ ค่าที่เป็นไปได้มีดังนี้ "anniversary" - วันครบรอบอื่นๆ ที่ไม่ใช่วันเกิด มี contact เสมอ "birthday" - กิจกรรมวันเกิด นี่คือค่าเริ่มต้น "custom" - วันที่พิเศษที่มีการระบุป้ายกำกับเพิ่มเติมในช่อง customTypeName มี contact เสมอ "other" - วันที่พิเศษที่ไม่อยู่ในหมวดหมู่อื่นๆ และไม่มีป้ายกำกับที่กำหนดเอง มี contact เสมอ "self" - วันเกิดของเจ้าของปฏิทิน ต้องไม่มี contact Calendar API รองรับเฉพาะการสร้างกิจกรรมที่มีประเภท "birthday" คุณจะเปลี่ยนประเภทหลังจากสร้างกิจกรรมแล้วไม่ได้	เขียนได้
colorId	string	สีของกิจกรรม นี่คือรหัสที่อ้างอิงถึงรายการในส่วน event ของคำจำกัดความสี (ดู ปลายทางสี) ไม่บังคับ	เขียนได้
conferenceData	nested object	ข้อมูลที่เกี่ยวข้องกับการประชุม เช่น รายละเอียดการประชุม Google Meet หากต้องการสร้างรายละเอียดการประชุมใหม่ ให้ใช้ฟิลด์ createRequest หากต้องการคงการเปลี่ยนแปลงไว้ โปรดอย่าลืมตั้งค่าconferenceDataVersionพารามิเตอร์คำขอเป็น 1 สำหรับคำขอแก้ไขเหตุการณ์ทั้งหมด คำเตือน: การนำข้อมูลการประชุม Google Meet ไปใช้ซ้ำในกิจกรรมต่างๆ อาจทำให้เกิดปัญหาการเข้าถึงและเปิดเผยรายละเอียดการประชุมต่อผู้ใช้ที่ไม่ต้องการ โปรดสร้างการประชุมที่ไม่ซ้ำกันสำหรับแต่ละกิจกรรมเสมอโดยใช้ช่อง createRequest เพื่อช่วยให้การประชุมมีความเป็นส่วนตัว	เขียนได้
description	string	คำอธิบายกิจกรรม มี HTML ได้ ไม่บังคับ	เขียนได้
end.date	date	วันที่ในรูปแบบ "ปปปป-ดด-วว" หากเป็นกิจกรรมตลอดวัน	เขียนได้
end.dateTime	datetime	เวลาเป็นค่าวันที่และเวลารวม (จัดรูปแบบตาม RFC3339) ต้องระบุออฟเซ็ตเขตเวลา เว้นแต่จะระบุเขตเวลาอย่างชัดเจนใน timeZone	เขียนได้
end.timeZone	string	เขตเวลาที่ระบุเวลา (จัดรูปแบบเป็นชื่อฐานข้อมูลเขตเวลาของ IANA เช่น "Europe/Zurich") สำหรับกิจกรรมที่เกิดซ้ำ ฟิลด์นี้จำเป็นและระบุเขตเวลาที่จะขยายการเกิดซ้ำ สำหรับกิจกรรมเดียว ฟิลด์นี้ไม่บังคับและระบุเขตเวลาที่กำหนดเองสำหรับเวลาเริ่มต้น/สิ้นสุดของกิจกรรม	เขียนได้
eventType	string	ประเภทเฉพาะของเหตุการณ์ คุณจะแก้ไขส่วนนี้หลังจากที่สร้างกิจกรรมแล้วไม่ได้ ค่าที่เป็นไปได้มีดังนี้ "birthday" - กิจกรรมพิเศษตลอดทั้งวันที่มีการเกิดซ้ำทุกปี "default" - กิจกรรมปกติหรือไม่ได้ระบุเพิ่มเติม "focusTime" - กิจกรรมที่ต้องการสมาธิ "fromGmail" - กิจกรรมจาก Gmail สร้างกิจกรรมประเภทนี้ไม่ได้ "outOfOffice" - กิจกรรมลางาน "workingLocation" - เหตุการณ์สถานที่ทำงาน	เขียนได้
extendedProperties.private	object	พร็อพเพอร์ตี้ที่เป็นแบบส่วนตัวสำหรับสำเนากิจกรรมที่ปรากฏในปฏิทินนี้	เขียนได้
extendedProperties.shared	object	พร็อพเพอร์ตี้ที่แชร์ระหว่างสำเนากิจกรรมในปฏิทินของผู้เข้าร่วมคนอื่นๆ	เขียนได้
focusTimeProperties	nested object	ข้อมูลกิจกรรมที่ต้องการสมาธิ ใช้ในกรณีที่ eventType เป็น focusTime	เขียนได้
gadget.display	string	โหมดการแสดงผลของแกดเจ็ต เลิกใช้งานแล้ว ค่าที่เป็นไปได้มีดังนี้ "icon" - แกดเจ็ตจะแสดงข้างชื่อกิจกรรมในมุมมองปฏิทิน "chip" - แกดเจ็ตจะแสดงเมื่อมีการคลิกเหตุการณ์	เขียนได้
gadget.height	integer	ความสูงของแกดเจ็ตในหน่วยพิกเซล ความสูงต้องเป็นจำนวนเต็มที่มากกว่า 0 ไม่บังคับ เลิกใช้งานแล้ว	เขียนได้
gadget.iconLink	string	URL ของไอคอนแกดเจ็ต รูปแบบ URL ต้องเป็น HTTPS เลิกใช้งานแล้ว	เขียนได้
gadget.link	string	URL ของแกดเจ็ต รูปแบบ URL ต้องเป็น HTTPS เลิกใช้งานแล้ว	เขียนได้
gadget.preferences	object	ค่ากำหนด	เขียนได้
gadget.title	string	ชื่อของแกดเจ็ต เลิกใช้งานแล้ว	เขียนได้
gadget.type	string	ประเภทของแกดเจ็ต เลิกใช้งานแล้ว	เขียนได้
gadget.width	integer	ความกว้างของแกดเจ็ตในหน่วยพิกเซล ความกว้างต้องเป็นจำนวนเต็มที่มากกว่า 0 ไม่บังคับ เลิกใช้งานแล้ว	เขียนได้
guestsCanInviteOthers	boolean	ผู้เข้าร่วมคนอื่นๆ นอกเหนือจากผู้จัดจะเชิญผู้อื่นมาเข้าร่วมกิจกรรมได้หรือไม่ ไม่บังคับ ค่าเริ่มต้นคือ True	เขียนได้
guestsCanModify	boolean	ผู้เข้าร่วมคนอื่นๆ นอกเหนือจากผู้จัดจะแก้ไขกิจกรรมได้หรือไม่ ไม่บังคับ ค่าเริ่มต้นคือ False	เขียนได้
guestsCanSeeOtherGuests	boolean	ผู้เข้าร่วมคนอื่นๆ นอกเหนือจากผู้จัดจะดูได้ไหมว่าใครเป็นผู้เข้าร่วมกิจกรรม ไม่บังคับ ค่าเริ่มต้นคือ True	เขียนได้
id	string	ตัวระบุเหตุการณ์แบบทึบ เมื่อสร้างกิจกรรมใหม่แบบครั้งเดียวหรือแบบเกิดซ้ำ คุณจะระบุรหัสของกิจกรรมได้ บัตรประจำตัวที่ส่งมาต้องเป็นไปตามกฎต่อไปนี้ อักขระที่อนุญาตในรหัสคืออักขระที่ใช้ในการเข้ารหัส base32hex ซึ่งได้แก่ ตัวอักษรพิมพ์เล็ก a-v และตัวเลข 0-9 ดูส่วนที่ 3.1.2 ใน RFC2938 ความยาวของรหัสต้องอยู่ระหว่าง 5 ถึง 1024 อักขระ รหัสต้องไม่ซ้ำกันต่อปฏิทิน เนื่องจากลักษณะการกระจายทั่วโลกของระบบ เราจึงไม่สามารถรับประกันได้ว่าจะตรวจพบการชนกันของรหัสในเวลาที่สร้างเหตุการณ์ เราขอแนะนำให้ใช้อัลกอริทึม UUID ที่เป็นที่ยอมรับ เช่น อัลกอริทึมที่อธิบายไว้ใน RFC4122 เพื่อลดความเสี่ยงของการชนกัน หากคุณไม่ได้ระบุรหัส เซิร์ฟเวอร์จะสร้างรหัสให้โดยอัตโนมัติ โปรดทราบว่า icalUID และ id ไม่เหมือนกัน และควรระบุเพียงรายการเดียวเมื่อสร้างเหตุการณ์ ความแตกต่างอย่างหนึ่งในเชิงความหมายคือในกิจกรรมที่เกิดซ้ำ เหตุการณ์ที่เกิดขึ้นทั้งหมดของกิจกรรมหนึ่งจะมี id ที่แตกต่างกัน แต่จะมี icalUID เดียวกัน	เขียนได้
location	string	สถานที่ตั้งทางภูมิศาสตร์ของกิจกรรมเป็นข้อความรูปแบบอิสระ ไม่บังคับ	เขียนได้
originalStartTime.date	date	วันที่ในรูปแบบ "ปปปป-ดด-วว" หากเป็นกิจกรรมตลอดวัน	เขียนได้
originalStartTime.dateTime	datetime	เวลาเป็นค่าวันที่และเวลารวม (จัดรูปแบบตาม RFC3339) ต้องระบุออฟเซ็ตเขตเวลา เว้นแต่จะระบุเขตเวลาอย่างชัดเจนใน timeZone	เขียนได้
originalStartTime.timeZone	string	เขตเวลาที่ระบุเวลา (จัดรูปแบบเป็นชื่อฐานข้อมูลเขตเวลาของ IANA เช่น "Europe/Zurich") สำหรับกิจกรรมที่เกิดซ้ำ ฟิลด์นี้จำเป็นและระบุเขตเวลาที่จะขยายการเกิดซ้ำ สำหรับกิจกรรมเดียว ฟิลด์นี้ไม่บังคับและระบุเขตเวลาที่กำหนดเองสำหรับเวลาเริ่มต้น/สิ้นสุดของกิจกรรม	เขียนได้
outOfOfficeProperties	nested object	ข้อมูลกิจกรรมลางาน ใช้ในกรณีที่ eventType เป็น outOfOffice	เขียนได้
recurrence[]	list	รายการบรรทัด RRULE, EXRULE, RDATE และ EXDATE สำหรับกิจกรรมที่เกิดซ้ำตามที่ระบุไว้ใน RFC5545 โปรดทราบว่าไม่อนุญาตให้ใช้บรรทัด DTSTART และ DTEND ในช่องนี้ โดยจะระบุเวลาเริ่มต้นและเวลาสิ้นสุดของกิจกรรมในช่อง start และ end ระบบจะละเว้นฟิลด์นี้สำหรับกิจกรรมเดียวหรืออินสแตนซ์ของกิจกรรมที่เกิดซ้ำ	เขียนได้
reminders.overrides[]	list	หากกิจกรรมไม่ได้ใช้การช่วยเตือนเริ่มต้น รายการนี้จะแสดงการช่วยเตือนที่เฉพาะเจาะจงสำหรับกิจกรรม หรือหากไม่ได้ตั้งค่าไว้ จะระบุว่าไม่มีการตั้งค่าการช่วยเตือนสำหรับกิจกรรมนี้ จำนวนการช่วยเตือนที่ลบล้างได้สูงสุดคือ 5 รายการ	เขียนได้
reminders.overrides[].method	string	วิธีการที่ใช้โดยการช่วยเตือนนี้ ค่าที่เป็นไปได้มีดังนี้ "email" - ระบบจะส่งการช่วยเตือนทางอีเมล "popup" - ระบบจะส่งการช่วยเตือนผ่านป๊อปอัป UI ต้องระบุเมื่อเพิ่มการช่วยเตือน	เขียนได้
reminders.overrides[].minutes	integer	จำนวนนาทีก่อนเริ่มกิจกรรมที่ควรมีการเรียกใช้การช่วยเตือน ค่าที่ใช้ได้คือตั้งแต่ 0 ถึง 40320 (4 สัปดาห์ในหน่วยนาที) ต้องระบุเมื่อเพิ่มการช่วยเตือน	เขียนได้
reminders.useDefault	boolean	ไม่ว่าการช่วยเตือนเริ่มต้นของปฏิทินจะมีผลกับกิจกรรมหรือไม่	เขียนได้
sequence	integer	หมายเลขลำดับตาม iCalendar	เขียนได้
source.title	string	ชื่อของแหล่งที่มา เช่น ชื่อหน้าเว็บหรือเรื่องของอีเมล	เขียนได้
source.url	string	URL ของแหล่งที่มาชี้ไปยังทรัพยากร รูปแบบ URL ต้องเป็น HTTP หรือ HTTPS	เขียนได้
start.date	date	วันที่ในรูปแบบ "ปปปป-ดด-วว" หากเป็นกิจกรรมตลอดวัน	เขียนได้
start.dateTime	datetime	เวลาเป็นค่าวันที่และเวลารวม (จัดรูปแบบตาม RFC3339) ต้องระบุออฟเซ็ตเขตเวลา เว้นแต่จะระบุเขตเวลาอย่างชัดเจนใน timeZone	เขียนได้
start.timeZone	string	เขตเวลาที่ระบุเวลา (จัดรูปแบบเป็นชื่อฐานข้อมูลเขตเวลาของ IANA เช่น "Europe/Zurich") สำหรับกิจกรรมที่เกิดซ้ำ ฟิลด์นี้จำเป็นและระบุเขตเวลาที่จะขยายการเกิดซ้ำ สำหรับกิจกรรมเดียว ฟิลด์นี้ไม่บังคับและระบุเขตเวลาที่กำหนดเองสำหรับเวลาเริ่มต้น/สิ้นสุดของกิจกรรม	เขียนได้
status	string	สถานะของกิจกรรม ไม่บังคับ ค่าที่เป็นไปได้มีดังนี้ "confirmed" - ยืนยันกิจกรรมแล้ว นี่คือสถานะเริ่มต้น "tentative" - ยืนยันกิจกรรมแล้ว "cancelled" - กิจกรรมถูกยกเลิก (ลบ) เมธอด list จะแสดงกิจกรรมที่ยกเลิกเฉพาะในการซิงค์แบบเพิ่ม (เมื่อระบุ syncToken หรือ updatedMin) หรือหากตั้งค่าแฟล็ก showDeleted เป็น true เมธอด get จะแสดงผลเสมอ สถานะ "ยกเลิก" แสดงถึง 2 สถานะที่แตกต่างกันโดยขึ้นอยู่กับประเภทกิจกรรม ดังนี้ ข้อยกเว้นที่ยกเลิกของกิจกรรมที่เกิดซ้ำซึ่งไม่ได้ยกเลิกบ่งชี้ว่าไม่ควรแสดงอินสแตนซ์นี้ต่อผู้ใช้อีกต่อไป ไคลเอ็นต์ควรจัดเก็บเหตุการณ์เหล่านี้ตลอดอายุการใช้งานของกิจกรรมที่เกิดซ้ำหลัก การยกเว้นที่ยกเลิกแล้วจะรับประกันได้ว่ามีค่าสำหรับช่อง id, recurringEventId และ originalStartTime ที่ป้อนข้อมูลไว้เท่านั้น ช่องอื่นๆ อาจว่างเปล่า ส่วนกิจกรรมอื่นๆ ที่ยกเลิกทั้งหมดหมายถึงกิจกรรมที่ถูกลบ ลูกค้าควรนำสำเนาที่ซิงค์ไว้ในเครื่องออก กิจกรรมที่ยกเลิกดังกล่าวจะหายไปในที่สุด ดังนั้นโปรดอย่าคิดว่ากิจกรรมจะพร้อมให้ใช้งานตลอดไป ระบบรับประกันว่าเหตุการณ์ที่ลบแล้วจะมีเฉพาะฟิลด์ id ที่มีข้อมูล ในปฏิทินของผู้จัด กิจกรรมที่ยกเลิกจะยังคงแสดงรายละเอียดกิจกรรม (สรุป สถานที่ ฯลฯ) เพื่อให้สามารถกู้คืน (เลิกการลบ) ได้ ในทำนองเดียวกัน กิจกรรมที่ผู้ใช้ได้รับเชิญและผู้ใช้ได้นำออกด้วยตนเองจะยังคงแสดงรายละเอียดต่อไป อย่างไรก็ตาม คำขอซิงค์แบบเพิ่มที่มี showDeleted ตั้งค่าเป็น false จะไม่แสดงรายละเอียดเหล่านี้ หากกิจกรรมเปลี่ยนผู้จัด (เช่น ผ่านการดำเนินการย้าย) และผู้จัดคนเดิมไม่ได้อยู่ในรายชื่อผู้เข้าร่วม ระบบจะทิ้งกิจกรรมที่ยกเลิกไว้ซึ่งรับประกันได้ว่าจะมีเฉพาะฟิลด์ id เท่านั้น	เขียนได้
summary	string	ชื่อกิจกรรม	เขียนได้
transparency	string	ไม่ว่ากิจกรรมจะบล็อกเวลาในปฏิทินหรือไม่ ไม่บังคับ ค่าที่เป็นไปได้มีดังนี้ "opaque" - ค่าเริ่มต้น กิจกรรมจะบล็อกเวลาในปฏิทิน ซึ่งเทียบเท่ากับการตั้งค่าแสดงสถานะของฉันเป็นไม่ว่างใน UI ของปฏิทิน "transparent" - กิจกรรมไม่ได้บล็อกเวลาในปฏิทิน ซึ่งเทียบเท่ากับการตั้งค่าแสดงสถานะของฉันเป็นว่างใน UI ของปฏิทิน	เขียนได้
visibility	string	ระดับการเข้าถึงของกิจกรรม ไม่บังคับ ค่าที่เป็นไปได้มีดังนี้ "default" - ใช้ระดับการเข้าถึงเริ่มต้นสำหรับกิจกรรมในปฏิทิน นี่คือค่าเริ่มต้น "public" - กิจกรรมเป็นแบบสาธารณะและผู้อ่านปฏิทินทุกคนจะเห็นรายละเอียดกิจกรรม "private" - กิจกรรมเป็นแบบส่วนตัวและมีเพียงผู้เข้าร่วมกิจกรรมเท่านั้นที่ดูรายละเอียดกิจกรรมได้ "confidential" - กิจกรรมเป็นแบบส่วนตัว ค่านี้มีไว้เพื่อเหตุผลด้านความเข้ากันได้	เขียนได้
workingLocationProperties	nested object	ข้อมูลเหตุการณ์สถานที่ทำงาน	เขียนได้
workingLocationProperties.customLocation	object	หากมีอยู่ จะระบุว่าผู้ใช้ทำงานจากสถานที่ที่กำหนดเอง	เขียนได้
workingLocationProperties.customLocation.label	string	ป้ายกำกับเพิ่มเติมที่ไม่บังคับสำหรับข้อมูลเพิ่มเติม	เขียนได้
workingLocationProperties.homeOffice	any value	หากมี ให้ระบุว่าผู้ใช้ทำงานที่บ้าน	เขียนได้
workingLocationProperties.officeLocation	object	หากมี จะระบุว่าผู้ใช้ทำงานจากสำนักงาน	เขียนได้
workingLocationProperties.officeLocation.buildingId	string	ตัวระบุอาคาร (ไม่บังคับ) ซึ่งควรอ้างอิงรหัสอาคารในฐานข้อมูลทรัพยากรขององค์กร	เขียนได้
workingLocationProperties.officeLocation.deskId	string	ตัวระบุโต๊ะ (ไม่บังคับ)	เขียนได้
workingLocationProperties.officeLocation.floorId	string	ตัวระบุชั้น (ไม่บังคับ)	เขียนได้
workingLocationProperties.officeLocation.floorSectionId	string	ตัวระบุส่วนของชั้น (ไม่บังคับ)	เขียนได้
workingLocationProperties.officeLocation.label	string	ชื่อสำนักงานที่แสดงในไคลเอ็นต์เว็บและอุปกรณ์เคลื่อนที่ของปฏิทิน เราขอแนะนำให้คุณอ้างอิงชื่ออาคารในฐานข้อมูลทรัพยากรขององค์กร	เขียนได้
workingLocationProperties.type	string	ประเภทสถานที่ทำงาน ค่าที่เป็นไปได้มีดังนี้ "homeOffice" - ผู้ใช้ทำงานที่บ้าน "officeLocation" - ผู้ใช้ทำงานจากออฟฟิศ "customLocation" - ผู้ใช้ทำงานจากสถานที่ที่กำหนดเอง รายละเอียดจะระบุไว้ในฟิลด์ย่อยของชื่อที่ระบุ แต่ฟิลด์นี้อาจไม่มีหากว่างเปล่า ระบบจะไม่สนใจฟิลด์อื่นๆ ต้องระบุเมื่อเพิ่มพร็อพเพอร์ตี้สถานที่ทำงาน	เขียนได้

การตอบกลับ

หากสำเร็จ เมธอดนี้จะแสดงทรัพยากรเหตุการณ์ในเนื้อหาการตอบกลับ

ลองใช้งาน

ใช้โปรแกรมสำรวจ API ด้านล่างเพื่อเรียกเมธอดนี้ในข้อมูลสดและดูการตอบกลับ