Method: customers.batchJobs.addOperations

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

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

HTTP 요청

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

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

경로 매개변수

매개변수
resourceName

string

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

요청 본문

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

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

string

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

일괄 작업의 첫 번째 batchJobs.addOperations 요청은 시퀀스Token을 설정해서는 안 됩니다. 후속 요청에서는 시퀀스 토큰을 이전 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 요청에서는 시퀀스 토큰 필드를 이 필드의 값으로 설정해야 합니다.

승인 범위

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

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

자세한 내용은 OAuth 2.0 개요를 참고하세요.