Events: update

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

ส่งคำขอ

คำขอ HTTP

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

พารามิเตอร์

ชื่อพารามิเตอร์ ค่า คำอธิบาย
พารามิเตอร์เส้นทาง
calendarId string ตัวระบุปฏิทิน หากต้องการเรียกข้อมูลรหัสปฏิทิน ให้เรียกใช้เมธอด calendarList.list หากต้องการเข้าถึงปฏิทินหลักของผู้ใช้ที่เข้าสู่ระบบอยู่ ให้ใช้คีย์เวิร์ด "primary"
eventId string ตัวระบุเหตุการณ์
พารามิเตอร์การค้นหาที่ไม่บังคับ
alwaysIncludeEmail boolean เลิกใช้งานแล้วและละเว้น ระบบจะแสดงค่าสำหรับผู้จัด ครีเอเตอร์ และผู้เข้าร่วมในช่อง email เสมอ แม้ว่าจะไม่มีอีเมลจริงให้ใช้งาน (เช่น ระบบจะระบุค่าที่สร้างขึ้นและใช้งานไม่ได้)
conferenceDataVersion integer หมายเลขเวอร์ชันของข้อมูลการประชุมที่ไคลเอ็นต์ API รองรับ เวอร์ชัน 0 ถือว่าไม่มีการรองรับข้อมูลการประชุมและไม่สนใจข้อมูลการประชุมในส่วนเนื้อหาของเหตุการณ์ เวอร์ชัน 1 ช่วยให้สามารถคัดลอก ConferenceData และจะสร้างการประชุมใหม่โดยใช้ช่อง createRequest ของ ConferenceData ค่าเริ่มต้นคือ 0 ค่าที่ยอมรับคือ 0 ถึง 1
maxAttendees integer จำนวนผู้เข้าร่วมสูงสุดที่จะรวมไว้ในคำตอบ หากมีผู้เข้าร่วมมากกว่าจำนวนที่ระบุ ระบบจะส่งคืนเฉพาะผู้เข้าร่วมเท่านั้น ไม่บังคับ
sendNotifications boolean เลิกใช้งานแล้ว โปรดใช้ sendUpdates แทน

ว่าจะส่งการแจ้งเตือนเกี่ยวกับการอัปเดตกิจกรรม (เช่น การเปลี่ยนแปลงคำอธิบาย ฯลฯ) หรือไม่ โปรดทราบว่าระบบอาจยังส่งอีเมลบางรายการอยู่ แม้ว่าคุณจะกำหนดค่าเป็น false ก็ตาม โดยมีค่าเริ่มต้นเป็น false
sendUpdates string ผู้เข้าร่วมที่ควรได้รับการแจ้งเตือนเกี่ยวกับการอัปเดตกิจกรรม (เช่น การเปลี่ยนชื่อ ฯลฯ)

ค่าที่ยอมรับมีดังนี้
  • "all": ส่งการแจ้งเตือนไปยังผู้เข้าร่วมทุกคน
  • "externalOnly": การแจ้งเตือนจะส่งไปยังผู้เข้าร่วมที่ไม่ได้ใช้ Google ปฏิทินเท่านั้น
  • "none": ไม่มีการส่งการแจ้งเตือน สำหรับงานย้ายข้อมูลปฏิทิน ให้ลองใช้เมธอด Events.import แทน
supportsAttachments boolean การทำงานของไคลเอ็นต์ API รองรับไฟล์แนบเหตุการณ์หรือไม่ ไม่บังคับ ค่าเริ่มต้นคือ "เท็จ"

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

คำขอนี้จำเป็นต้องให้สิทธิ์ด้วยขอบเขตต่อไปนี้อย่างน้อย 1 ขอบเขต

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

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

เนื้อหาของคำขอ

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

