อัปเดตข้อมูลเมตาของปฏิทิน ลองใช้เลย
ส่งคำขอ
คำขอ HTTP
PUT https://www.googleapis.com/calendar/v3/calendars/calendarIdพารามิเตอร์
| ชื่อพารามิเตอร์ | ค่า | คำอธิบาย |
|---|---|---|
| พารามิเตอร์เส้นทาง | ||
calendarId |
string |
ตัวระบุปฏิทิน หากต้องการดึงข้อมูลรหัสปฏิทิน ให้เรียกใช้เมธอด calendarList.list หากต้องการเข้าถึงปฏิทินหลักของผู้ใช้ที่เข้าสู่ระบบในปัจจุบัน ให้ใช้คีย์เวิร์ด "primary"
|
การให้สิทธิ์
คำขอนี้ต้องมีการให้สิทธิ์ที่มีขอบเขตอย่างน้อย 1 รายการต่อไปนี้
| ขอบเขต |
|---|
https://www.googleapis.com/auth/calendar |
https://www.googleapis.com/auth/calendar.app.created |
https://www.googleapis.com/auth/calendar.calendars |
ดูข้อมูลเพิ่มเติมได้ที่หน้าการตรวจสอบสิทธิ์และการให้สิทธิ์
เนื้อความของคำขอ
ในเนื้อความของคำขอ ให้ระบุทรัพยากร Calendars ที่มีพร็อพเพอร์ตี้ต่อไปนี้
| ชื่อพร็อพเพอร์ตี้ | ค่า | คำอธิบาย | หมายเหตุ |
|---|---|---|---|
| พร็อพเพอร์ตี้ที่ไม่บังคับ | |||
description |
string |
คำอธิบายปฏิทิน ไม่บังคับ | เขียนได้ |
labelProperties |
nested object |
พร็อพเพอร์ตี้ป้ายกำกับที่กำหนดไว้ในปฏิทินนี้ หากระบุไว้ ระบบจะเขียนทับพร็อพเพอร์ตี้ป้ายกำกับที่มีอยู่ หากไม่ระบุ พร็อพเพอร์ตี้ป้ายกำกับจะยังคงเหมือนเดิม | เขียนได้ |
labelProperties.eventLabels[] |
list |
ป้ายกำกับกิจกรรมที่กำหนดไว้ในปฏิทินนี้ หากระบุไว้เมื่ออัปเดตปฏิทิน ระบบจะแทนที่ป้ายกำกับกิจกรรมที่มีอยู่ ขยายรายการเพื่อเพิ่มป้ายกำกับกิจกรรมใหม่ และนำเอนทิตีออกจากรายการเพื่อลบป้ายกำกับออกจากปฏิทิน ปฏิทินแต่ละรายการมีป้ายกำกับได้สูงสุด 200 รายการ |
เขียนได้ |
labelProperties.eventLabels[].backgroundColor |
string |
สีพื้นหลังของป้ายกำกับในรูปแบบเลขฐาน 16 เช่น "#039be5" ระบบจะแสดงกิจกรรมที่มีป้ายกำกับนี้ด้วยสีนี้ ต้องระบุ |
เขียนได้ |
labelProperties.eventLabels[].id |
string |
รหัสของป้ายกำกับ ไม่บังคับเมื่อแทรกป้ายกำกับใหม่ หากไม่ระบุ ระบบจะสร้างรหัสที่ไม่ซ้ำกัน ต้องระบุเมื่ออัปเดตป้ายกำกับ หากระบุ รหัสต้องไม่ซ้ำกันภายในปฏิทินและเป็นไปตามรูปแบบ UUID |
เขียนได้ |
labelProperties.eventLabels[].name |
string |
ชื่อของป้ายกำกับ ไม่บังคับ หากระบุ ชื่อต้องมีอักขระไม่เกิน 50 ตัว |
เขียนได้ |
location |
string |
สถานที่ตั้งทางภูมิศาสตร์ของปฏิทินเป็นข้อความอิสระ ไม่บังคับ | เขียนได้ |
summary |
string |
ชื่อของปฏิทิน | เขียนได้ |
timeZone |
string |
เขตเวลาของปฏิทิน (จัดรูปแบบเป็นชื่อฐานข้อมูลเขตเวลาของ IANA เช่น "Europe/Zurich") ไม่บังคับ | เขียนได้ |
การตอบกลับ
หากทำสำเร็จ เมธอดนี้จะแสดงทรัพยากร Calendars ในเนื้อหาการตอบกลับ
ลองใช้งาน
ใช้โปรแกรมสำรวจ APIs ด้านล่างเพื่อเรียกใช้เมธอดนี้กับข้อมูลจริงและดูการตอบกลับ