Calendar API มีทรัพยากรกิจกรรมหลากหลายประเภท ดูข้อมูลเพิ่มเติมได้ในเกี่ยวกับกิจกรรม
ดูรายการเมธอดสำหรับทรัพยากรนี้ได้ที่ส่วนท้ายของหน้านี้
การนำเสนอแหล่งข้อมูล
{ "kind": "calendar#event", "etag": etag, "id": string, "status": string, "htmlLink": string, "created": datetime, "updated": datetime, "summary": string, "description": string, "location": string, "colorId": string, "creator": { "id": string, "email": string, "displayName": string, "self": boolean }, "organizer": { "id": string, "email": string, "displayName": string, "self": boolean }, "start": { "date": date, "dateTime": datetime, "timeZone": string }, "end": { "date": date, "dateTime": datetime, "timeZone": string }, "endTimeUnspecified": boolean, "recurrence": [ string ], "recurringEventId": string, "originalStartTime": { "date": date, "dateTime": datetime, "timeZone": string }, "transparency": string, "visibility": string, "iCalUID": string, "sequence": integer, "attendees": [ { "id": string, "email": string, "displayName": string, "organizer": boolean, "self": boolean, "resource": boolean, "optional": boolean, "responseStatus": string, "comment": string, "additionalGuests": integer } ], "attendeesOmitted": boolean, "extendedProperties": { "private": { (key): string }, "shared": { (key): string } }, "hangoutLink": string, "conferenceData": { "createRequest": { "requestId": string, "conferenceSolutionKey": { "type": string }, "status": { "statusCode": string } }, "entryPoints": [ { "entryPointType": string, "uri": string, "label": string, "pin": string, "accessCode": string, "meetingCode": string, "passcode": string, "password": string } ], "conferenceSolution": { "key": { "type": string }, "name": string, "iconUri": string }, "conferenceId": string, "signature": string, "notes": string, }, "gadget": { "type": string, "title": string, "link": string, "iconLink": string, "width": integer, "height": integer, "display": string, "preferences": { (key): string } }, "anyoneCanAddSelf": boolean, "guestsCanInviteOthers": boolean, "guestsCanModify": boolean, "guestsCanSeeOtherGuests": boolean, "privateCopy": boolean, "locked": boolean, "reminders": { "useDefault": boolean, "overrides": [ { "method": string, "minutes": integer } ] }, "source": { "url": string, "title": string }, "workingLocationProperties": { "type": string, "homeOffice": (value), "customLocation": { "label": string }, "officeLocation": { "buildingId": string, "floorId": string, "floorSectionId": string, "deskId": string, "label": string } }, "outOfOfficeProperties": { "autoDeclineMode": string, "declineMessage": string }, "focusTimeProperties": { "autoDeclineMode": string, "declineMessage": string, "chatStatus": string }, "attachments": [ { "fileUrl": string, "title": string, "mimeType": string, "iconLink": string, "fileId": string } ], "eventType": string }
ชื่อพร็อพเพอร์ตี้ | ค่า | คำอธิบาย | หมายเหตุ |
---|---|---|---|
anyoneCanAddSelf |
boolean |
ทุกคนสามารถเชิญตัวเองให้เข้าร่วมกิจกรรมได้หรือไม่ (เลิกใช้งานแล้ว) ไม่บังคับ ค่าเริ่มต้นคือ False | เขียนได้ |
attachments[] |
list |
ไฟล์แนบสำหรับกิจกรรม หากต้องการแก้ไขไฟล์แนบ คุณควรตั้งค่าพารามิเตอร์คำขอ สามารถมีไฟล์แนบได้สูงสุด 25 ไฟล์ต่อกิจกรรม |
|
attachments[].fileId |
string |
รหัสของไฟล์แนบ อ่านอย่างเดียว สำหรับไฟล์ Google ไดรฟ์ นี่คือรหัสของรายการทรัพยากร |
|
attachments[].fileUrl |
string |
URL ที่ลิงก์ไปยังไฟล์แนบ หากต้องการเพิ่มไฟล์แนบของไฟล์ใน Google ไดรฟ์ ให้ใช้รูปแบบเดียวกับในพร็อพเพอร์ตี้ ต้องระบุเมื่อเพิ่มไฟล์แนบ |
เขียนได้ |
attachments[].iconLink |
string |
ลิงก์ URL ไปยังไอคอนไฟล์แนบ แก้ไขช่องนี้ได้สำหรับไฟล์แนบที่กำหนดเองของบุคคลที่สามเท่านั้น | |
attachments[].mimeType |
string |
ประเภทสื่ออินเทอร์เน็ต (ประเภท MIME) ของไฟล์แนบ | |
attachments[].title |
string |
ชื่อไฟล์แนบ | |
attendeesOmitted |
boolean |
ผู้เข้าร่วมอาจถูกละเว้นจากการเข้าร่วมกิจกรรมหรือไม่ เมื่อดึงข้อมูลเหตุการณ์ อาจเป็นเพราะข้อจํากัดที่ระบุโดยพารามิเตอร์การค้นหาของ maxAttendee เมื่ออัปเดตกิจกรรม การตั้งค่านี้สามารถใช้เพื่ออัปเดตเฉพาะคำตอบของผู้เข้าร่วมเท่านั้น ไม่บังคับ ค่าเริ่มต้นคือ False |
เขียนได้ |
attendees[] |
list |
ผู้เข้าร่วมกิจกรรม ดูคู่มือกิจกรรมกับผู้เข้าร่วมเพื่อดูข้อมูลเพิ่มเติมเกี่ยวกับการจัดกำหนดการกิจกรรมกับผู้ใช้ปฏิทินคนอื่นๆ บัญชีบริการต้องใช้การมอบสิทธิ์ทั่วทั้งโดเมนเพื่อเติมข้อมูลรายชื่อผู้เข้าร่วม | เขียนได้ |
attendees[].additionalGuests |
integer |
จำนวนแขกเพิ่มเติม ไม่บังคับ ค่าเริ่มต้นคือ 0 | เขียนได้ |
attendees[].comment |
string |
ความคิดเห็นตอบกลับของผู้เข้าร่วม ไม่บังคับ | เขียนได้ |
attendees[].displayName |
string |
ชื่อผู้เข้าร่วม (หากมี) ไม่บังคับ | เขียนได้ |
attendees[].email |
string |
อีเมลของผู้เข้าร่วม (หากมี) ต้องมีฟิลด์นี้เมื่อเพิ่มผู้เข้าร่วม ต้องเป็นอีเมลที่ถูกต้องตาม RFC5322 ต้องระบุเมื่อเพิ่มผู้เข้าร่วม |
เขียนได้ |
attendees[].id |
string |
รหัสโปรไฟล์ของผู้เข้าร่วม (หากมี) | |
attendees[].optional |
boolean |
ระบุว่าผู้เข้าร่วมรายนี้เป็นตัวเลือกหรือไม่ ไม่บังคับ ค่าเริ่มต้นคือ "เท็จ" | เขียนได้ |
attendees[].organizer |
boolean |
ผู้เข้าร่วมเป็นผู้จัดกิจกรรมหรือไม่ อ่านอย่างเดียว ค่าเริ่มต้นคือ "เท็จ" | |
attendees[].resource |
boolean |
ผู้เข้าร่วมมีทรัพยากรหรือไม่ ตั้งค่าได้เฉพาะเมื่อมีการเพิ่มผู้เข้าร่วมในกิจกรรมเป็นครั้งแรก ระบบจะไม่สนใจการแก้ไขหลังจากนั้น ไม่บังคับ ค่าเริ่มต้นคือ "เท็จ" | เขียนได้ |
attendees[].responseStatus |
string |
สถานะการตอบกลับของผู้เข้าร่วม ค่าที่เป็นไปได้คือ
|
เขียนได้ |
attendees[].self |
boolean |
รายการนี้แสดงปฏิทินที่มีสำเนาของกิจกรรมนี้หรือไม่ อ่านอย่างเดียว ค่าเริ่มต้นคือ "เท็จ" | |
colorId |
string |
สีของกิจกรรม นี่คือรหัสที่อ้างอิงถึงรายการในส่วน event ของคำจำกัดความสี (ดู จุดสิ้นสุดของสี) ไม่บังคับ |
เขียนได้ |
conferenceData |
nested object |
ข้อมูลที่เกี่ยวข้องกับการประชุม เช่น รายละเอียดการประชุมใน Google Meet หากต้องการสร้างรายละเอียดการประชุมใหม่ ให้ใช้ช่อง createRequest อย่าลืมตั้งค่าพารามิเตอร์คำขอ conferenceDataVersion เป็น 1 สำหรับคำขอแก้ไขเหตุการณ์ทั้งหมดเพื่อยืนยันการเปลี่ยนแปลง |
เขียนได้ |
conferenceData.conferenceId |
string |
รหัสของการประชุม นักพัฒนาซอฟต์แวร์สามารถใช้เพื่อติดตามการประชุม และไม่ควรแสดงต่อผู้ใช้ ค่ารหัสจะอยู่ในรูปแบบที่แตกต่างกันสำหรับโซลูชันการประชุมแต่ละประเภท ดังนี้
|
|
conferenceData.conferenceSolution |
nested object |
โซลูชันการประชุม เช่น Google Meet ยกเลิกการตั้งค่าสำหรับการประชุมที่มีคำขอสร้างไม่สำเร็จ ต้องระบุ |
|
conferenceData.conferenceSolution.iconUri |
string |
ไอคอนที่ผู้ใช้มองเห็นได้สำหรับโซลูชันนี้ | |
conferenceData.conferenceSolution.key |
nested object |
คีย์ที่สามารถระบุโซลูชันการประชุมสำหรับกิจกรรมนี้ได้อย่างแน่ชัด | |
conferenceData.conferenceSolution.key.type |
string |
ประเภทโซลูชันการประชุม หากไคลเอ็นต์พบประเภทที่ไม่คุ้นเคยหรือว่างเปล่า ไคลเอ็นต์ควรแสดงจุดเข้าให้ได้ แต่จะไม่อนุญาตให้แก้ไข ค่าที่เป็นไปได้มีดังนี้
|
|
conferenceData.conferenceSolution.name |
string |
ชื่อที่ผู้ใช้มองเห็นได้ของโซลูชันนี้ ไม่ได้แปล | |
conferenceData.createRequest |
nested object |
คำขอสร้างการประชุมใหม่และแนบไปกับกิจกรรม ระบบจะสร้างข้อมูลไม่พร้อมกัน หากต้องการดูว่ามีข้อมูลอยู่ไหม ให้ตรวจสอบที่ช่อง status ต้องระบุ |
|
conferenceData.createRequest.conferenceSolutionKey |
nested object |
โซลูชันการประชุม เช่น Hangouts หรือ Google Meet | |
conferenceData.createRequest.conferenceSolutionKey.type |
string |
ประเภทโซลูชันการประชุม หากไคลเอ็นต์พบประเภทที่ไม่คุ้นเคยหรือว่างเปล่า ไคลเอ็นต์ควรแสดงจุดเข้าให้ได้ แต่จะไม่อนุญาตให้แก้ไข ค่าที่เป็นไปได้มีดังนี้
|
|
conferenceData.createRequest.requestId |
string |
รหัสที่ไม่ซ้ำกันที่ไคลเอ็นต์สร้างขึ้นสำหรับคำขอนี้ ลูกค้าควรสร้างรหัสนี้ใหม่สำหรับคำขอใหม่ทุกรายการ หากรหัสที่ระบุตรงกับรหัสสำหรับคำขอก่อนหน้า ระบบจะไม่สนใจคำขอ |
|
conferenceData.createRequest.status |
nested object |
สถานะคำขอสร้างการประชุม | |
conferenceData.createRequest.status.statusCode |
string |
สถานะปัจจุบันของคำขอสร้างการประชุม อ่านอย่างเดียว ค่าที่เป็นไปได้มีดังนี้
|
|
conferenceData.entryPoints[] |
list |
ข้อมูลเกี่ยวกับจุดแรกเข้าของการประชุมแต่ละรายการ เช่น URL หรือหมายเลขโทรศัพท์ ทุกคนต้องอยู่ในการประชุมเดียวกัน ต้องระบุ |
|
conferenceData.entryPoints[].accessCode |
string |
รหัสเข้าถึงเพื่อเข้าร่วมการประชุม มีความยาวได้สูงสุดไม่เกิน 128 อักขระ เมื่อสร้างข้อมูลการประชุมใหม่ ให้ป้อนข้อมูลเฉพาะชุดย่อยของ { ไม่บังคับ |
|
conferenceData.entryPoints[].entryPointType |
string |
ประเภทของจุดแรกเข้าการประชุม โดยค่าที่เป็นไปได้มีดังนี้
|
|
conferenceData.entryPoints[].label |
string |
ป้ายกํากับสําหรับ URI ผู้ใช้ปลายทางมองเห็นได้ ไม่ได้แปล ความยาวสูงสุด 512 อักขระ ตัวอย่าง
ไม่บังคับ |
|
conferenceData.entryPoints[].meetingCode |
string |
รหัสการประชุมสำหรับเข้าถึงการประชุม มีความยาวได้สูงสุดไม่เกิน 128 อักขระ เมื่อสร้างข้อมูลการประชุมใหม่ ให้ป้อนข้อมูลเฉพาะชุดย่อยของ { ไม่บังคับ |
|
conferenceData.entryPoints[].passcode |
string |
รหัสผ่านในการเข้าถึงการประชุม มีความยาวได้สูงสุดไม่เกิน 128 อักขระ เมื่อสร้างข้อมูลการประชุมใหม่ ให้ป้อนข้อมูลเฉพาะชุดย่อยของ { |
|
conferenceData.entryPoints[].password |
string |
รหัสผ่านเพื่อเข้าถึงการประชุม มีความยาวได้สูงสุดไม่เกิน 128 อักขระ เมื่อสร้างข้อมูลการประชุมใหม่ ให้ป้อนข้อมูลเฉพาะชุดย่อยของ { ไม่บังคับ |
|
conferenceData.entryPoints[].pin |
string |
PIN สำหรับเข้าถึงการประชุม มีความยาวได้สูงสุดไม่เกิน 128 อักขระ เมื่อสร้างข้อมูลการประชุมใหม่ ให้ป้อนข้อมูลเฉพาะชุดย่อยของ { ไม่บังคับ |
|
conferenceData.entryPoints[].uri |
string |
URI ของจุดแรกเข้า มีความยาวได้สูงสุดไม่เกิน 1,300 อักขระ รูปแบบ:
|
|
conferenceData.notes |
string |
หมายเหตุเพิ่มเติม (เช่น คำแนะนำจากผู้ดูแลระบบโดเมน ประกาศทางกฎหมาย) ที่จะแสดงต่อผู้ใช้ มี HTML ได้ โดยมีความยาวสูงสุดได้ 2,048 อักขระ ไม่บังคับ | |
conferenceData.signature |
string |
ลายเซ็นของข้อมูลการประชุม สร้างขึ้นในฝั่งเซิร์ฟเวอร์ ยกเลิกการตั้งค่าสำหรับการประชุมที่มีคำขอสร้างไม่สำเร็จ ตัวเลือกสำหรับการประชุมที่มีคำขอสร้างที่รอดำเนินการ |
|
created |
datetime |
เวลาที่สร้างเหตุการณ์ (เป็นการประทับเวลา RFC3339) อ่านอย่างเดียว | |
creator |
object |
ผู้สร้างกิจกรรม อ่านอย่างเดียว | |
creator.displayName |
string |
ชื่อครีเอเตอร์ (หากมี) | |
creator.email |
string |
อีเมลของครีเอเตอร์ (หากมี) | |
creator.id |
string |
รหัสโปรไฟล์ของครีเอเตอร์ (หากมี) | |
creator.self |
boolean |
ผู้สร้างสอดคล้องกับปฏิทินที่มีสำเนากิจกรรมนี้ปรากฏอยู่หรือไม่ อ่านอย่างเดียว ค่าเริ่มต้นคือ "เท็จ" | |
description |
string |
คำอธิบายกิจกรรม มี HTML ได้ ไม่บังคับ | เขียนได้ |
end |
nested object |
เวลาสิ้นสุด (ไม่รวม) ของกิจกรรม สำหรับกิจกรรมที่เกิดซ้ำ นี่คือเวลาสิ้นสุดของอินสแตนซ์แรก | |
end.date |
date |
วันที่ในรูปแบบ "yyyy-mm-dd" หากเป็นกิจกรรมตลอดวัน | เขียนได้ |
end.dateTime |
datetime |
เวลาที่เป็นค่าวันที่และเวลาแบบรวม (จัดรูปแบบตาม RFC3339) ต้องมีการชดเชยเขตเวลาเว้นแต่มีการระบุเขตเวลาอย่างชัดเจนใน timeZone |
เขียนได้ |
end.timeZone |
string |
เขตเวลาที่ระบุเวลา (จัดรูปแบบเป็นชื่อฐานข้อมูลเขตเวลาของ IANA เช่น "ยุโรป/ซูริค") สำหรับกิจกรรมที่เกิดซ้ำ ให้กรอกข้อมูลในช่องนี้และระบุเขตเวลาที่จะขยายการเกิดซ้ำ สำหรับกิจกรรมเดียว ฟิลด์นี้จะใส่หรือไม่ก็ได้ และจะระบุเขตเวลาที่กำหนดเองสำหรับเวลาเริ่มต้น/สิ้นสุดของกิจกรรม | เขียนได้ |
endTimeUnspecified |
boolean |
ไม่ได้ระบุเวลาสิ้นสุดจริงหรือไม่ ระบบจะยังคงระบุเวลาสิ้นสุดไว้เพื่อเหตุผลด้านความเข้ากันได้ แม้ว่าจะตั้งค่าแอตทริบิวต์นี้เป็น "จริง" ก็ตาม ค่าเริ่มต้นคือ False | |
etag |
etag |
ETag ของทรัพยากร | |
eventType |
string |
ประเภทที่เฉพาะเจาะจงของกิจกรรม คุณจะแก้ไขส่วนนี้หลังจากที่สร้างกิจกรรมแล้วไม่ได้ ค่าที่เป็นไปได้คือ
|
เขียนได้ |
extendedProperties |
object |
พร็อพเพอร์ตี้เพิ่มเติมของเหตุการณ์ | |
extendedProperties.private |
object |
พร็อพเพอร์ตี้ที่เป็นส่วนตัวสำหรับสำเนาของกิจกรรมที่ปรากฏในปฏิทินนี้ | เขียนได้ |
extendedProperties.private.(key) |
string |
ชื่อของพร็อพเพอร์ตี้ส่วนตัวและค่าที่เกี่ยวข้อง | |
extendedProperties.shared |
object |
พร็อพเพอร์ตี้ที่แชร์ระหว่างสำเนากิจกรรมของผู้เข้าร่วมคนอื่น ปฏิทิน | เขียนได้ |
extendedProperties.shared.(key) |
string |
ชื่อของพร็อพเพอร์ตี้ที่แชร์และค่าที่เกี่ยวข้อง | |
focusTimeProperties |
nested object |
ข้อมูลกิจกรรมที่ต้องการสมาธิ ใช้เมื่อ eventType คือ focusTime |
เขียนได้ |
focusTimeProperties.autoDeclineMode |
string |
เลือกว่าจะปฏิเสธคำเชิญเข้าร่วมการประชุมซึ่งทับซ้อนกับกิจกรรมที่ต้องการสมาธิหรือไม่ ค่าที่ถูกต้องคือ declineNone ซึ่งหมายความว่าไม่มีการปฏิเสธคำเชิญเข้าร่วมการประชุม declineAllConflictingInvitations ซึ่งหมายความว่าคำเชิญเข้าร่วมประชุมที่ขัดแย้งทั้งหมดซึ่งขัดแย้งกับกิจกรรมจะถูกปฏิเสธ และ declineOnlyNewConflictingInvitations ซึ่งหมายความว่าระบบจะปฏิเสธเฉพาะคำเชิญเข้าร่วมการประชุมใหม่ที่ขัดแย้งกันซึ่งมาถึงขณะที่มีกิจกรรมที่ต้องการสมาธิเท่านั้น |
|
focusTimeProperties.chatStatus |
string |
สถานะที่ทำเครื่องหมายผู้ใช้ใน Chat และผลิตภัณฑ์ที่เกี่ยวข้อง ซึ่งอาจเป็น available หรือ doNotDisturb |
|
focusTimeProperties.declineMessage |
string |
ข้อความตอบกลับเพื่อตั้งค่าในกรณีที่ปฏิทินปฏิเสธกิจกรรมที่มีอยู่หรือคำเชิญใหม่โดยอัตโนมัติ | |
gadget |
object |
แกดเจ็ตที่ขยายเหตุการณ์นี้ แกดเจ็ตถูกเลิกใช้งานแล้ว แต่จะใช้โครงสร้างนี้สำหรับการส่งคืนข้อมูลเมตาของปฏิทินวันเกิดเท่านั้น | |
gadget.display |
string |
โหมดการแสดงผลของแกดเจ็ต เลิกใช้งานแล้ว ค่าที่เป็นไปได้คือ
|
เขียนได้ |
gadget.height |
integer |
ความสูงของแกดเจ็ต หน่วยเป็นพิกเซล ความสูงต้องเป็นจำนวนเต็มที่มากกว่า 0 ไม่บังคับ เลิกใช้งานแล้ว | เขียนได้ |
gadget.iconLink |
string |
URL ไอคอนของแกดเจ็ต Scheme ของ URL ต้องเป็น HTTPS เลิกใช้งานแล้ว | เขียนได้ |
gadget.link |
string |
URL ของแกดเจ็ต Scheme ของ URL ต้องเป็น HTTPS เลิกใช้งานแล้ว | เขียนได้ |
gadget.preferences |
object |
ค่ากำหนด | เขียนได้ |
gadget.preferences.(key) |
string |
ชื่อค่ากำหนดและค่าที่เกี่ยวข้อง | |
gadget.title |
string |
ชื่อแกดเจ็ต เลิกใช้งานแล้ว | เขียนได้ |
gadget.type |
string |
ประเภทของแกดเจ็ต เลิกใช้งานแล้ว | เขียนได้ |
gadget.width |
integer |
ความกว้างของแกดเจ็ตเป็นพิกเซล ความกว้างต้องเป็นจำนวนเต็มที่มากกว่า 0 ไม่บังคับ เลิกใช้งานแล้ว | เขียนได้ |
guestsCanInviteOthers |
boolean |
ผู้เข้าร่วมที่ไม่ใช่ผู้จัดสามารถเชิญบุคคลอื่นเข้าร่วมกิจกรรมได้หรือไม่ ไม่บังคับ ค่าเริ่มต้นคือ True | เขียนได้ |
guestsCanModify |
boolean |
ผู้เข้าร่วมที่ไม่ใช่ผู้จัดจะแก้ไขกิจกรรมได้หรือไม่ ไม่บังคับ ค่าเริ่มต้นคือ "เท็จ" | เขียนได้ |
guestsCanSeeOtherGuests |
boolean |
ผู้เข้าร่วมที่ไม่ใช่ผู้จัดกิจกรรมสามารถดูว่ามีใครมาเข้าร่วมได้บ้าง ไม่บังคับ ค่าเริ่มต้นคือ True | เขียนได้ |
hangoutLink |
string |
ลิงก์สัมบูรณ์ไปยัง Google Hangout ที่เชื่อมโยงกับกิจกรรมนี้ อ่านอย่างเดียว | |
htmlLink |
string |
ลิงก์แบบสัมบูรณ์ไปยังกิจกรรมนี้ใน UI บนเว็บของ Google ปฏิทิน อ่านอย่างเดียว | |
iCalUID |
string |
ตัวระบุที่ไม่ซ้ำกันของเหตุการณ์ตามที่ระบุไว้ใน RFC5545 พารามิเตอร์นี้ใช้เพื่อระบุกิจกรรมในระบบปฏิทินโดยไม่ซ้ำกัน และต้องระบุเมื่อนำเข้าเหตุการณ์ผ่านเมธอด import โปรดทราบว่า |
|
id |
string |
ตัวระบุแบบทึบแสงของเหตุการณ์ เมื่อสร้างกิจกรรมซิงเกิลหรือกิจกรรมที่เกิดซ้ำใหม่ คุณจะระบุรหัสได้ รหัสที่ระบุต้องเป็นไปตามกฎต่อไปนี้
หากคุณไม่ระบุรหัส เซิร์ฟเวอร์จะสร้างรหัสให้โดยอัตโนมัติ โปรดทราบว่า |
เขียนได้ |
kind |
string |
ประเภททรัพยากร ("calendar#event ") |
|
location |
string |
สถานที่ตั้งทางภูมิศาสตร์ของกิจกรรมโดยเป็นข้อความรูปแบบอิสระ ไม่บังคับ | เขียนได้ |
locked |
boolean |
ระบุว่านี่คือสําเนาเหตุการณ์ที่ล็อกไว้ซึ่งทำการเปลี่ยนแปลงในช่องเหตุการณ์หลักไม่ได้ ซึ่งได้แก่ "summary", "description", "location", "start", "end" หรือ "การเกิดซ้ำ" ค่าเริ่มต้นคือ "เท็จ" อ่านอย่างเดียว | |
organizer |
object |
ผู้จัดกิจกรรม หากผู้จัดเป็นผู้เข้าร่วมด้วย ระบบจะแสดงรายการแยกต่างหากใน attendees โดยตั้งค่าช่อง organizer เป็น "จริง" หากต้องการเปลี่ยนตัวจัดระเบียบ ให้ใช้การดำเนินการย้าย อ่านอย่างเดียว ยกเว้นเมื่อนำเข้ากิจกรรม |
เขียนได้ |
organizer.displayName |
string |
ชื่อผู้จัด (หากมี) | เขียนได้ |
organizer.email |
string |
อีเมลของผู้จัด (หากมี) ต้องเป็นอีเมลที่ถูกต้องตาม RFC5322 | เขียนได้ |
organizer.id |
string |
รหัสโปรไฟล์ของผู้จัด (หากมี) | |
organizer.self |
boolean |
ผู้จัดจะตรงกับปฏิทินที่มีสำเนาของกิจกรรมนี้หรือไม่ อ่านอย่างเดียว ค่าเริ่มต้นคือ "เท็จ" | |
originalStartTime |
nested object |
สำหรับอินสแตนซ์ของกิจกรรมที่เกิดซ้ำ นี่คือเวลาที่กิจกรรมนี้จะเริ่มต้นตามข้อมูลการเกิดซ้ำในกิจกรรมที่เกิดซ้ำซึ่งระบุโดย AttributionEventId ซึ่งจะระบุอินสแตนซ์ในชุดกิจกรรมที่เกิดซ้ำโดยไม่ซ้ำกัน แม้ว่าอินสแตนซ์จะย้ายไปยังเวลาอื่นก็ตาม เปลี่ยนแปลงไม่ได้ | |
originalStartTime.date |
date |
วันที่ในรูปแบบ "yyyy-mm-dd" หากเป็นกิจกรรมตลอดทั้งวัน | เขียนได้ |
originalStartTime.dateTime |
datetime |
เวลาที่เป็นค่าวันที่และเวลาแบบรวม (จัดรูปแบบตาม RFC3339) ต้องระบุเขตเวลาออฟเซ็ต เว้นแต่จะมีการระบุเขตเวลาอย่างชัดเจนใน timeZone |
เขียนได้ |
originalStartTime.timeZone |
string |
เขตเวลาที่ระบุเวลา (จัดรูปแบบเป็นชื่อฐานข้อมูลเขตเวลาของ IANA เช่น "ยุโรป/ซูริค") สำหรับกิจกรรมที่เกิดซ้ำ ให้กรอกข้อมูลในช่องนี้และระบุเขตเวลาที่จะขยายการเกิดซ้ำ สำหรับกิจกรรมเดียว ฟิลด์นี้จะใส่หรือไม่ก็ได้ และจะระบุเขตเวลาที่กำหนดเองสำหรับเวลาเริ่มต้น/สิ้นสุดของกิจกรรม | เขียนได้ |
outOfOfficeProperties |
nested object |
ข้อมูลกิจกรรมลางาน ใช้เมื่อ eventType คือ outOfOffice |
เขียนได้ |
outOfOfficeProperties.autoDeclineMode |
string |
เลือกว่าจะปฏิเสธคำเชิญเข้าร่วมการประชุมที่ซ้อนทับกับกิจกรรมลางานหรือไม่ ค่าที่ถูกต้องคือ declineNone ซึ่งหมายความว่าไม่มีการปฏิเสธคำเชิญเข้าร่วมการประชุม declineAllConflictingInvitations ซึ่งหมายความว่าคำเชิญเข้าร่วมประชุมที่ขัดแย้งทั้งหมดซึ่งขัดแย้งกับกิจกรรมจะถูกปฏิเสธ และ declineOnlyNewConflictingInvitations ซึ่งหมายความว่าระบบจะปฏิเสธเฉพาะคำเชิญเข้าร่วมการประชุมใหม่ที่ขัดแย้งกันซึ่งมาถึงในขณะที่กิจกรรมลางานเท่านั้น |
|
outOfOfficeProperties.declineMessage |
string |
ข้อความตอบกลับที่กำหนดว่าปฏิทินจะปฏิเสธกิจกรรมที่มีอยู่หรือคำเชิญใหม่โดยอัตโนมัติ | |
privateCopy |
boolean |
หากตั้งค่าเป็น "จริง" ระบบจะปิดใช้การเผยแพร่เหตุการณ์ โปรดทราบว่าไม่เหมือนกับพร็อพเพอร์ตี้เหตุการณ์ส่วนตัว ไม่บังคับ เปลี่ยนแปลงไม่ได้ ค่าเริ่มต้นคือ "เท็จ" | |
recurrence[] |
list |
รายการบรรทัด RRULE, EXRULE, RDATE และ EXDATE สำหรับกิจกรรมที่เกิดซ้ำ ตามที่ระบุไว้ใน RFC5545 โปรดทราบว่าไม่อนุญาตให้ใช้บรรทัด DTSTART และ DTEND ในช่องนี้ เวลาเริ่มต้นและสิ้นสุดของกิจกรรมจะระบุในช่อง start และ end เว้นช่องนี้ไว้สำหรับกิจกรรมรายการเดียวหรือกิจกรรมที่เกิดซ้ำ |
เขียนได้ |
recurringEventId |
string |
สำหรับอินสแตนซ์ของกิจกรรมที่เกิดซ้ำ นี่คือ id ของกิจกรรมที่เกิดซ้ำที่มีอินสแตนซ์นี้อยู่ เปลี่ยนแปลงไม่ได้ |
|
reminders |
object |
ข้อมูลเกี่ยวกับการช่วยเตือนของกิจกรรมสำหรับผู้ใช้ที่ตรวจสอบสิทธิ์แล้ว โปรดทราบว่าการเปลี่ยนการช่วยเตือนจะไม่เปลี่ยนพร็อพเพอร์ตี้ updated ของกิจกรรมที่เชื่อมโยงด้วย |
|
reminders.overrides[] |
list |
ถ้ากิจกรรมไม่ได้ใช้การแจ้งเตือนเริ่มต้น ระบบจะแสดงการแจ้งเตือนสำหรับกิจกรรมนั้นโดยเฉพาะ หรือหากไม่ได้ตั้งค่าไว้ แสดงว่าไม่มีการตั้งค่าการแจ้งเตือนสำหรับกิจกรรมนี้ จำนวนการช่วยเตือนการลบล้างสูงสุดคือ 5 รายการ | เขียนได้ |
reminders.overrides[].method |
string |
วิธีการที่การช่วยเตือนนี้ใช้ ค่าที่เป็นไปได้คือ
ต้องระบุเมื่อเพิ่มการช่วยเตือน |
เขียนได้ |
reminders.overrides[].minutes |
integer |
จำนวนนาทีก่อนเริ่มกิจกรรมซึ่งระบบควรเรียกใช้การช่วยเตือน ค่าที่ใช้ได้อยู่ระหว่าง 0 ถึง 40320 (4 สัปดาห์เป็นนาที) ต้องระบุเมื่อเพิ่มการช่วยเตือน |
เขียนได้ |
reminders.useDefault |
boolean |
การแจ้งเตือนเริ่มต้นของปฏิทินมีผลกับกิจกรรมหรือไม่ | เขียนได้ |
sequence |
integer |
หมายเลขลำดับตาม iปฏิทิน | เขียนได้ |
source |
object |
แหล่งที่มาที่สร้างกิจกรรม เช่น หน้าเว็บ ข้อความอีเมล หรือเอกสารที่ระบุได้ด้วย URL ซึ่งมีรูปแบบ HTTP หรือ HTTPS เฉพาะผู้สร้างกิจกรรมเท่านั้นที่จะดูหรือแก้ไขได้ | |
source.title |
string |
ชื่อแหล่งที่มา เช่น ชื่อของหน้าเว็บหรือเรื่องอีเมล | เขียนได้ |
source.url |
string |
URL ของแหล่งที่มาที่ชี้ไปยังทรัพยากร Scheme ของ URL ต้องเป็น HTTP หรือ HTTPS | เขียนได้ |
start |
nested object |
เวลาเริ่มต้น (รวม) ของกิจกรรม สำหรับกิจกรรมที่เกิดซ้ำ นี่คือเวลาเริ่มต้นของอินสแตนซ์แรก | |
start.date |
date |
วันที่ในรูปแบบ "yyyy-mm-dd" หากเป็นกิจกรรมตลอดทั้งวัน | เขียนได้ |
start.dateTime |
datetime |
เวลาที่เป็นค่าวันที่และเวลาแบบรวม (จัดรูปแบบตาม RFC3339) ต้องมีการชดเชยเขตเวลาเว้นแต่มีการระบุเขตเวลาอย่างชัดเจนใน timeZone |
เขียนได้ |
start.timeZone |
string |
เขตเวลาที่ระบุเวลา (จัดรูปแบบเป็นชื่อฐานข้อมูลเขตเวลาของ IANA เช่น "ยุโรป/ซูริค") สำหรับกิจกรรมที่เกิดซ้ำ ให้กรอกข้อมูลในช่องนี้และระบุเขตเวลาที่จะขยายการเกิดซ้ำ สำหรับกิจกรรมเดียว ฟิลด์นี้จะใส่หรือไม่ก็ได้ และจะระบุเขตเวลาที่กำหนดเองสำหรับเวลาเริ่มต้น/สิ้นสุดของกิจกรรม | เขียนได้ |
status |
string |
สถานะของกิจกรรม ไม่บังคับ ค่าที่เป็นไปได้คือ
|
เขียนได้ |
summary |
string |
ชื่อกิจกรรม | เขียนได้ |
transparency |
string |
กิจกรรมบล็อกเวลาในปฏิทินหรือไม่ ไม่บังคับ ค่าที่เป็นไปได้คือ
|
เขียนได้ |
updated |
datetime |
เวลาที่แก้ไขล่าสุดของข้อมูลเหตุการณ์หลัก (เป็นการประทับเวลา RFC3339) การอัปเดตการช่วยเตือนกิจกรรมจะไม่ทำให้ข้อมูลนี้เปลี่ยนแปลง อ่านอย่างเดียว | |
visibility |
string |
ระดับการเข้าถึงกิจกรรม ไม่บังคับ ค่าที่เป็นไปได้คือ
|
เขียนได้ |
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 |
ประเภทสถานที่ทํางาน ค่าที่เป็นไปได้มีดังนี้
ต้องระบุเมื่อเพิ่มพร็อพเพอร์ตี้สถานที่ทำงาน |
เขียนได้ |
เมธอด
- ลบ
- ลบกิจกรรม
- รับ
- ส่งคืนกิจกรรมตามรหัส Google ปฏิทิน หากต้องการดึงกิจกรรมโดยใช้รหัส iปฏิทิน ให้เรียกใช้เมธอดevents.list โดยใช้พารามิเตอร์
iCalUID
- import
- นำเข้ากิจกรรม การทำงานนี้ใช้เพื่อเพิ่มสำเนาส่วนตัวของกิจกรรมที่มีอยู่ลงในปฏิทิน นำเข้าได้เฉพาะเหตุการณ์ที่มี
eventType
เป็นdefault
เท่านั้นลักษณะการทำงานที่เลิกใช้งานแล้ว: หากเป็นเหตุการณ์ที่ไม่ใช่
default
ระบบจะเปลี่ยนประเภทเหตุการณ์เป็นdefault
และยกเลิกพร็อพเพอร์ตี้ที่เจาะจงประเภทเหตุการณ์ของเหตุการณ์ดังกล่าว - แทรก
- สร้างกิจกรรม
- instances
- ส่งกลับอินสแตนซ์ของกิจกรรมที่เกิดซ้ำที่ระบุ
- list
- แสดงผลกิจกรรมในปฏิทินที่ระบุ
- ย้าย
- ย้ายกิจกรรมไปยังปฏิทินอื่น เช่น เปลี่ยนผู้จัดกิจกรรม โปรดทราบว่าย้ายได้เพียง
default
กิจกรรมเท่านั้น ไม่สามารถย้ายbirthday
,focusTime
,fromGmail
,outOfOffice
และworkingLocation
ได้ - แพตช์
- อัปเดตกิจกรรม วิธีนี้รองรับความหมายของแพตช์ โปรดทราบว่าคำขอแพตช์แต่ละรายการจะใช้หน่วยโควต้า 3 หน่วย ต้องการใช้
get
ตามด้วยupdate
ค่าของช่องที่คุณระบุจะแทนที่ค่าที่มีอยู่ ช่องที่คุณไม่ได้ระบุไว้ในคำขอจะยังคงไม่มีการเปลี่ยนแปลง ช่องอาร์เรย์ (หากระบุไว้) จะเขียนทับอาร์เรย์ที่มีอยู่ การดำเนินการนี้จะทิ้งอีลิเมนต์ของอาร์เรย์ก่อนหน้า - quickAdd
- สร้างเหตุการณ์ตามสตริงข้อความธรรมดา
- อัปเดต
- อัปเดตกิจกรรม วิธีนี้ไม่รองรับความหมายของแพตช์และอัปเดตทรัพยากรเหตุการณ์ทั้งหมดเสมอ หากต้องการอัปเดตบางส่วน ให้ทำ
get
ตามด้วยupdate
โดยใช้ eBook เพื่อให้แน่ใจว่ามีสัดส่วน - นาฬิกาข้อมือ
- คอยดูการเปลี่ยนแปลงในทรัพยากรของกิจกรรม