Calendars

คอลเล็กชันของปฏิทินที่มีอยู่ทั้งหมด ดูเพิ่มเติมที่ ปฏิทินเทียบกับ CalendarList

ดูรายการ เมธอด สำหรับทรัพยากรนี้ได้ที่ส่วนท้ายของหน้านี้

การแสดงทรัพยากร

{
  "kind": "calendar#calendar",
  "etag": etag,
  "id": string,
  "summary": string,
  "description": string,
  "location": string,
  "timeZone": string,
  "dataOwner": string,
  "conferenceProperties": {
    "allowedConferenceSolutionTypes": [
      string
    ]
  },
  "autoAcceptInvitations": boolean
}
ชื่อพร็อพเพอร์ตี้ ค่า คำอธิบาย หมายเหตุ
autoAcceptInvitations boolean ระบุว่าปฏิทินนี้ยอมรับคำเชิญโดยอัตโนมัติหรือไม่ ใช้ได้กับปฏิทินทรัพยากรเท่านั้น
conferenceProperties nested object พร็อพเพอร์ตี้การประชุมสำหรับปฏิทินนี้ เช่น ประเภทการประชุมที่อนุญาต
conferenceProperties.allowedConferenceSolutionTypes[] list ประเภทโซลูชันการประชุมที่รองรับสำหรับปฏิทินนี้

ค่าที่เป็นไปได้มีดังนี้

  • "eventHangout"
  • "eventNamedHangout"
  • "hangoutsMeet"
ไม่บังคับ
dataOwner string อีเมลของเจ้าของปฏิทิน ตั้งค่าสำหรับปฏิทินรองเท่านั้น ช่องนี้เป็นข้อมูลแบบอ่านอย่างเดียว
description string คำอธิบายปฏิทิน ไม่บังคับ เขียนได้
etag etag ETag ของทรัพยากร
id string ตัวระบุของปฏิทิน หากต้องการดึงข้อมูลรหัส ให้เรียกใช้เมธอด calendarList.list()
kind string ประเภทของทรัพยากร ("calendar#calendar")
location string สถานที่ตั้งทางภูมิศาสตร์ของปฏิทินในรูปแบบข้อความอิสระ ไม่บังคับ เขียนได้
summary string ชื่อปฏิทิน เขียนได้
timeZone string เขตเวลาของปฏิทิน (จัดรูปแบบเป็นชื่อฐานข้อมูลเขตเวลาของ IANA เช่น "Europe/Zurich") ไม่บังคับ เขียนได้

เมธอด

ล้าง
ล้างปฏิทินหลัก การดำเนินการนี้จะลบกิจกรรมทั้งหมดที่เชื่อมโยงกับปฏิทินหลักของบัญชี
ลบ
ลบปฏิทินรอง ใช้ calendars.clear เพื่อล้างกิจกรรมทั้งหมดในปฏิทินหลัก
ดาวน์โหลด
แสดงผลข้อมูลเมตาสำหรับปฏิทิน
แทรก
สร้างปฏิทินรอง

ระบบจะกำหนดให้ผู้ใช้ที่ตรวจสอบสิทธิ์สำหรับคำขอเป็นเจ้าของข้อมูลของปฏิทินใหม่

แพตช์
อัปเดตข้อมูลเมตาสำหรับปฏิทิน เมธอดนี้รองรับความหมายของแพตช์ โปรดทราบว่าคำขอแพตช์แต่ละรายการใช้หน่วยโควต้า 3 หน่วย เราจึงแนะนำให้ใช้ get ตามด้วย update ค่าของช่องที่คุณระบุจะแทนที่ค่าที่มีอยู่ ช่องที่คุณไม่ได้ระบุในคำขอจะยังคงไม่เปลี่ยนแปลง ช่องอาร์เรย์ หากระบุไว้ จะเขียนทับอาร์เรย์ที่มีอยู่ ซึ่งจะทิ้งองค์ประกอบอาร์เรย์ก่อนหน้า
transferOwnership
โอนปฏิทินรองระหว่างผู้ใช้ภายในองค์กร Google Workspace ต้องมีการตรวจสอบสิทธิ์ผู้ใช้ที่มีสิทธิ์ของผู้ดูแลระบบในการจัดการปฏิทิน และขอบเขตการให้สิทธิ์ข้อใดข้อหนึ่งต่อไปนี้
  • https://www.googleapis.com/auth/calendar
  • https://www.googleapis.com/auth/calendar.calendars
ในคำขอ ให้ตั้งค่า useAdminAccess เป็น true ปฏิทินรองต้องใช้งานอยู่จึงจะโอนได้ ระบบไม่รองรับการโอนปฏิทินที่ปิดใช้หรือลบไปแล้ว
อัปเดต
อัปเดตข้อมูลเมตาสำหรับปฏิทิน