將作業新增至批次工作。
擲回錯誤清單:AuthenticationError AuthorizationError BatchJobError HeaderError InternalError QuotaError RequestError ResourceCountLimitExceededError
HTTP 要求
POST https://googleads.googleapis.com/v15/{resourceName=customers/*/batchJobs/*}:addOperations
這個網址使用 gRPC 轉碼語法。
路徑參數
參數 | |
---|---|
resourceName |
必要欄位。批次工作的資源名稱。 |
要求主體
要求主體的資料會採用以下結構:
JSON 表示法 |
---|
{
"sequenceToken": string,
"mutateOperations": [
{
object ( |
欄位 | |
---|---|
sequenceToken |
用於強制執行序列的權杖。 批次工作的第一個 batchJobs.addOperations 要求不應設定 sequenceToken。後續要求必須將 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 |
需要新增作業時,再次呼叫 bulkJob.addOperations 時使用的序列符記。下一個批次工作.addOperations 要求必須將 orderToken 欄位設為此欄位的值。 |
授權範圍
需要下列 OAuth 範圍:
https://www.googleapis.com/auth/adwords
詳情請參閱 OAuth 2.0 總覽。