Google Content API for Shopping은 2026년 8월 18일 에 공식적으로 지원 종료되었습니다. 모든 개발자는 가능한 한 빨리 기존 통합을 Merchant API로 이전해야 합니다.
완전한 사용 중단 전에 이전을 장려하고 개발자가 애플리케이션 로그에서 지원 중단 알림을 준수하도록 하기 위해 Google은 2026년 9월 1일 부터 점진적인 서비스 저하 프로세스를 도입합니다.
지원 종료 일정
다음 표에서는 Google Content API for Shopping (v2.1)의 서비스 저하 및 최종 사용 중단 일정을 간략하게 설명합니다.
| 날짜 | Milestone | 세부정보 |
|---|---|---|
| 2026년 9월 1일 | 간헐적으로 실패하는 요청 도입 | 활성 확장 프로그램이 없는 요청이 HTTP 410 Gone으로 간헐적으로 실패하기 시작합니다. |
| 2027년 초 | 사용 중단 | 완전한 종료. 모든 엔드포인트가 종료되고 모든 요청이 실패합니다. |
서비스 저하 및 오류 응답
2026년 9월 1일부터 활성 확장 프로그램이 없는 클라이언트에서 Google Content API for Shopping 엔드포인트로 전송된 요청이 HTTP 410 Gone 상태 코드로 간헐적으로 실패합니다.
오류 응답 형식
예정된 서비스 저하의 일환으로 요청이 거부되면 API는 Google Cloud 프로젝트 세부정보가 포함된 메시지 및 메타데이터가 포함된 HTTP 410 Gone 오류 페이로드를 반환합니다.
{
"error": {
"code": 410,
"message": "Content API for Shopping was sunset on August 18, 2026 for GCP project with id YOUR_PROJECT_ID and number 123456789012. Please migrate to the Merchant API v1 version. See https://developers.google.com/merchant/api/guides/compatibility for more details",
"status": "ABORTED",
"details": [
{
"@type": "type.googleapis.com/google.rpc.ErrorInfo",
"reason": "content_api_sunset",
"domain": "shoppingcontent.googleapis.com",
"metadata": {
"GCP_ID": "YOUR_PROJECT_ID",
"GCP_NUMBER": "YOUR_PROJECT_NUMBER",
"HELP_CENTER_LINK": "https://developers.google.com/merchant/api/guides/compatibility"
}
}
]
}
}
오류 응답에는 다음 메타데이터 필드가 포함됩니다.
GCP_ID: 요청을 하는 Google Cloud 프로젝트의 ID입니다.GCP_NUMBER: Google Cloud 프로젝트의 고유한 숫자 식별자입니다.HELP_CENTER_LINK: 이전 문서로 연결되는 직접 링크입니다.
할당량 영향
서비스 저하 중에 생성된 인공 오류 응답은 프로젝트의 API 할당량에 포함되지 않습니다.
실패한 요청 재시도
초기 서비스 저하로 인해 요청의 일부만 실패하므로 실패한 요청을 재시도하면 성공할 수 있습니다. 하지만 재시도에 의존하는 것은 장기적으로 실행 가능한 솔루션이 아닙니다. 사용 중단 시 모든 요청이 실패할 때까지 실패하는 요청이 더 자주 발생하기 때문입니다.
영향을 받는 개발자
지원 종료 및 서비스 저하 프로세스는 다음과 같이 개발자와 비즈니스에 적용됩니다.
- 커스텀 API 통합: 조직에서 Google Content API for Shopping을 직접 호출하는 내부 도구, 스크립트 또는 커스텀 소프트웨어를 유지관리하는 경우 Merchant API를 호출하도록 애플리케이션을 업데이트해야 합니다.
- 서드 파티 플랫폼: 전자상거래 플랫폼을 통해 판매자 센터에 액세스하는 경우 플랫폼 파트너가 사용자를 대신하여 이전을 관리합니다. 별도로 취하실 조치는 없습니다.
조치 필요
제품 등록정보 및 계정 관리가 중단되지 않도록 하려면 다음 단계를 따르세요.
- Merchant API 개요 를 검토하여 아키텍처, 인증, 하위 API 구조를 파악합니다.
- Content API for Shopping에서 Merchant API로 이전 가이드에 따라 현재 Content API 서비스의 최신 버전을 확인합니다.
- 프로그래밍 언어에 맞는 최신 Merchant API 클라이언트 라이브러리 를 설치합니다.
- 프로덕션에 배포하기 전에 개발 환경에서 통합을 업데이트하고 테스트합니다.
기한 연장 요청하기
조직에서 이전을 완료하는 데 시간이 더 필요한 경우 Google Cloud 프로젝트를 서비스 저하 오류에서 일시적으로 제외하는 연장을 신청할 수 있습니다. 연장을 요청하려면 Content API 연장 요청 양식을 제출하세요.
승인된 연장은 승인된 연장 기간 동안 예정된 오류 응답으로부터 프로젝트를 보호합니다. 연장은 2027년 초의 최종 사용 중단 이후에는 연장되지 않습니다.