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