API 한도 및 할당량

Google 포토 API로 전송되는 모든 요청은 할당량에 반영됩니다. 이러한 제한은 시스템과 사용자를 보호하기 위해 마련되었습니다.

API에 액세스하려면 Google 개발자 프로젝트의 OAuth 클라이언트 사용자 인증 정보가 필요합니다. 이 프로젝트에는 앱 구성에 설명된 대로 Photos API가 사용 설정되어 있어야 합니다.

이 API의 적절한 사용에 대해 자세히 알아보려면 Photos API 사용자 데이터 및 개발자 정책을 참고하세요.

API 할당량 한도

각 API에는 Google 시스템의 안정성과 무결성을 보호하기 위한 자체 할당량이 있습니다. 429 오류가 표시되면 이러한 할당량 중 하나에 도달했을 가능성이 높습니다. 이러한 오류 중 하나가 표시되면 특정 기간 동안 전송하는 요청 수를 줄이세요. 자세한 내용은 실패한 요청 재시도지수 백오프를 참고하세요.

선택기 API 할당량 한도

Photos Picker API 요청의 할당량 한도는 프로젝트별로 분당 100,000개 요청입니다.

기본 URL에서 사진이나 동영상을 로드하여 미디어 바이트에 액세스하는 요청의 할당량 한도는 프로젝트별 분당 요청 1,000,000개입니다.

Library API 할당량 한도

Library API 요청의 할당량 한도는 프로젝트당 일일 10,000개 요청입니다. 여기에는 미디어 업로드, 나열, 필터 적용과 같은 모든 API 요청이 포함되지만 기준 URL에서 미디어 바이트에 액세스하는 것은 포함되지 않습니다.

기본 URL에서 사진 또는 동영상을 로드하여 미디어 바이트에 액세스하는 요청의 할당량 한도는 프로젝트당 일일 75,000개 요청입니다.

할당량 사용량 확인

사용 가능한 할당량 중 얼마나 사용했는지 확인하고 프로젝트의 사용 한도를 보거나 변경하려면 Google API 콘솔의 할당량 페이지로 이동하여 Photos Picker API 또는 Photos Library API를 선택하세요.

할당량 한도 초과

Photos API에 대한 요청 할당량이 초과되면 API는 오류 코드 429와 프로젝트가 할당량을 초과했다는 메시지를 반환합니다. 자세한 내용은 서비스 약관을 참고하세요.

추가 할당량 요청

Google 포토 파트너 프로그램은 할당량 한도 증가가 필요한 대규모 소비자 애플리케이션을 대상으로 합니다. 신청이 이 카테고리에 속한다고 생각되면 파트너 프로그램에 관심을 표하세요.

사진 저장 및 품질

API를 사용하여 Google 포토에 업로드된 모든 미디어 항목은 원본 화질로 최대 해상도로 저장됩니다. 이러한 파일은 사용자의 스토리지에 포함됩니다.