ชื่อพร็อพเพอร์ตี้ ค่า คำอธิบาย Notes
พร็อพเพอร์ตี้ที่จำเป็น
end nested object เวลาสิ้นสุด (เฉพาะตัว) ของกิจกรรม สำหรับกิจกรรมที่เกิดซ้ำ นี่คือเวลาสิ้นสุดของอินสแตนซ์แรก
start nested object เวลาเริ่มต้นของกิจกรรม (รวม) สำหรับกิจกรรมที่เกิดซ้ำ นี่คือเวลาเริ่มต้นของอินสแตนซ์แรก
พร็อพเพอร์ตี้ที่ไม่บังคับ
anyoneCanAddSelf boolean ทุกคนสามารถเชิญตนเองเข้าร่วมกิจกรรมได้หรือไม่ (เลิกใช้งาน) ไม่บังคับ ค่าเริ่มต้นคือ "เท็จ" เขียนได้
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 ดูว่าผู้เข้าร่วมรายนี้เป็นผู้เข้าร่วมที่ไม่บังคับหรือไม่ ไม่บังคับ ค่าเริ่มต้นคือ "เท็จ" เขียนได้
attendees[].resource boolean ผู้เข้าร่วมเป็นทรัพยากรหรือไม่ ตั้งค่าได้ก็ต่อเมื่อเพิ่มผู้เข้าร่วมในกิจกรรมเป็นครั้งแรกเท่านั้น ระบบจะไม่สนใจการแก้ไขที่ตามมา ไม่บังคับ ค่าเริ่มต้นคือ "เท็จ" เขียนได้
attendees[].responseStatus string สถานะการตอบกลับของผู้เข้าร่วม ค่าที่เป็นไปได้มีดังนี้:
  • "needsAction" - ผู้เข้าร่วมยังไม่ตอบรับคำเชิญ (แนะนำสำหรับกิจกรรมใหม่)
  • "declined" - ผู้เข้าร่วมปฏิเสธคำเชิญ
  • "tentative" - ผู้เข้าร่วมตอบรับคำเชิญคร่าวๆ
  • "accepted" - ผู้เข้าร่วมตอบรับคำเชิญ
 เขียนได้
attendeesOmitted boolean กำหนดว่าผู้เข้าร่วมจะถูกละเว้นจากตัวแทนของกิจกรรมหรือไม่ เมื่อดึงข้อมูลเหตุการณ์ อาจเป็นเพราะข้อจํากัดที่พารามิเตอร์การค้นหา maxAttendee ระบุไว้ เมื่ออัปเดตกิจกรรม จะใช้การตั้งค่านี้เพื่ออัปเดตคำตอบของผู้เข้าร่วมเท่านั้น ไม่บังคับ ค่าเริ่มต้นคือ "เท็จ" เขียนได้
colorId string สีของกิจกรรม นี่คือรหัสที่อ้างถึงรายการในส่วน event ของคำจำกัดความสี (ดู ปลายทางสี) ไม่บังคับ เขียนได้
conferenceData nested object ข้อมูลที่เกี่ยวข้องกับการประชุม เช่น รายละเอียดการประชุม Google Meet หากต้องการสร้างรายละเอียดการประชุมใหม่ ให้ใช้ช่อง createRequest หากต้องการคงการเปลี่ยนแปลงไว้ อย่าลืมตั้งค่าพารามิเตอร์คำขอ conferenceDataVersion เป็น 1 สำหรับคำขอแก้ไขเหตุการณ์ทั้งหมด เขียนได้
description string คำอธิบายกิจกรรม มี HTML ได้ ไม่บังคับ เขียนได้
end.date date วันที่ในรูปแบบ "ปปปป-ดด-วว" หากกิจกรรมนี้เป็นแบบตลอดวัน เขียนได้
end.dateTime datetime เวลาเป็นค่าวันที่-เวลาแบบรวม (จัดรูปแบบตาม RFC3339) จำเป็นต้องมีการชดเชยเขตเวลา เว้นแต่จะระบุเขตเวลาใน timeZone อย่างชัดเจน เขียนได้
end.timeZone string เขตเวลาที่ระบุเวลา (จัดรูปแบบเป็นชื่อฐานข้อมูลเขตเวลาของ IANA เช่น "ยุโรป/ซูริค") สำหรับกิจกรรมที่เกิดซ้ำ คุณต้องกรอกช่องนี้และระบุเขตเวลาที่มีการขยายการเกิดซ้ำ สำหรับเหตุการณ์เดียว ช่องนี้จะมีหรือไม่มีก็ได้ และจะระบุเขตเวลาที่กำหนดเองสำหรับการเริ่มต้น/สิ้นสุดกิจกรรม เขียนได้
extendedProperties.private object พร็อพเพอร์ตี้ที่เป็นส่วนบุคคลสำหรับสำเนาของกิจกรรมที่ปรากฏในปฏิทินนี้ เขียนได้
extendedProperties.shared object พร็อพเพอร์ตี้ที่แชร์ระหว่างสำเนาของกิจกรรมในปฏิทินของผู้เข้าร่วมคนอื่น เขียนได้
focusTimeProperties nested object ข้อมูลเหตุการณ์ที่ต้องการสมาธิ ต้องระบุหาก eventType คือ focusTime เขียนได้
gadget.display string โหมดการแสดงผลของแกดเจ็ต เลิกใช้งานแล้ว ค่าที่เป็นไปได้มีดังนี้:
  • "icon" - แกดเจ็ตจะแสดงข้างชื่อกิจกรรมในมุมมองปฏิทิน
  • "chip" - แกดเจ็ตจะแสดงเมื่อมีการคลิกเหตุการณ์
 เขียนได้
