คอยดูการเปลี่ยนแปลงในทรัพยากร CalendarList
ส่งคำขอ
คำขอ HTTP
POST https://www.googleapis.com/calendar/v3/users/me/calendarList/watch
พารามิเตอร์
| ชื่อพารามิเตอร์ | ค่า | คำอธิบาย | 
|---|
การให้สิทธิ์
คำขอนี้ต้องมีการให้สิทธิ์ด้วยขอบเขตต่อไปนี้อย่างน้อย 1 รายการ
| ขอบเขต | 
|---|
| https://www.googleapis.com/auth/calendar.readonly | 
| https://www.googleapis.com/auth/calendar | 
| https://www.googleapis.com/auth/calendar.calendarlist | 
| https://www.googleapis.com/auth/calendar.calendarlist.readonly | 
ดูข้อมูลเพิ่มเติมได้ที่หน้าการตรวจสอบสิทธิ์และการให้สิทธิ์
เนื้อหาของคำขอ
ในเนื้อหาคําขอ ให้ระบุข้อมูลที่มีโครงสร้างดังต่อไปนี้
{
  "id": string,
  "token": string,
  "type": string,
  "address": string,
  "params": {
    "ttl": string
  }
}| ชื่อพร็อพเพอร์ตี้ | ค่า | คำอธิบาย | หมายเหตุ | 
|---|---|---|---|
| id | string | UUID หรือสตริงที่ไม่ซ้ำกันซึ่งระบุช่องนี้ | |
| token | string | สตริงที่กำหนดเองซึ่งส่งไปยังที่อยู่เป้าหมายพร้อมกับการแจ้งเตือนแต่ละรายการที่ส่งผ่านช่องทางนี้ ไม่บังคับ | |
| type | string | ประเภทของกลไกการนำส่งที่ใช้สำหรับแชแนลนี้ ค่าที่ใช้ได้คือ " web_hook" (หรือ "webhook") ค่าทั้ง 2 ค่าหมายถึงแชแนลที่ใช้คําขอ HTTP เพื่อส่งข้อความ | |
| address | string | อีเมลสำหรับรับการแจ้งเตือนของช่องนี้ | |
| params | object | พารามิเตอร์เพิ่มเติมที่ควบคุมลักษณะการทํางานของช่องทางการส่ง ไม่บังคับ | |
| params.ttl | string | ระยะเวลาในการเก็บรักษาเป็นวินาทีสําหรับช่องทางการแจ้งเตือน ค่าเริ่มต้นคือ 604800 วินาที | 
คำตอบ
หากทำสำเร็จ วิธีการนี้จะแสดงผลลัพธ์เป็นเนื้อหาการตอบกลับซึ่งมีโครงสร้างดังต่อไปนี้
{
  "kind": "api#channel",
  "id": string,
  "resourceId": string,
  "resourceUri": string,
  "token": string,
  "expiration": long
}| ชื่อพร็อพเพอร์ตี้ | ค่า | คำอธิบาย | หมายเหตุ | 
|---|---|---|---|
| kind | string | ระบุว่านี่คือช่องทางการแจ้งเตือนที่ใช้เพื่อคอยดูการเปลี่ยนแปลงในทรัพยากร " api#channel" | |
| id | string | UUID หรือสตริงที่ไม่ซ้ำกันซึ่งระบุช่องนี้ | |
| resourceId | string | รหัสทึบแสงที่ระบุทรัพยากรที่กำลังรับชมในช่องนี้ ทำงานได้อย่างเสถียรใน API เวอร์ชันต่างๆ | |
| resourceUri | string | ตัวระบุเฉพาะเวอร์ชันสำหรับทรัพยากรที่ดู | |
| token | string | สตริงที่กำหนดเองซึ่งส่งไปยังที่อยู่เป้าหมายพร้อมกับการแจ้งเตือนแต่ละรายการที่ส่งผ่านช่องทางนี้ ไม่บังคับ | |
| expiration | long | วันที่และเวลาหมดอายุของช่องทางการแจ้งเตือนที่แสดงเป็นการประทับเวลา UNIX ในหน่วยมิลลิวินาที ไม่บังคับ |