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
傳回日曆存取控制清單中的規則。
修補
更新存取權控管規則。這個方法支援修補語意。請注意,每個修補要求都會佔用三個配額單位,建議使用 getupdate。您指定的欄位值會取代現有的值。您在要求中未指定的欄位則維持不變。陣列欄位 (如有指定) 會覆寫現有的陣列;這會忽略所有先前的陣列元素。
更新
更新存取權控管規則。
手錶
留意 ACL 資源的變更。