等待指定的长时间运行的操作完成或最多达到指定的超时,返回最新状态。如果操作已完成,则立即返回最新状态。如果指定的超时大于默认的 HTTP/RPC 超时,则使用 HTTP/RPC 超时。如果服务器不支持此方法,则会返回 google.rpc.Code.UNIMPLEMENTED
。请注意,此方法会尽力执行命令。它可能会在未达到指定的超时之前返回最新状态(包括立即返回),也就是说,即使立即收到响应,也并不保证操作已完成。
HTTP 请求
POST https://adsdatahub.googleapis.com/v1/{name=operations/**}:wait
网址采用 gRPC 转码语法。
路径参数
参数 | |
---|---|
name |
要等待的操作资源的名称。 |
请求正文
请求正文中包含结构如下的数据:
JSON 表示法 |
---|
{ "timeout": string } |
字段 | |
---|---|
timeout |
超时之前等待的最长时间。如果将此字段留空,则等待时间最长为底层 HTTP/RPC 协议允许的时间。如果还指定了 RPC 上下文截止时间,则以二者中较短者为准。 该持续时间以秒为单位,最多包含九个小数位,以“ |
响应正文
如果成功,响应正文将包含一个 Operation
实例。
授权范围
需要以下 OAuth 范围:
https://www.googleapis.com/auth/adsdatahub