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

Merchant API 개요

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

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

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

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

판매자 API는 Content API for Shopping을 재설계한 것으로 여러 하위 API로 구성됩니다.

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

판매자 API의 새로운 기능

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

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

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

시작하기 전에

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

판매자 센터 계정: 데이터를 쿼리하고 업데이트하고 업로드할 계정입니다. 이 계정의 제품 및 인벤토리를 관리하는 데 필요한 권한이 있는지 확인하세요.
Google Cloud 프로젝트: 프로젝트는 계정에 대한 API 액세스 권한을 얻는 데 사용됩니다.

판매자 API로 인증

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

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

계정 및 제품 식별자

판매자 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} 부분은 list 및 get과 같은 표준 메서드에서 생략됩니다.

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

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"
  }
}

특정 서비스에 대한 자세한 내용은 판매자 API 참조 문서를 확인하세요.

판매자 API 사용 시작하기

판매자 API의 작동 방식을 빠르게 확인하고 샘플 제품을 업로드해 보려면 판매자 API 시작하기를 참고하세요.

gRPC 또는 REST 사용

Merchant API는 gRPC 및 REST를 지원합니다. 다음은 판매자 API를 호출하는 두 가지 방법입니다.

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

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

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

도움말 보기

지원 리소스는 판매자 API 관련 도움말 보기를 참고하세요.

의견 보내기

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

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

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

다음 단계

이전 버전과의 호환성에 대한 자세한 내용은 Content API for Shopping 호환성을 참조하세요.
판매자 API의 주요 기능에 대한 자세한 내용은 왼쪽 탐색 메뉴의 가이드를 참조하세요.
사용 가능한 리소스 및 서비스에 대한 자세한 내용은 참조 문서를 확인하세요.

Latest updates

Design