이 페이지는 Cloud Translation API를 통해 번역되었습니다.

Merchant API 개요

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

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

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

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

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

Merchant API의 새로운 기능

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

다음과 같은 새로운 메서드가 도입되어 인벤토리 데이터를 더 효과적으로 관리할 수 있습니다.
보조 데이터 소스를 생성 및 검색하고 보조 데이터 소스를 기본 데이터 소스에 연결하여 보조 데이터 소스를 관리할 수 있습니다.
제품 데이터 변경사항 알림을 사용 설정하여 제품 상태가 변경될 때 알림을 보내므로 주기적으로 가져올 필요가 없습니다.
accounts.autofeedSettings 리소스와 자동 피드 설정을 가져오고 업데이트하는 메서드를 소개합니다.
제품 리뷰 및 판매자 리뷰 업로드가 도입됩니다.
accounts.productInputs 리소스 도입으로 accounts.products 리소스가 간소화되었습니다.
파일과 같은 다른 데이터 업로드 방법과 함께 제품 데이터를 업데이트할 수 있습니다.
소매업체 웹사이트로 유입되는 트래픽에 관한 정보와 같은 제품 외 실적 데이터를 위한 새로운 NonProductPerformanceView 표
격리되고 더 자주 기능이 개선되는 모듈식 설계
Google의 API 개선 제안과의 일관성이 개선되었습니다.
문서 및 코드 샘플이 업데이트되었습니다.
개발자 등록을 통해 개발자를 위한 지원 및 커뮤니케이션이 개선되었습니다.

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

시작하기 전에

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

판매자 센터 계정: 데이터를 쿼리하고 업데이트하고 업로드할 계정입니다. 이 계정에서 제품과 인벤토리를 관리하는 데 필요한 권한이 있는지 확인합니다.
Google Cloud 프로젝트: 프로젝트는 계정에 대한 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}

:{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는 gRPC 및 REST를 지원합니다. Merchant API를 호출하는 방법에는 다음 두 가지가 있습니다.

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

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

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

도움말 보기

지원에 관한 자세한 내용은 Merchant API 관련 도움 받기를 참고하세요.

의견 보내기

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

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

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

다음 단계

하위 호환성에 대한 자세한 내용은 Content API for Shopping 호환성을 참고하세요.
Merchant API의 주요 기능에 대해 자세히 알아보려면 왼쪽 탐색 메뉴의 가이드를 참고하세요.
사용 가능한 리소스 및 서비스에 대한 자세한 내용은 참고 문서를 참고하세요.

Latest updates

Design