API 요청의 한도 및 할당량
컬렉션을 사용해 정리하기
내 환경설정을 기준으로 콘텐츠를 저장하고 분류하세요.
Google에서는 시스템이 처리할 수 있는 것보다 더 많은 데이터를 수신하지 않도록 하고 시스템 리소스의 공정한 분배를 보장하기 위해 API 요청에 한도와 할당량을 적용합니다. 한도 및 할당량은 변경될 수 있습니다.
비율 제한
API 비율 한도를 사용하면 Google Marketing Platform Admin API에 전송할 수 있는 요청 수를 정의할 수 있습니다. 비율 제한이 적용되고 60초(1분) 간격으로 자동으로 다시 채워집니다. 즉, 프로젝트가 60초 내에 언제든지 비율 제한의 최댓값에 도달하면 해당 그룹에서 요청을 더 수행하기 전 할당량이 다시 채워질 때까지 기다려야 합니다. 프로젝트가 비율 제한을 초과하면 rateLimitExceeded 이유와 함께 403 오류가 수신됩니다. 이 오류를 해결하려면 1분을 기다린 후 다시 요청을 시도해야 합니다. 다음 간격이 시작될 때 할당량이 다시 채워집니다.
일일 API 요청 최대 개수는 API 비율 제한에 따라 자연스럽게 제한되며 현재 Google Marketing Platform Admin API에는 명시적인 일일 사용량 할당량이 없습니다.
Cloud 프로젝트 할당량
API 비율 제한은 프로젝트별로 적용됩니다.
Cloud 콘솔에는 Cloud 프로젝트의 할당량이 표시됩니다.https://console.cloud.google.com/apis/api/marketingplatformadmin.googleapis.com/quotas
다음은 대부분의 사용자가 콘솔에서 확인할 수 있는 Google Marketing Platform Admin API의 기본 할당량입니다.
| 할당량 이름 |
한도 |
| 분당 요청 수 |
1,200 |
| 사용자별 분당 요청 수 |
600 |
| 분당 쓰기 |
300 |
| 사용자당 분당 쓰기 수 |
120 |
Google Marketing Platform Admin API에 대한 각 요청은 Requests per minute,
Requests per minute per user 할당량을 사용합니다. 어떤 식으로든 Google Marketing Platform 계정 구성을 변경하는 메서드 (create, patch, delete, archive, update 메서드)에 대한 요청도 Writes per minute 및 Writes per minute per user 할당량을 사용합니다.
사용자별로 API 요청을 제한하는 방법에 관한 자세한 내용은 API 사용량 상한 설정 도움말을 참고하세요.
달리 명시되지 않는 한 이 페이지의 콘텐츠에는 Creative Commons Attribution 4.0 라이선스에 따라 라이선스가 부여되며, 코드 샘플에는 Apache 2.0 라이선스에 따라 라이선스가 부여됩니다. 자세한 내용은 Google Developers 사이트 정책을 참조하세요. 자바는 Oracle 및/또는 Oracle 계열사의 등록 상표입니다.
최종 업데이트: 2025-01-24(UTC)
[[["이해하기 쉬움","easyToUnderstand","thumb-up"],["문제가 해결됨","solvedMyProblem","thumb-up"],["기타","otherUp","thumb-up"]],[["필요한 정보가 없음","missingTheInformationINeed","thumb-down"],["너무 복잡함/단계 수가 너무 많음","tooComplicatedTooManySteps","thumb-down"],["오래됨","outOfDate","thumb-down"],["번역 문제","translationIssue","thumb-down"],["샘플/코드 문제","samplesCodeIssue","thumb-down"],["기타","otherDown","thumb-down"]],["최종 업데이트: 2025-01-24(UTC)"],[[["The Google Marketing Platform Admin API has rate limits to ensure fair usage and system stability, replenishing every 60 seconds."],["Exceeding these limits results in a 403 error, requiring a brief pause before retrying."],["While daily usage is implicitly limited by per-minute rates, there's no separate daily quota."],["Quotas are project-specific and categorized into requests/writes per minute, further divided by per-user limits."],["Users can manage per-user API request limitations through features detailed in the \"Capping API usage\" article."]]],[]]
