Method: customers.batchJobs.addOperations

일괄 작업에 작업을 추가합니다.

발생한 오류 목록: AuthenticationError AuthorizationError BatchJobError HeaderError InternalError QuotaError RequestError ResourceCountLimitExceededError

HTTP 요청

POST https://googleads.googleapis.com/v20/{resourceName=customers/*/batchJobs/*}:addOperations

URL은 gRPC 트랜스코딩 문법을 사용합니다.

경로 매개변수

매개변수
resourceName

string

필수 항목입니다. 일괄 작업의 리소스 이름입니다.

요청 본문

요청 본문에는 다음과 같은 구조의 데이터가 포함됩니다.

JSON 표현 
{
  "sequenceToken": string,
  "mutateOperations": [
    {
      object (MutateOperation)
    }
  ]
}
필드
sequenceToken

string

시퀀싱을 적용하는 데 사용되는 토큰입니다.

일괄 작업의 첫 번째 batchJobs.addOperations 요청은 sequenceToken을 설정해서는 안 됩니다. 후속 요청은 sequenceToken을 이전 batchJobs.addOperations 응답에서 수신한 nextSequenceToken 값으로 설정해야 합니다.
mutateOperations[]

object (MutateOperation)

필수 항목입니다. 추가되는 변형 목록입니다.

작업은 음수 정수를 임시 ID로 사용하여 이 일괄 작업에서 생성된 항목 간의 종속 항목을 나타낼 수 있습니다. 예를 들어 ID가 1234인 고객은 첫 번째 작업에서 리소스 이름을 'customers/1234/campaigns/-1'로 명시적으로 설정하여 캠페인을 만들고, 두 번째 작업에서 캠페인 입력란을 'customers/1234/campaigns/-1'로 설정하여 동일한 캠페인에 캠페인과 광고 그룹을 만들 수 있습니다.

응답 본문

BatchJobService.AddBatchJobOperations의 응답 메시지입니다.

성공한 경우 응답 본문은 다음과 같은 구조의 데이터를 포함합니다.

JSON 표현 
{
  "totalOperations": string,
  "nextSequenceToken": string
}
필드
totalOperations

string (int64 format)

이 일괄 작업에 지금까지 추가된 총 작업 수입니다.
nextSequenceToken

string

더 많은 작업을 추가해야 하는 경우 batchJobs.addOperations를 다시 호출할 때 사용할 시퀀스 토큰입니다. 다음 batchJobs.addOperations 요청은 sequenceToken 필드를 이 필드의 값으로 설정해야 합니다.

승인 범위

다음 OAuth 범위가 필요합니다.

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

자세한 내용은 OAuth 2.0 Overview를 참조하세요.