注意:您正在查看 API 的 REST 介面說明文件。我們的官方用戶端程式庫支援 gRPC。詳情請參閱
REST 簡介。
Method: customers.operations.cancel
開始非同步取消長時間執行的作業。伺服器會盡全力取消作業,但不保證一定會成功。如果伺服器不支援這個方法,就會傳回 google.rpc.Code.UNIMPLEMENTED
。用戶端可以使用 Operations.GetOperation
或其他方法,查看作業是否已成功取消,或是作業即使在用戶端下令取消之後仍然執行完畢。作業在成功取消之後,並不會遭到刪除,而是會成為擁有 Operation.error
值,且 google.rpc.Status.code
為 1
(也就是 Code.CANCELLED
) 的作業。
HTTP 要求
POST https://googleads.googleapis.com/v18/{name=customers/*/operations/*}:cancel
這個網址使用 gRPC 轉碼語法。
路徑參數
參數 |
name |
string
要取消的作業資源名稱。
|
授權範圍
需要下列 OAuth 範圍:
https://www.googleapis.com/auth/adwords
詳情請參閱 OAuth 2.0 總覽。
除非另有註明,否則本頁面中的內容是採用創用 CC 姓名標示 4.0 授權,程式碼範例則為阿帕契 2.0 授權。詳情請參閱《Google Developers 網站政策》。Java 是 Oracle 和/或其關聯企業的註冊商標。
上次更新時間:2024-11-21 (世界標準時間)。
[null,null,["上次更新時間:2024-11-21 (世界標準時間)。"],[[["Initiates an asynchronous cancellation for a running operation, although success isn't assured."],["If supported, upon successful cancellation, the operation isn't removed but marked with an error code signifying cancellation."],["The request requires an empty body and uses the operation's name as a path parameter."],["Authorization necessitates the `https://www.googleapis.com/auth/adwords` OAuth scope."],["Clients can monitor cancellation status through alternative methods like `Operations.GetOperation`."]]],[]]