REST Resource: folders.approvalRequests

资源：ApprovalRequest

供客户批准资源访问权限的请求。

JSON 表示法 
{
  "name": string,
  "requestedResourceName": string,
  "requestedResourceProperties": {
    object (ResourceProperties)
  },
  "requestedReason": {
    object (AccessReason)
  },
  "requestedLocations": {
    object (AccessLocations)
  },
  "requestTime": string,
  "requestedExpiration": string,

  // Union field decision can be only one of the following:
  "approve": {
    object (ApproveDecision)
  },
  "dismiss": {
    object (DismissDecision)
  }
  // End of list of possible types for union field decision.
}
字段
name

string

请求的资源名称。格式为“{projects|folders|organizations}/{id}/approvalRequests/{approval_request}”。
requestedResourceName

string

要为其请求审批的资源。如需了解资源名称的格式，请访问 https://cloud.google.com/apis/design/resource_names。此处的资源名称可以是“完整”资源名称（例如“//library.googleapis.com/shelves/shelf1/books/book2”）或“相对”资源名称（例如“shelves/shelf1/books/book2”），如资源名称规范中所述。
requestedResourceProperties

object (ResourceProperties)

与由 requestResourceName 表示的资源相关的属性。
requestedReason

object (AccessReason)

请求批准的理由。
requestedLocations

object (AccessLocations)

要为其提出审批请求的营业地点。
requestTime

string (Timestamp format)

提出审批请求的时间。

时间戳采用 RFC3339 世界协调时间（UTC，即“祖鲁时”）格式，精确到纳秒，最多九个小数位。示例："2014-10-02T15:01:23Z" 和 "2014-10-02T15:01:23.045123456Z"。
requestedExpiration

string (Timestamp format)

请求的审批期限。如果请求获得批准，系统将授予访问权限（从批准时间到到期时间）。

时间戳采用 RFC3339 世界协调时间（UTC，即“祖鲁时”）格式，精确到纳秒，最多九个小数位。示例："2014-10-02T15:01:23Z" 和 "2014-10-02T15:01:23.045123456Z"。
联合字段 decision。针对审批请求的当前处理决定。decision 只能是下列其中一项：
approve

object (ApproveDecision)

已批准访问权限。
dismiss

object (DismissDecision)

已拒绝请求。

ResourceProperties

与请求的资源关联的属性。

JSON 表示法 
{
  "excludesDescendants": boolean
}
字段
excludesDescendants

boolean

批准是否会排除所请求资源的后代。

AccessReason

JSON 表示法 
{
  "type": enum (Type),
  "detail": string
}
字段
type

enum (Type)

访问理由的类型。
detail

string

有关特定原因类型的更多详细信息。请参阅上述每种类型的注释。

类型

访问理由的类型。

枚举
TYPE_UNSPECIFIED 不应使用 proto 的默认值。
CUSTOMER_INITIATED_SUPPORT

客户提出了请求或提出需要主账号访问客户数据的问题。detail 的格式为（“#####”是问题 ID）：

  • “反馈报告：#####”
  • “案例编号：#####”
  • “支持请求 ID：#####”
  • “E-PIN 码参考：#####”
  • “Google-#####”
  • “T-#####”
GOOGLE_INITIATED_SERVICE 主账号访问了客户数据，以诊断或解决服务中的疑似问题。此访问权限通常用于确认客户未受到可疑服务问题的影响，或用于修复可逆转的系统问题。
GOOGLE_INITIATED_REVIEW Google 出于安全、欺诈、滥用或法规遵从的目的启动了服务。
THIRD_PARTY_DATA_REQUEST 为了回应依法提出的第三方数据要求或流程（包括客户自行提起的司法程序），主账号被强制访问客户数据。
GOOGLE_RESPONSE_TO_PRODUCTION_ALERT 主账号访问了客户数据，以诊断或解决服务中存在的疑似问题或已知的服务中断问题。

AccessLocations

主账号的主要办公地点和实际地点。

JSON 表示法 
{
  "principalOfficeCountry": string,
  "principalPhysicalLocationCountry": string
}
字段
principalOfficeCountry

