Acl

如需本資源的方法清單,請見本頁結尾。

資源表示法

{
  "kind": "calendar#aclRule",
  "etag": etag,
  "id": string,
  "scope": {
    "type": string,
    "value": string
  },
  "role": string
}
屬性名稱 說明 附註
etag etag 資源的 ETag。
id string 存取控制清單 (ACL) 規則的 ID。請參閱共用日曆
kind string 資源類型 (「calendar#aclRule」)。
role string 指派給範圍的角色。可能的值包括:
  • none」:無法存取。
  • freeBusyReader」:提供忙碌/閒置資訊的讀取權。
  • reader」:提供日曆的讀取權。具有讀取權限的使用者會看到私人活動,但活動詳細資料會隱藏。
  • writer」:提供日曆的讀取和寫入權限。私人活動會向具有寫入權限的使用者顯示,且使用者可查看活動詳細資料。提供日曆 ACL 的讀取權限。
  • owner」:提供日曆的管理員存取權。這個角色具有撰稿者角色的所有權限,還能修改其他使用者的存取層級。

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

方法

刪除
刪除存取控管規則。
get
傳回存取權控管規則。
插入
建立存取控管規則。
list
傳回日曆存取控制清單中的規則。
修補程式
更新存取權控管規則。這個方法支援 patch 語意。請注意,每個修補程式要求會耗用三個配額單位,建議使用 get,然後再使用 update。您指定的欄位值會取代現有值。要求中未指定的欄位會維持不變。如果指定陣列欄位,系統會覆寫現有陣列,並捨棄先前的陣列元素。
更新
更新存取權控管規則。
智慧手錶
監控 ACL 資源的變更。