Display & Video 360 API 할당량은 프로젝트가 API에 요청할 수 있는 비율을 제한합니다.
Display & Video 360 API 할당량을 더 효과적으로 사용하려면 다음 권장사항을 따르세요.
광고주 간에 동시에 요청
Display & Video 360 API 할당량은 프로젝트별 및 광고주별로 설정됩니다. 프로젝트 할당량은 프로젝트에서 수행하는 요청을 제한합니다. 광고주 할당량은 프로젝트에서 광고주에게 보낸 요청을 제한합니다.
프로젝트 할당량을 모두 사용하려면 광고주 전반에서 동시에 요청하세요.
list 쿼리 매개변수 사용
list 메서드 쿼리 매개변수를 사용하여 원하는 리소스만 포함합니다. 리소스가 적을수록 목록을 작성하는 데 필요한 요청이 적습니다.
list 메서드는 세 가지 주요 매개변수를 제공합니다.
pageSize는 요청에서 반환할 수 있는 리소스 수를 설정합니다. 기본 페이지 크기는 메서드에 따라 다릅니다. 요청당 더 많은 리소스를 나열하려면 이 값을 가장 높은 값으로 설정하세요.filter은 제공된 기준에 따라 나열된 리소스를 제한합니다. 리소스의 하위 집합만 나열하려면 이 값을 설정하세요. 자세한 내용은 필터 목록 요청을 참고하세요.orderBy는 나열된 리소스를 지정된 속성별로 정렬합니다. 더 적은 요청으로 리소스 목록의 상한 또는 하한을 가져오려면 이 값을 설정하세요.
일괄 및 리소스 전체 함수 사용
일괄 및 리소스 전체 함수는 복잡한 작업을 실행합니다. 이러한 메서드에 대한 단일 요청은 다른 메서드에 대한 여러 요청을 대체할 수 있습니다.
이러한 메서드에 대한 자세한 내용은 일괄 요청을 참고하세요.
캐시 ID
Display & Video 360 API 작업에는 API를 사용하여 가져온 ID가 필요한 경우가 많습니다. 예를 들어 타겟팅 옵션 ID와 Google 잠재고객 ID가 있습니다. ID를 계속 검색하지 않아도 되도록 ID를 로컬에 저장합니다.
지원 중단되거나 삭제된 리소스의 ID를 사용하면 오류가 반환될 수 있습니다. 캐시된 ID를 매주 검색하여 상태를 확인해야 합니다.
지수 백오프 사용
지수 백오프는 오류 처리 전략입니다. 시간을 점점 늘려가며 요청을 다시 시도합니다.
SDF 다운로드 작업과 같은 장기 실행 작업을 폴링하는 동안 지수 백오프 전략을 사용하면 전송되는 요청 수를 줄일 수 있습니다.
Google의 SDF 다운로드 코드 예시에서는 클라이언트 라이브러리와 함께 지수 백오프를 사용합니다. 다음은 지수 백오프 흐름의 예입니다.
get요청으로Operation객체를 검색합니다.done이 true가 아니면 작업이 계속 실행됩니다.- 5초 + 임의의 초를 대기한 후 요청을 재시도합니다.
- 작업을 가져옵니다.
done이 true가 아니면 작업이 계속 실행됩니다.- 10초 + 임의의 초를 기다린 후 요청을 다시 시도합니다.
- 작업을 가져옵니다.
done이 true가 아니면 작업이 계속 실행됩니다.- 20초 + 임의의 초를 기다린 후 요청을 다시 시도합니다.
- 작업을 가져옵니다.
done이 true가 아니면 작업이 계속 실행됩니다.- 40초 + 임의의 초를 대기한 후 요청을 재시도합니다.
- 작업을 가져옵니다.
done이 true가 아니면 작업이 계속 실행됩니다.- 80초 + 임의의 초를 대기한 후 요청을 재시도합니다.
done이 참이 되거나 최대 시간이 경과할 때까지 이 패턴을 계속합니다.