한도 및 할당량을 통해 부적절한 방식으로 Alert Center API를 사용하는 자동화된 프로세스로부터 Google 인프라를 보호할 수 있습니다. API의 과도한 요청은 무해한 오타에서 비롯되거나 불필요한 API 호출을 하는 비효율적으로 설계된 시스템이 원인일 수 있습니다. 원인과 관계없이 특정 소스의 트래픽이 일정 수준에 도달하면 Google Workspace 시스템의 전반적인 상태를 유지하기 위해 해당 소스의 트래픽을 차단해야 합니다. 한 개발자의 행동이 더 큰 커뮤니티에 부정적인 영향을 미치지 않도록 합니다.
드물지만 API 요청이 실패하면 HTTP 상태 코드 응답을 받게 됩니다. 403 상태 코드에는 잘못된 입력에 대한 오류 정보가 있고 HTTP 상태 코드 503에는 어떤 API 할당량이 초과되었는지를 나타내는 오류 정보가 있습니다. 이러한 응답을 통해 커스텀 애플리케이션이 이러한 오류를 감지하고 적절한 조치를 취할 수 있습니다.
정해진 시간 내에 요청을 완료해야 하는 경우 요청을 병렬로 보내거나 Java 또는 C# 애플리케이션에서 여러 스레드를 사용합니다. 일례로 한 사용자의 많은 이메일을 동시에 추가하거나 삭제하지 않고 다른 사용자에게서 소량의 이메일을 일괄 요청하는 경우를 병렬 요청의 예로 들 수 있습니다. 대화목록의 경우 사용자 이메일당 하나의 대화목록, 10개의 대화목록으로 시작해 보세요. 스레드 권장사항에는 장단점이 있으며 모든 API 상황에 유용하지는 않습니다. 요청 수가 너무 많으면 할당량 오류가 발생합니다.
시간 기반 오류 (스레드당 N초당 최대 N개), 특히 503 상태 코드 오류의 경우 코드가 예외를 포착하고 지수 백오프 알고리즘을 사용하여 약간의 지연을 기다린 후에 실패한 호출을 다시 시도하는 것이 좋습니다. 한 스레드에 대한 Alert Center API 예는 5초 동안 대기한 후 실패한 호출을 다시 시도하는 것입니다. 요청이 성공하면 다른 스레드에 대해 이 패턴을 반복합니다. 두 번째 요청이 실패하면 애플리케이션은 호출이 성공할 때까지 요청 빈도를 다시 축소해야 합니다. 예를 들어 처음 5초의 지연 시간을 10초로 늘린 후 실패한 호출을 다시 시도합니다. 재시도 한도도 결정합니다. 예를 들어 애플리케이션이 사용자에게 오류를 반환하기 전에 서로 다른 지연 시간으로 요청을 5~7회 재시도합니다.
| API 제한 카테고리 | 한도 |
|---|---|
| 알림 센터 QPS 및 QPD 비율 | API는 API 콘솔 프로젝트에 대한 요청 수를 제한합니다. API 프로젝트의 초당 최대 요청 수 (프로젝트 QPS)는 1,000입니다. 또한 사용자당 초당 최대 요청 수 (사용자 QPS)는 150입니다.
이 제한을 초과하면 서버에서 HTTP |
| 기타 한도 유형 | 제한사항 및 가이드라인 |
|---|---|
| 데이터 형식, 기본값 | 기본 데이터 형식은 JSON입니다. |
| 승인되지 않은 요청 | Google은 이 API에 대한 승인되지 않은 요청을 허용하지 않습니다. 승인 토큰이 제공되지 않으면 요청이 승인되지 않은 것으로 간주됩니다. 자세한 내용은 요청 승인을 참조하세요. |
프로젝트당 할당량 상향 요청
프로젝트의 리소스 사용량에 따라 할당량 증가를 요청할 수 있습니다. 서비스 계정을 통한 API 호출은 단일 계정을 사용하는 것으로 간주됩니다. 할당량 증가를 신청한다고 해서 반드시 승인되는 것은 아닙니다. 할당량을 크게 늘리면 승인되기까지 시간이 더 걸릴 수 있습니다.
모든 프로젝트의 할당량이 동일하지는 않습니다. 시간이 지남에 따라 Google Cloud를 점점 더 많이 사용하면 할당량을 늘려야 할 수도 있습니다. 앞으로 사용량이 현저하게 늘어날 것으로 예상되는 경우 Google Cloud 콘솔의 할당량 페이지에서 사전에 할당량 조정을 요청할 수 있습니다.
자세한 내용은 다음 리소스를 참조하세요.