gadget.height integer ความสูงของแกดเจ็ตเป็นพิกเซล ความสูงต้องเป็นจำนวนเต็มที่มากกว่า 0 ไม่บังคับ เลิกใช้งานแล้ว เขียนได้
gadget.preferences object ค่ากำหนด เขียนได้
gadget.title string ชื่อแกดเจ็ต เลิกใช้งานแล้ว เขียนได้
gadget.type string ประเภทของแกดเจ็ต เลิกใช้งานแล้ว เขียนได้
gadget.width integer ความกว้างของแกดเจ็ตเป็นพิกเซล ความกว้างต้องเป็นจำนวนเต็มที่มากกว่า 0 ไม่บังคับ เลิกใช้งานแล้ว เขียนได้
guestsCanInviteOthers boolean ผู้เข้าร่วมที่ไม่ใช่ผู้จัดจะเชิญผู้อื่นเข้าร่วมกิจกรรมได้หรือไม่ ไม่บังคับ ค่าเริ่มต้นคือ True เขียนได้
guestsCanModify boolean ผู้เข้าร่วมที่ไม่ใช่ผู้จัดจะแก้ไขกิจกรรมได้หรือไม่ ไม่บังคับ ค่าเริ่มต้นคือ "เท็จ" เขียนได้
guestsCanSeeOtherGuests boolean ผู้เข้าร่วมที่ไม่ใช่ผู้จัดสามารถดูว่าใครเป็นผู้เข้าร่วมกิจกรรมได้หรือไม่ ไม่บังคับ ค่าเริ่มต้นคือ True เขียนได้
location string สถานที่ตั้งทางภูมิศาสตร์ของกิจกรรมในรูปแบบข้อความรูปแบบอิสระ ไม่บังคับ เขียนได้
originalStartTime.date date วันที่ในรูปแบบ "ปปปป-ดด-วว" หากกิจกรรมนี้เป็นแบบตลอดวัน เขียนได้
originalStartTime.dateTime datetime เวลาเป็นค่าวันที่-เวลาแบบรวม (จัดรูปแบบตาม RFC3339) จำเป็นต้องมีการชดเชยเขตเวลา เว้นแต่จะระบุเขตเวลาใน timeZone อย่างชัดเจน เขียนได้
originalStartTime.timeZone string เขตเวลาที่ระบุเวลา (จัดรูปแบบเป็นชื่อฐานข้อมูลเขตเวลาของ IANA เช่น "ยุโรป/ซูริค") สำหรับกิจกรรมที่เกิดซ้ำ คุณต้องกรอกช่องนี้และระบุเขตเวลาที่มีการขยายการเกิดซ้ำ สำหรับเหตุการณ์เดียว ช่องนี้จะมีหรือไม่มีก็ได้ และจะระบุเขตเวลาที่กำหนดเองสำหรับการเริ่มต้น/สิ้นสุดกิจกรรม เขียนได้
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 ของแหล่งที่มาที่ชี้ไปยังทรัพยากร Scheme ของ URL ต้องเป็น HTTP หรือ HTTPS เขียนได้
start.date date วันที่ในรูปแบบ "ปปปป-ดด-วว" หากกิจกรรมนี้เป็นแบบตลอดวัน เขียนได้
start.dateTime datetime เวลาเป็นค่าวันที่-เวลาแบบรวม (จัดรูปแบบตาม RFC3339) จำเป็นต้องมีการชดเชยเขตเวลา เว้นแต่จะระบุเขตเวลาใน timeZone อย่างชัดเจน เขียนได้
start.timeZone string เขตเวลาที่ระบุเวลา (จัดรูปแบบเป็นชื่อฐานข้อมูลเขตเวลาของ IANA เช่น "ยุโรป/ซูริค") สำหรับกิจกรรมที่เกิดซ้ำ คุณต้องกรอกช่องนี้และระบุเขตเวลาที่มีการขยายการเกิดซ้ำ สำหรับเหตุการณ์เดียว ช่องนี้จะมีหรือไม่มีก็ได้ และจะระบุเขตเวลาที่กำหนดเองสำหรับการเริ่มต้น/สิ้นสุดกิจกรรม เขียนได้
status string สถานะของกิจกรรม ไม่บังคับ ค่าที่เป็นไปได้มีดังนี้:
  • "confirmed" - ยืนยันกิจกรรมแล้ว นี่คือสถานะเริ่มต้น
  • "tentative" - กิจกรรมได้รับการยืนยันชั่วคราว
  • "cancelled" - กิจกรรมถูกยกเลิก (ลบแล้ว) เมธอด list จะแสดงผลกิจกรรมที่ยกเลิกเฉพาะในการซิงค์ที่เพิ่มขึ้นเท่านั้น (เมื่อระบุ syncToken หรือ updatedMin) หรือหากมีการตั้งค่าแฟล็ก showDeleted เป็น true เมธอด get จะแสดงผลค่าเหล่านั้นเสมอ

    สถานะ "ยกเลิกแล้ว" จะแสดงสถานะที่แตกต่างกัน 2 สถานะโดยขึ้นอยู่กับประเภทเหตุการณ์ ดังนี้

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

      ข้อยกเว้นที่ถูกยกเลิกรับประกันว่าจะมีการเติมค่าสำหรับช่อง id, recurringEventId และ originalStartTime เท่านั้น ช่องอื่นๆ อาจว่างเปล่า

    2. กิจกรรมอื่นๆ ทั้งหมดที่ถูกยกเลิกจะแสดงถึงกิจกรรมที่ถูกลบ ไคลเอ็นต์ควรนำสำเนาที่ซิงค์ในเครื่องออก กิจกรรมที่ยกเลิกดังกล่าวจะหายไปในท้ายที่สุด ดังนั้น โปรดอย่ารอให้กิจกรรมเหล่านั้นว่างอย่างไม่มีกำหนด

      มีเพียงกิจกรรมที่ถูกลบเท่านั้นที่จะมีข้อมูลในช่อง id

    ในปฏิทินของผู้จัด กิจกรรมที่ยกเลิกจะยังคงแสดงรายละเอียดกิจกรรม (สรุป สถานที่ ฯลฯ) เพื่อให้สามารถกู้คืน (ยกเลิกการลบ) ในทำนองเดียวกัน เหตุการณ์ที่ผู้ใช้ได้รับเชิญและที่ผู้ใช้นําออกด้วยตนเองจะยังคงให้รายละเอียดต่อไป อย่างไรก็ตาม คำขอซิงค์ที่เพิ่มขึ้นที่มี showDeleted ซึ่งตั้งค่าเป็น "เท็จ" จะไม่แสดงรายละเอียดเหล่านี้

    หากกิจกรรมเปลี่ยนผู้จัด (เช่น ผ่านการดำเนินการ move) และผู้จัดคนเดิมไม่ได้อยู่ในรายชื่อผู้เข้าร่วม กิจกรรมนั้นจะถูกยกเลิกกิจกรรมที่ถูกยกเลิกและรับประกันว่าจะมีการป้อนข้อมูลเฉพาะช่อง 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" - ผู้ใช้กำลังทำงานจากสถานที่ที่กำหนดเอง
