Merchant API 개요

이 페이지에서는 Merchant API를 소개하고 이를 사용하여 판매자 센터에서 계정, 제품, 인벤토리 관리와 관련된 다양한 워크플로를 자동화하는 방법을 설명합니다.

Merchant API를 사용하여 더 많은 고객에게 도달하고 Google 서비스 전반에서 제품을 홍보할 수 있습니다. Merchant API를 사용하면 대규모이거나 복잡한 판매자 센터 계정을 관리할 수 있습니다. 일반적인 사용 사례는 다음과 같습니다.

  • 자동 계정 관리
  • 자동화된 제품 관리
  • 자동화된 인벤토리 관리
  • 맞춤 보고서

Merchant API를 사용하면 여러 데이터 소스를 만들고 관리하여 제품, 프로모션, 리뷰에 관한 정보를 더 효과적으로 구성할 수 있습니다. Merchant API를 사용하면 파일 및 자동 피드와 같은 다른 제품 데이터 업로드 방법을 보완하는 방식으로 제품을 관리할 수 있습니다.

Merchant API는 Content API for Shopping재설계이며 여러 하위 API로 구성됩니다.

소매업체는 쇼핑 광고무료 등록정보 정책을 준수할 책임이 있습니다. Google 쇼핑은 이러한 정책을 시행하고 이러한 정책을 위반하는 콘텐츠나 행동을 발견하면 적절하게 대응할 권리를 보유합니다.

Merchant API의 새로운 기능

Merchant API로 업그레이드해야 하는 몇 가지 이유는 다음과 같습니다.

자세한 내용은 Merchant API 베타에 도입된 새로운 기능을 참고하세요.

시작하기 전에

Merchant API 요청을 실행하려면 다음이 필요합니다.

  • 판매자 센터 계정: 데이터를 쿼리, 업데이트, 업로드할 계정입니다. 이 계정에서 제품 및 인벤토리를 관리하는 데 필요한 권한이 있는지 확인합니다.

  • Google Cloud 프로젝트: 이 프로젝트는 계정에 대한 API 액세스 권한을 얻는 데 사용됩니다.

Merchant API를 통한 인증

인증에 사용할 수 있는 옵션은 다음과 같습니다.

  • 앱에 OAuth 2.0 클라이언트 ID 및 비밀번호를 생성할 수 있습니다. 그런 다음 이 ID와 비밀번호를 사용하여 판매자 센터 계정에 대한 API 호출에 필요한 OAuth 2.0 사용자 인증 정보를 생성할 수 있습니다.
  • 서비스 계정을 만들고 비공개 키를 다운로드하여 API를 호출할 수 있습니다.

계정 및 제품 식별자

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

요청 URL 형식

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

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

list 및 get과 같은 표준 메서드의 경우 :{METHOD} 부분이 생략됩니다.

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

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

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

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

예를 들어 다음 요청은 accounts/123456새 리전을 만드는 방법을 보여줍니다.

POST https://merchantapi.googleapis.com/accounts/v1beta/accounts/123456/regions?regionId=WA HTTP/1.1

{
  "displayName": "Washington",
  "name": "Washington",
  "postalCodeArea": {
    "postalCodes": [
      {
        "begin": "98039",
        "end": "98118"
      }
    ],
    "regionCode": "US"
  }
}

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

Merchant API 사용 시작하기

Merchant API의 작동 방식을 빠르게 확인하고 샘플 제품을 업로드하려면 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. 결과를 해석합니다.

클라이언트 라이브러리 및 코드 샘플 사용

각 하위 API에는 시작하는 데 도움이 되는 클라이언트 라이브러리가 있습니다. 코드 샘플을 사용하면 Java, PHP, Python으로 코드 작성을 시작할 수 있습니다. 자세한 내용은 Merchant API 샘플을 참고하세요.

도움말 보기

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

의견 보내기

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

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

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

다음 단계

  • 하위 호환성에 관한 자세한 내용은 Content API for Shopping 호환성을 참고하세요.

  • Merchant API의 주요 기능에 대해 자세히 알아보려면 왼쪽 탐색 메뉴의 가이드를 참고하세요.

  • 사용 가능한 리소스 및 서비스에 대한 자세한 내용은 참조 문서를 참고하세요.