Policy

定義資源的存取權控管政策。

JSON 表示法
{
  "assignments": [
    {
      object (Assignment)
    }
  ],
  "etag": string
}
欄位
assignments[]

object (Assignment)

assignments 的清單

etag

string (bytes format)

etag 用於開放式並行控制,有助防止政策在同時更新時相互覆寫。強烈建議系統在讀取-修改-寫入週期中使用 etag 執行政策更新,以避免發生競爭狀況:etag 會在 policies.get 的回應中傳回,系統應將該 etag 放入 policies.set 的要求中,確保變更會套用至相同版本的政策。

如果呼叫 policies.get 時未提供 etag,則現有政策就會遭到盲目覆寫。

Base64 編碼字串。

指派項目

membersrole 建立關聯。

JSON 表示法
{
  "role": string,
  "members": [
    string
  ]
}
欄位
role

string

必要欄位。指派給 members 的角色。

members[]

string

指派角色的身分。可能具有下列值:

  • {user_email}:代表特定 Google 帳戶的電子郵件地址,例如:alice@gmail.com

  • {group_email}:代表 Google 群組的電子郵件地址,例如 viewers@gmail.com