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 資源的異動。