Acl: insert

建立存取權控管規則。 立即試用。

要求

HTTP 要求

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

參數

參數名稱 值 說明
路徑參數
calendarId string 日曆 ID。如要擷取日曆 ID，請呼叫 calendarList.list 方法。如要存取目前登入使用者的主要日曆，請使用「primary」關鍵字。
選用查詢參數
sendNotifications boolean 是否要傳送日曆共用變更通知。(選用步驟) 預設值為 True。

授權

這項要求需要至少下列其中一個範圍的授權：

範圍
https://www.googleapis.com/auth/calendar
https://www.googleapis.com/auth/calendar.acls

詳情請參閱驗證和授權頁面。

要求主體

在要求主體中，請提供具有下列屬性的 Acl 資源：

屬性名稱 值 說明 附註
必要屬性
role string 指派給範圍的角色。可能的值包括：
  • 「none」：無法存取。
  • 「freeBusyReader」：提供忙碌/閒置資訊的讀取權。
  • 「reader」：提供日曆的讀取權。具有讀取權限的使用者會看到私人活動，但活動詳細資料會隱藏。
  • 「writer」：提供日曆的讀取和寫入權限。私人活動會向具有寫入權限的使用者顯示，且使用者可查看活動詳細資料。提供日曆 ACL 的讀取權限。
  • 「owner」：提供日曆的管理員存取權。這個角色具有撰稿者角色的所有權限，還能修改其他使用者的存取層級。

 可寫入
scope object 這項 ACL 規則授予日曆存取權的程度。
scope.type string 範圍類型。可能的值包括：
  • 「default」：公開範圍。這是預設值。
  • 「user」：將範圍限制為單一使用者。
  • 「group」：將範圍限制為群組。
  • 「domain」：將範圍限制為網域。
注意：授予「default」或公開範圍的權限適用於所有使用者，無論是否經過驗證。
選用屬性
scope.value string 使用者或群組的電子郵件地址，或是網域名稱 (視範圍類型而定)。已省略類型「default」。 可寫入

回應

如果成功，這個方法會在回應內文中傳回 Acl 資源。

試試看！

您可以使用下方的 API Explorer，針對即時資料呼叫這個方法，然後查看回應。