將作業新增至批次工作。
擲回錯誤清單:AuthenticationError AuthorizationError BatchJobError HeaderError InternalError QuotaError RequestError ResourceCountLimitExceededError
HTTP 要求
POST https://googleads.googleapis.com/v16/{resourceName=customers/*/batchJobs/*}:addOperations
這個網址使用 gRPC 轉碼語法。
路徑參數
參數 | |
---|---|
resourceName |
必要欄位。批次工作的資源名稱。 |
要求主體
要求主體的資料會採用以下結構:
JSON 表示法 |
---|
{
"sequenceToken": string,
"mutateOperations": [
{
object ( |
欄位 | |
---|---|
sequenceToken |
用於強制執行序列的符記。 第一個批次工作批次工作 (BatchJobs.addOperations ) 不應設定 orderToken。後續要求必須將 orderToken 設為先前 BatchJobs.addOperations 回應中收到的 nextSequenceToken 的值。 |
mutateOperations[] |
必要欄位。要新增的變更清單。 作業可以使用負整數做為暫存 ID,以表示在這個批次工作中建立的實體之間的依附關係。舉例來說,ID 為 1234 的客戶可以在第一個作業中建立廣告活動,並將資源名稱明確設為「customers/1234/campaigns/-1」,然後在第二個作業中建立廣告群組,並將廣告活動欄位設為「customers/1234/campaigns/-1」,這樣就能在同一個廣告活動中建立廣告活動和廣告群組。 |
回應主體
「BatchJobService.AddBatchJobOperations
」的回應訊息。
如果成功,回應主體即會包含具有以下結構的資料:
JSON 表示法 |
---|
{ "totalOperations": string, "nextSequenceToken": string } |
欄位 | |
---|---|
totalOperations |
目前為止為這個批次工作新增的作業總數。 |
nextSequenceToken |
如果需要更多作業,再次呼叫 batchJobs.addOperations 時使用的序列憑證。下一個 BatchJobs.addOperations 要求必須將「serialToken」欄位設為這個欄位的值。 |
授權範圍
需要下列 OAuth 範圍:
https://www.googleapis.com/auth/adwords
詳情請參閱 OAuth 2.0 總覽。