대부분의 서비스는 동기 API를 제공하여 요청을 한 후 응답을 기다려야 하는 반면, BatchJobService
는 작업이 완료될 때까지 동기식으로 대기하지 않고도 여러 서비스에서 일괄 작업을 실행할 수 있는 방법을 제공합니다.
서비스별 변경 작업과 달리 BatchJobService
의 단일 작업은 캠페인, 광고그룹, 광고, 기준, 라벨, 피드 항목이 혼합된 모음에서 작동할 수 있습니다.
제출된 작업은 동시에 실행되며 BatchJobService
는 비율 제한 오류와 같은 일시적인 오류로 인해 실패한 작업을 자동으로 재시도합니다. Google Ads API에서는 계속해서 API 작업 집계 안내에 따라 각 작업을 일일 작업 한도에 반영합니다.
또한 BatchJobService
를 사용하면 요청 내에서 임시 ID를 사용할 수 있으므로 종속 작업을 단일 작업으로 제출할 수 있습니다.
운영
BatchJobService
는 몇 가지 중요한 예외를 제외하고 MutateOperation
에 나열된 모든 작업을 지원합니다.
Google Ads API는 부분 실패가 사용 설정된 작업의 모든 작업을 실행하므로 작업이 취소되거나 개별 작업이 실패하는 경우 성공한 작업은 롤백되지 않습니다.
MutateOperation
의 다음 작업은 원자여야 하므로 부분 실패를 지원하지 않으며 일괄 작업 내에서 지원되지 않습니다. 작업에 추가하지 말고 요청에서 partial_failure
를 false
로 설정하고 GoogleAdsService
의 mutate
메서드를 대신 사용하세요.
BatchJobService에서 지원되지 않는 작업
AssetGroupOperation
CampaignConversionGoalOperation
ConversionGoalCampaignConfigOperation
CustomConversionGoalOperation
CustomerConversionGoalOperation
CustomerOperation