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」：提供日曆的擁有權。這個角色具有「作者」角色的所有權限，並可額外操作 ACL。
 可寫入
scope object 這項 ACL 規則授予的日曆存取權程度。
scope.type string 範圍的類型。可能的值包括：
  • 「default」- 公開範圍。這是預設值。
  • 「user」：將範圍限制為單一使用者。
  • 「group」：將範圍限制為群組。
  • 「domain」- 將範圍限制為一個網域。
注意：授予「default」或公開範圍的權限，會套用至任何使用者 (無論是否經過驗證)。
scope.value string 使用者或群組的電子郵件地址，或網域名稱 (視範圍類型而定)。對於類型「default」，則省略。 可寫入

方法

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