Method: operations.wait

等待指定的长时间运行的操作完成或最多达到指定的超时,返回最新状态。如果操作已完成,则立即返回最新状态。如果指定的超时大于默认的 HTTP/RPC 超时,则使用 HTTP/RPC 超时。如果服务器不支持此方法,则会返回 google.rpc.Code.UNIMPLEMENTED。请注意,此方法会尽力执行命令。它可能会在未达到指定的超时之前返回最新状态(包括立即返回),也就是说,即使立即收到响应,也并不保证操作已完成。

HTTP 请求

POST https://adsdatahub.googleapis.com/v1/{name=operations/**}:wait

网址采用 gRPC 转码语法。

路径参数

参数
name

string

要等待的操作资源的名称。

请求正文

请求正文中包含结构如下的数据:

JSON 表示法
{
  "timeout": string
}
字段
timeout

string (Duration format)

超时之前等待的最长时间。如果将此字段留空,则等待时间最长为底层 HTTP/RPC 协议允许的时间。如果还指定了 RPC 上下文截止时间,则以二者中较短者为准。

该持续时间以秒为单位,最多包含九个小数位,以“s”结尾。示例:"3.5s"

响应正文

如果成功,响应正文将包含一个 Operation 实例。

授权范围

需要以下 OAuth 范围:

  • https://www.googleapis.com/auth/adsdatahub