일괄 작업에 작업을 추가합니다.
발생한 오류 목록: AuthenticationError AuthorizationError BatchJobError HeaderError InternalError QuotaError RequestError ResourceCountLimitExceededError
HTTP 요청
POST https://googleads.googleapis.com/v16/{resourceName=customers/*/batchJobs/*}:addOperations
URL은 gRPC 트랜스코딩 문법을 사용합니다.
경로 매개변수
매개변수 | |
---|---|
resourceName |
필수 항목입니다. 일괄 작업의 리소스 이름입니다. |
요청 본문
요청 본문에는 다음과 같은 구조의 데이터가 포함됩니다.
JSON 표현 |
---|
{
"sequenceToken": string,
"mutateOperations": [
{
object ( |
필드 | |
---|---|
sequenceToken |
시퀀싱을 적용하는 데 사용되는 토큰입니다. 일괄 작업의 첫 번째 batchJobs.addOperations 요청에서는 시퀀스Token을 설정해서는 안 됩니다. 이후 요청에서는 시퀀스Token을 이전 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 요청에서 시퀀스 토큰 필드를 이 필드의 값으로 설정해야 합니다. |
승인 범위
다음 OAuth 범위가 필요합니다.
https://www.googleapis.com/auth/adwords
자세한 내용은 OAuth 2.0 개요를 참고하세요.