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

Merchant API 시작하기

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

시작하기 전에

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

API 통합이 쇼핑 콘텐츠 서비스를 사용하여 AppScript에서 사용되는 경우 기본 Google Cloud 프로젝트가 생성되고 판매자 API 서비스가 자동으로 사용 설정됩니다. 하지만 판매자 API를 사용하려면 일회성 개발자 등록을 완료해야 합니다. 자세한 내용은 Apps Script에서 Merchant API 서비스 사용하기를 참고하세요.

Google Cloud로 이동

계정 만들기

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

판매자 센터로 이동

개발자로 등록

Merchant API를 사용하려면 다음과 같이 개발자 등록 방법을 사용하여 판매자 센터 계정과 Google Cloud 프로젝트를 연결해야 합니다.

판매자 센터와 Google Cloud 프로젝트 연결: 호출자에게 Google Cloud 프로젝트의 유효한 액세스 토큰 또는 API 키가 있고 판매자 센터 계정의 승인된 사용자이므로 연결이 자동으로 승인됩니다.
판매자 센터 계정에 API 개발자 사용자 추가: 등록 API는 판매자 센터 계정에 API 개발자 사용자를 추가합니다. 사용자가 이미 있는 경우 새 액세스 유형이 부여됩니다. 신규 사용자의 경우 판매자 센터 이메일 초대가 전송됩니다.

accounts.users.create 메서드를 사용하여 추가 또는 백업 API 개발자를 추가하여 조직을 떠나거나 삭제되는 경우에도 유효한 개발자 등록을 유지할 수 있는지 확인하는 것이 좋습니다.

등록 후 GetDeveloperRegistration를 사용하여 등록 상태를 확인하거나 UnregisterGCP를 사용하여 등록을 취소할 수 있습니다.

등록 호출은

POST https://merchantapi.googleapis.com/accounts/v1beta/accounts/{ACCOUNT_ID}/developerRegistration:registerGcp

{
  developer_email:"example-email@example.com"
}

요청이 성공적으로 실행되면 다음 응답이 표시됩니다.

{
  "developerRegistration": {
    "name": "accounts/ACCOUNT_ID/developerRegistration",
    "gcpIds": ["GOOGLE_CLOUD_PROJECT_ID"]
  }
}

API 개발자가 등록되면 accounts.users.patch 메서드를 사용하여 STANDARD, ADMIN과 같은 추가 역할을 부여할 수 있습니다.

계정 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

또는

GET https://merchantapi.googleapis.com/accounts/v1beta/accounts/{ACCOUNT_ID}

요청이 성공적으로 실행되면 다음과 같은 응답이 표시됩니다.

{
  "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를 사용하여 이 제품을 볼 수도 있습니다.

Launch status

Overview