Merchant API 시작하기

이 페이지에서는 Merchant API를 사용하여 판매자 센터 계정을 만들고 샘플 제품을 업로드하는 방법을 설명합니다.

시작하기 전에

Google Cloud 프로젝트에서 Merchant API를 사용 설정합니다.

Google Cloud로 이동

계정 만들기

Merchant API를 사용하려면 판매자 센터 계정이 있어야 합니다. 판매자 센터 계정을 만들려면 판매자 센터 시작하기를 참고하세요.

판매자 센터로 이동

계정 ID 가져오기

accounts.list 메서드를 사용하여 계정 ID를 가져올 수 있습니다.

Google API 탐색기를 사용하여 Merchant API 요청을 실행할 수 있습니다. API 탐색기는 인증에 Google OAuth 2.0을 사용합니다. 요청을 실행하기 전에 Google OAuth 2.0 체크박스가 선택되어 있는지 확인합니다.

OAuth 2.0을 사용하여 인증하려면 Google 계정에 로그인한 다음 API 탐색기에 로그인해야 합니다. 또한 API 탐색기가 제품 등록정보 및 계정을 관리하도록 허용해야 합니다.

다음 요청은 계정 ID를 검색하는 방법을 보여줍니다.

GET https://merchantapi.googleapis.com/accounts/v1beta/accounts

요청이 실행되면 다음과 같은 응답이 표시됩니다.

{
  "accounts": [
    {
      "name": "{ACCOUNT_NAME}",
      "accountId": "{ACCOUNT_ID}",
      "accountName": "{ACCOUNT_DISPLAY_NAME}",
      "timeZone": {
        "id": "America/Los_Angeles"
      },
      "languageCode": "en-US"
    }
  ]
}

다른 요청을 실행하는 데 필요하므로 {ACCOUNT_ID}를 복사합니다.

기본 제품 데이터 소스 만들기

제품을 삽입하려면 기본 제품 데이터 소스가 필요합니다. 다음 요청은 계정에 제품을 삽입하는 데 사용할 수 있는 데이터 소스를 만드는 방법을 보여줍니다.

POST https://merchantapi.googleapis.com/datasources/v1beta/accounts/{ACCOUNT_ID}/dataSources HTTP/1.1

{
  "primaryProductDataSource": {
    "channel": "ONLINE_PRODUCTS",
    "contentLanguage": "en",
    "countries": [
      "US"
    ],
    "feedLabel": "US"
  },
  "name": "primary-data-source",
  "displayName": "Primary Products Data Source"
}

{ACCOUNT_ID}를 생성한 판매자 센터 계정의 ID로 바꿉니다.

이 요청이 실행되면 다음과 같은 응답이 표시됩니다.

{
  "name": "accounts/{ACCOUNT_ID}/dataSources/{DATASOURCE_ID}",
  "dataSourceId": "{DATASOURCE_ID}",
  "displayName": "Primary Products Data Source",
  "primaryProductDataSource": {
    "channel": "ONLINE_PRODUCTS",
    "feedLabel": "US",
    "contentLanguage": "en",
    "countries": [
      "US"
    ],
    "defaultRule": {
      "takeFromDataSources": [
        {
          "self": true
        }
      ]
    }
  },
  "input": "API"
}

제품을 삽입하는 데 필요하므로 name 필드의 값을 복사합니다.

생성된 데이터 소스를 사용하여 제품을 삽입할 수 있을 때까지 몇 분 정도 걸립니다.

이 데이터 소스는 판매자 센터 UI에서 확인할 수 있습니다. 자세한 내용은 데이터 소스 탭을 찾는 방법을 참고하세요.

제품 삽입

계정에 샘플 제품을 삽입하려면 다음 요청을 실행합니다.

POST https://merchantapi.googleapis.com/products/v1beta/accounts/{ACCOUNT_ID}/productInputs:insert?dataSource={DATASOURCE_NAME} HTTP/1.1

{
  "channel": "ONLINE",
  "contentLanguage": "en",
  "feedLabel": "US",
  "name": "Red T-shirt",
  "attributes": {
    "gender": "Male",
    "brand": "New brand"
  },
  "offerId": "tshirt-123"
}

{DATASOURCE_NAME}를 앞서 복사한 값으로 바꿉니다.

이 요청이 실행되면 다음과 같은 응답이 표시됩니다.

{
  "name": "accounts/{ACCOUNT_ID}/productInputs/online~en~US~tshirt-123",
  "product": "accounts/{ACCOUNT_ID}/products/online~en~US~tshirt-123",
  "channel": "ONLINE",
  "offerId": "tshirt-123",
  "contentLanguage": "en",
  "feedLabel": "US",
  "attributes": {
    "brand": "New brand",
    "gender": "Male"
  }
}

새로 생성된 제품의 제품 ID는 online~en~US~tshirt-123입니다. accounts.products.get 메서드를 사용하여 이 제품에 관한 세부정보를 가져올 수 있습니다. 판매자 센터 UI를 사용하여 이 제품을 볼 수도 있습니다.

이전
출시 상태
다음
개요