판매자 API 설계

Merchant API는 Content API for Shopping 개발자에게 친숙하면서도 더 간단하고 유연하도록 설계되었습니다. 다음은 Merchant API 설계에 관한 자세한 정보입니다.

하위 API

Merchant API는 하위 API 모음입니다. 하위 API는 관련 서비스와 리소스의 그룹입니다. 이 설계에 따라 고유한 통합에 필요한 하위 API만 선택하여 사용할 수 있습니다.

Merchant API에는 다음 하위 API가 포함됩니다.

  • 계정: 판매자 센터 계정을 대규모로 관리합니다.
  • 제품: 가격, 재고 등 제품 데이터를 관리합니다.
  • 데이터 소스: 제품의 데이터 소스를 보고 관리합니다.
  • 인벤토리: Google에서 매장 또는 지역별로 제품을 표시합니다.
  • 보고서: Google 전반의 제품, 실적, 경쟁 현황에 관한 데이터를 확인합니다.
  • 프로모션: 제품의 특별 혜택을 표시하는 프로모션을 만들고 관리합니다.
  • 오프라인 피드 파트너십: 오프라인 제품 인벤토리 피드를 업로드합니다.
  • 전환 소스: 계정의 전환 소스를 관리합니다.
  • 알림: 알림 구독을 관리합니다.
  • 할당량: 계정의 API 할당량을 확인합니다.

전송

Merchant API의 기본 전송 메커니즘은 gRPC입니다. REST를 사용할 수도 있습니다.

자세한 내용은 빠른 시작 가이드를 참고하세요.

열거형

향후 Merchant API의 enum 필드에 새로운 값이 노출될 수 있습니다. 코드는 인식할 수 없는 값을 정상적으로 처리할 수 있도록 구조화되어야 합니다. 인식할 수 없는 enum 값의 발생을 모니터링하고 코드를 최신 상태로 유지하기 위해 개입해야 합니다.

버전 관리

하위 API는 별도로 버전이 지정됩니다. 즉, 사용하지 않는 하위 API가 업데이트되는 경우 아무 조치도 취하지 않아도 됩니다. 사용하는 하위 API의 새 버전이 출시될 때만 코드를 업데이트하면 됩니다. 자세한 내용은 버전 관리를 참조하세요.

'베타'로 끝나는 버전은 변경되거나 삭제될 수 있습니다.

이전
Overview
다음
Quickstart