Acl: insert

หมายเหตุ: ต้องให้สิทธิ์

สร้างกฎการควบคุมการเข้าถึง ลองใช้เลย

ส่งคำขอ

คำขอ HTTP

POST https://www.googleapis.com/calendar/v3/calendars/calendarId/acl

พารามิเตอร์

ชื่อพารามิเตอร์	ค่า	คำอธิบาย
พารามิเตอร์เส้นทาง
calendarId	string	ตัวระบุปฏิทิน หากต้องการเรียกข้อมูลรหัสปฏิทิน ให้เรียกใช้เมธอด calendarList.list หากต้องการเข้าถึงปฏิทินหลักของผู้ใช้ที่เข้าสู่ระบบอยู่ในปัจจุบัน ให้ใช้คีย์เวิร์ด "primary"
พารามิเตอร์การค้นหาที่ไม่บังคับ
sendNotifications	boolean	ตัวเลือกว่าจะส่งการแจ้งเตือนเกี่ยวกับการเปลี่ยนแปลงการแชร์ปฏิทินหรือไม่ ไม่บังคับ ค่าเริ่มต้นคือ True

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

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

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

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

เนื้อความของคำขอ

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

ชื่อพร็อพเพอร์ตี้	ค่า	คำอธิบาย	หมายเหตุ
พร็อพเพอร์ตี้ที่จำเป็น
role	string	บทบาทที่กําหนดให้กับขอบเขต ค่าที่เป็นไปได้มีดังนี้ "none" - ไม่มีสิทธิ์เข้าถึง "freeBusyReader" - ให้สิทธิ์อ่านข้อมูลว่าง/ไม่ว่าง "reader" - ให้สิทธิ์อ่านปฏิทิน กิจกรรมส่วนตัวจะปรากฏต่อผู้ใช้ที่มีสิทธิ์เข้าถึงระดับผู้อ่าน แต่ระบบจะซ่อนรายละเอียดกิจกรรม "writer" - ให้สิทธิ์อ่านและเขียนในปฏิทิน กิจกรรมส่วนตัวจะปรากฏต่อผู้ใช้ที่มีสิทธิ์เข้าถึงระดับผู้เขียน และผู้ใช้จะเห็นรายละเอียดกิจกรรม ให้สิทธิ์การอ่าน ACL ของปฏิทิน "owner" - ระบุการเป็นเจ้าของปฏิทิน บทบาทนี้มีสิทธิ์ทั้งหมดของบทบาทผู้เขียน พร้อมความสามารถในการจัดการ ACL เพิ่มเติม	เขียนได้
scope	object	ระดับที่กฎ ACL นี้ให้สิทธิ์การเข้าถึงปฏิทิน
scope.type	string	ประเภทของขอบเขต ค่าที่เป็นไปได้มีดังนี้ "default" - ขอบเขตสาธารณะ นี่คือค่าเริ่มต้น "user" - จำกัดขอบเขตให้ผู้ใช้รายเดียว "group" - จำกัดขอบเขตไว้ที่กลุ่ม "domain" - จำกัดขอบเขตไว้ที่โดเมน หมายเหตุ: สิทธิ์ที่มอบให้กับขอบเขต "default" หรือสาธารณะจะมีผลกับผู้ใช้ทุกคนไม่ว่าจะมีการตรวจสอบสิทธิ์หรือไม่ก็ตาม
พร็อพเพอร์ตี้ที่ไม่บังคับ
scope.value	string	อีเมลของผู้ใช้หรือกลุ่ม หรือชื่อโดเมน ทั้งนี้ขึ้นอยู่กับประเภทขอบเขต ละเว้นสำหรับประเภท "default"	เขียนได้

การตอบกลับ

หากดำเนินการสำเร็จ วิธีการนี้จะแสดงผล Acl resource ในเนื้อหาการตอบกลับ

ลองใช้งาน

ใช้โปรแกรมสำรวจ API ด้านล่างเพื่อเรียกใช้เมธอดนี้กับข้อมูลจริงและดูการตอบกลับ