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」- 提供日曆的讀取及寫入權限，私人活動會向具備寫入者的使用者顯示，並提供活動詳細資料。
  • 「owner」- 提供日曆的擁有權。這個角色具備寫入者角色的所有權限，並能查看和操控 ACL。
 可寫入
scope object 這個 ACL 規則授予日曆存取權的程度。
scope.type string 範圍類型。可能的值包括：
  • 「default」- 公開範圍。這是預設值。
  • 「user」- 將範圍限制在單一使用者。
  • 「group」- 將範圍限制在群組內。
  • 「domain」- 將範圍限制在一個網域內。
注意：授予「default」或公開範圍的權限，適用於任何已驗證或未驗證的使用者。
scope.value string 使用者/群組的電子郵件地址，或網域名稱 (視範圍類型而定)。「default」類型省略。 可寫入

方法

刪除
刪除存取權控管規則。
取得
傳回存取權控管規則。
插入
建立存取權控管規則。
list
傳回日曆存取控制清單中的規則。
修補程式
更新存取權控管規則。這個方法支援 patch 語意。請注意，每個修補要求都會耗用三個配額單位；偏好使用 get，後面加上 update。您指定的欄位值會取代現有的值。未指定要求中的欄位會維持不變。陣列欄位 (如有指定) 會覆寫現有陣列；就會捨棄先前的所有陣列元素。
更新
更新存取權控管規則。
手錶
留意 ACL 資源的異動。