판매자 API 시작하기

시작하려면 Cloud 프로젝트에서 Merchant API를 사용 설정하세요.

Merchant API를 사용하는 방법은 다음과 같습니다.

클라이언트 라이브러리 사용

Merchant API는 여러 하위 API로 구성됩니다.

각 하위 API에는 시작하는 데 도움이 되는 코드 샘플클라이언트 라이브러리가 있습니다.

이미 Content API for Shopping을 사용하고 있다면 Content API for Shopping 호환성을 참고하세요.

요청 보내기

Merchant API는 식별을 위해 ID 대신 리소스 이름을 사용합니다. 제품의 리소스 이름의 예는 accounts/123/products/online~en~US~sku123일 수 있으며 여기서 123는 계정의 고유 식별자이고 online~en~US~sku123는 제품의 고유 식별자입니다.

리소스를 작업하려면 다음 형식의 URL에 요청을 전송합니다.

https://merchantapi.googleapis.com/{SUB_API}/{VERSION}/{RESOURCE_NAME}:{METHOD}

예를 들어 다음 요청은 지역 인벤토리를 삭제합니다.

DELETE https://merchantapi.googleapis.com/inventories/v1beta/accounts/123/products/online~en~US~sku123/regionalInventories/456

새 리소스를 만들려면 상위 리소스의 리소스 이름과 다음 URL을 사용하면 됩니다.

POST https://merchantapi.googleapis.com/{SUB_API}/{VERSION}/{RESOURCE_NAME_OF_PARENT}/{RESOURCE}

예를 들어 account/123의 새 리전을 만드는 방법은 다음과 같습니다.

POST https://merchantapi.googleapis.com/accounts/v1beta/accounts/123/regions

특정 서비스에 관한 자세한 내용은 Merchant API 참조 문서를 참고하세요.

gRPC 또는 REST 사용

Merchant API는 gRPCREST를 지원합니다. Merchant API를 호출하는 방법에는 두 가지가 있습니다.

gRPC (권장) REST
  1. 요청 본문을 프로토콜 버퍼로 만듭니다.
  2. HTTP/2를 사용하여 서버에 요청 본문을 전송합니다.
  3. 응답을 프로토콜 버퍼로 역직렬화합니다.
  4. 결과를 해석합니다.
  1. 요청 본문을 JSON 객체로 만듭니다.
  2. HTTP 1.1을 사용하여 서버로 전송합니다.
  3. 응답을 JSON 객체로 역직렬화합니다.
  4. 결과를 해석합니다.

도움말 보기

지원을 받는 방법에 관한 자세한 내용은 Merchant API 관련 도움말을 참고하세요.

의견 보내기

베타 기간을 통해 정식 버전 출시 전에 사용자의 의견을 수집하고 해결할 수 있습니다. 의견을 제공하려면 다음 중 하나를 제출하세요.

  • API 기능: 의견 양식 제출
  • 문서: 페이지 내 썸네일 평점과 의견 보내기 버튼을 사용합니다.
  • 샘플 및 라이브러리: GitHub의 새 문제 버튼을 사용합니다.

각 태스크를 구현한 후 일반적인 의견을 제공하려면 의견 양식을 사용하세요.