일괄 작업에 작업을 추가합니다.
발생하는 오류 목록: 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 요청은 serialToken을 설정하면 안 됩니다. 후속 요청에서는 시퀀스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 요청에서 시퀀스Token 필드를 이 필드의 값으로 설정해야 합니다. |
승인 범위
다음 OAuth 범위가 필요합니다.
https://www.googleapis.com/auth/adwords
자세한 내용은 OAuth 2.0 개요를 참고하세요.