string

主账号的“主要办公地点”。由两个字母组成的国家/地区代码 (ISO 3166-1 alpha-2)，如“US”“DE”或“GB”或区域代码。在某些情况下，Google 系统可能会参考区域代码，而不是国家/地区代码。可能的地区代码：

  • ASI：亚洲
  • EUR：欧洲
  • OCE：大洋洲
  • AFR：非洲
  • NAM：北美
  • SAM：南美洲
  • ANT：南极洲
  • ANY：任何地点
principalPhysicalLocationCountry

string

访问时主账号的实际位置。由两个字母组成的国家/地区代码 (ISO 3166-1 alpha-2)，如“US”“DE”或“GB”或区域代码。在某些情况下，Google 系统可能会参考区域代码，而不是国家/地区代码。可能的地区代码：

  • ASI：亚洲
  • EUR：欧洲
  • OCE：大洋洲
  • AFR：非洲
  • NAM：北美
  • SAM：南美洲
  • ANT：南极洲
  • ANY：任何地点

ApproveDecision

已做出的批准资源访问权限的决定。

JSON 表示法 
{
  "approveTime": string,
  "expireTime": string,
  "invalidateTime": string,
  "signatureInfo": {
    object (SignatureInfo)
  },
  "autoApproved": boolean
}
字段
approveTime

string (Timestamp format)

获得批准的时间。

时间戳采用 RFC3339 世界协调时间（UTC，即“祖鲁时”）格式，精确到纳秒，最多九个小数位。示例："2014-10-02T15:01:23Z" 和 "2014-10-02T15:01:23.045123456Z"。
expireTime

string (Timestamp format)

审批的到期时间。

时间戳采用 RFC3339 世界协调时间（UTC，即“祖鲁时”）格式，精确到纳秒，最多九个小数位。示例："2014-10-02T15:01:23Z" 和 "2014-10-02T15:01:23.045123456Z"。
invalidateTime

string (Timestamp format)

如果设置了此字段，则指明审批失效的时间戳。

时间戳采用 RFC3339 世界协调时间（UTC，即“祖鲁时”）格式，精确到纳秒，最多九个小数位。示例："2014-10-02T15:01:23Z" 和 "2014-10-02T15:01:23.045123456Z"。
signatureInfo

object (SignatureInfo)

ApprovalRequest 的签名及其签名方式的详细信息。
autoApproved

boolean

如果请求已自动获得批准，则为“true”。

SignatureInfo

有关资源数字签名的信息。

JSON 表示法 
{
  "signature": string,

  // Union field verification_info can be only one of the following:
  "googlePublicKeyPem": string,
  "customerKmsKeyVersion": string
  // End of list of possible types for union field verification_info.
}
字段
signature

string (bytes format)

数字签名。

使用 base64 编码的字符串。
联合字段 verification_info。此签名的验证方式。verification_info 只能是下列其中一项：
googlePublicKeyPem

string

Google 默认签名的公钥，采用 PEM 格式编码。签名是使用私钥创建的，可使用此公钥进行验证。
customerKmsKeyVersion

string

用于签名的客户 CryptoKeyVersion 的资源名称。

DismissDecision

已做出忽略审批请求的决定。

JSON 表示法 
{
  "dismissTime": string,
  "implicit": boolean
}
字段
dismissTime

string (Timestamp format)

审批请求被拒绝的时间。

时间戳采用 RFC3339 世界协调时间（UTC，即“祖鲁时”）格式，精确到纳秒，最多九个小数位。示例："2014-10-02T15:01:23Z" 和 "2014-10-02T15:01:23.045123456Z"。
implicit

boolean

如果 ApprovalRequest 因访问权限审批审批人未采取行动而被隐式拒绝，此字段将为 true（审批人在生效时间之前未处理该请求）。

方法

approve

 批准请求并返回更新后的 ApprovalRequest。

dismiss

 关闭请求。

get

 获取审批请求。

invalidate

 使现有 ApprovalRequest 失效。

list

 列出与项目、文件夹或组织关联的审批请求。