รายละเอียดต่างๆ จะระบุไว้ในช่องย่อยของชื่อที่ระบุ แต่ช่องนี้อาจขาดหายไปหากเว้นว่าง ระบบจะไม่สนใจช่องอื่นๆ

ต้องระบุเมื่อเพิ่มพร็อพเพอร์ตี้สถานที่ทำงาน

 เขียนได้

คำตอบ

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

ตัวอย่าง

หมายเหตุ: ตัวอย่างโค้ดที่มีสำหรับวิธีการนี้ไม่ได้แสดงถึงภาษาโปรแกรมที่รองรับทั้งหมด (ดูรายการภาษาที่รองรับได้ในหน้าไลบรารีของไคลเอ็นต์)

Java

ใช้ไลบรารีของไคลเอ็นต์ Java

import com.google.api.services.calendar.Calendar;
import com.google.api.services.calendar.model.Event;

// ...

// Initialize Calendar service with valid OAuth credentials
Calendar service = new Calendar.Builder(httpTransport, jsonFactory, credentials)
    .setApplicationName("applicationName").build();

// Retrieve the event from the API
Event event = service.events().get("primary", "eventId").execute();

// Make a change
event.setSummary("Appointment at Somewhere");

// Update the event
Event updatedEvent = service.events().update("primary", event.getId(), event).execute();

System.out.println(updatedEvent.getUpdated());

Python

ใช้ไลบรารีของไคลเอ็นต์ Python

# First retrieve the event from the API.
event = service.events().get(calendarId='primary', eventId='eventId').execute()

event['summary'] = 'Appointment at Somewhere'

updated_event = service.events().update(calendarId='primary', eventId=event['id'], body=event).execute()

# Print the updated date.
print updated_event['updated']

PHP

ใช้ไลบรารีของไคลเอ็นต์ PHP

// First retrieve the event from the API.
$event = $service->events->get('primary', 'eventId');

$event->setSummary('Appointment at Somewhere');

$updatedEvent = $service->events->update('primary', $event->getId(), $event);

// Print the updated date.
echo $updatedEvent->getUpdated();

Ruby

ใช้ไลบรารีของไคลเอ็นต์ Ruby

event = client.get_event('primary', 'eventId')
event.summary = 'Appointment at Somewhere'
result = client.update_event('primary', event.id, event)
print result.updated

ลองใช้เลย

ใช้ API Explorer ด้านล่างเพื่อเรียกใช้เมธอดนี้กับข้อมูลแบบเรียลไทม์และดูการตอบกลับ