Merchant API 개요

Merchant API를 사용하면 다음 작업을 할 수 있습니다.

  • Google에 비즈니스 및 제품이 표시되는 방식을 관리합니다.
  • 데이터, 통계, 고유한 기능에 프로그래매틱 방식으로 액세스합니다.
  • Google에서 비즈니스를 성장시키고 더 많은 고객에게 도달합니다.

Merchant API는 대규모 또는 복잡한 판매자 센터 계정을 관리할 수 있습니다. 일반적인 사용 사례는 다음과 같습니다.

  • 자동 계정 관리
  • 자동 제품 관리
  • 자동 인벤토리 관리
  • 실적 및 시장 통계에 대한 자동 보고서 관리

Merchant API를 사용하면 여러 데이터 소스를 만들고 관리하여 제품, 프로모션, 리뷰에 관한 정보를 더 효과적으로 정리할 수 있습니다. Merchant API를 사용하면 다른 제품의 데이터 업로드 방법(예: 파일, 자동 피드)을 보완하는 방식으로 제품을 관리할 수 있으며, Merchant API를 사용하면 여러 개별 요청을 동시에 실행할 수도 있습니다.

Merchant API는 Content API for Shopping을 재설계한 것입니다. 여러 하위 API로 구성됩니다.

Merchant API의 새로운 기능

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

시작하기 전에

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

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

  • Google Cloud 프로젝트: 프로젝트를 사용하여 계정에 대한 API 액세스 권한을 얻습니다.

  • 판매자 센터 계정에서 Google Cloud 프로젝트로 연결되는 링크 개발자 등록 메서드를 호출하여 링크를 만듭니다. 이 계정과 이러한 사용자는 API 통합, 설문조사, 추천 항목에 관한 커뮤니케이션에 사용됩니다.

  • 개발자로 등록하여 판매자 센터 계정을 Google Cloud 프로젝트에 연결합니다 . API 개발자 역할이 있는 사용자는 필수 서비스 공지, 개발자 설문조사, 추천 항목이 포함된 API 커뮤니케이션을 받게 됩니다.

Merchant API를 사용한 인증

인증에 다음 옵션을 사용할 수 있습니다.

계정 및 제품 식별자

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

요청 URL 형식

리소스에서 작동하려면 다음 형식으로 URL에 요청을 보냅니다.

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

:{METHOD} 부분은 목록 및 가져오기와 같은 표준 메서드에서 생략됩니다.

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

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

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

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

예를 들어 다음 요청은 create a region for accounts/123456을(를) 만드는 방법을 보여줍니다.

POST https://merchantapi.googleapis.com/accounts/v1/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는 gRPC 및 REST를 지원합니다. 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의 주요 기능에 관한 자세한 내용은 왼쪽 탐색 메뉴의 가이드를 참고하세요.

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

이전
Latest updates
다음
Design