일괄 처리

대부분의 서비스는 요청을 한 후 응답을 기다려야 하는 동기식 API를 제공하지만 BatchJobService 는 작업이 완료될 때까지 동기식으로 기다리지 않고 여러 서비스에서 일괄 작업을 실행하는 방법을 제공합니다.

서비스별 변경 작업과 달리 BatchJobService의 단일 작업은 캠페인, 광고그룹, 광고, 타겟, 라벨, 피드 항목의 혼합 컬렉션을 대상으로 작동할 수 있습니다. 제출된 작업은 병렬로 실행되며 BatchJobService 속도 제한 오류와 같은 일시적인 오류로 인해 실패한 작업을 자동으로 재시도합니다. Google Ads API는 API 작업 수 계산 안내에 따라 각 작업을 일일 작업 한도에 계속 집계합니다.

BatchJobService를 사용하면 요청 내에서 임시 ID를 사용하여 종속 작업을 단일 작업으로 제출할 수 있습니다.

참고: BatchJobService를 사용하면 전송되는 요청 수를 줄일 수 있지만, 요구사항에 적합한지 평가해야 합니다. 일괄 처리를 사용하는 주된 이유는 API 요청 수를 최소화하고 일시적인 오류로 인해 실패한 작업을 재시도하기 위해서입니다. 이렇게 해도 처리량이 늘어나거나 작업 완료 시간이 단축되는 등 성능이 향상된다고 보장할 수는 없습니다. 일괄 처리와 비일괄 처리의 다양한 조합을 실험하여 상황에 가장 적합한 솔루션을 결정하세요.

작업

BatchJobService는 몇 가지 중요한 예외를 제외하고 MutateOperation에 나열된 모든 작업을 지원합니다.

Google Ads API는 부분 실패가 사용 설정된 작업의 모든 작업을 실행하므로 작업이 취소되거나 개별 작업이 실패하면 성공한 작업은 롤백되지 않습니다.

MutateOperation의 다음 작업은 원자적이어야 하므로 부분 실패를 지원하지 않으며 일괄 작업 내에서 지원되지 않습니다. 작업에 이러한 작업을 추가하지 말고 요청에서 partial_failure를 false로 설정한 후 mutate 메서드를 GoogleAdsService 대신 사용하세요.

BatchJobService에서 지원되지 않는 작업

• CampaignConversionGoalOperation
• ConversionGoalCampaignConfigOperation
• CustomConversionGoalOperation
• CustomerConversionGoalOperation
• CustomerOperation