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

Merchant API 시작하기

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

시작하기 전에

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

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

Google Cloud로 이동

계정 만들기

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

판매자 센터로 이동

개발자로 등록

Merchant API를 사용하려면 Google Cloud 프로젝트와 기본 판매자 센터 계정 간에 연결을 만들어야 합니다. 이 일회성 등록은 Merchant API와 함께 사용하는 모든 Google Cloud 프로젝트에 필요합니다.

개발자로 등록하면 다음 두 가지 작업을 할 수 있습니다.

Google Cloud 프로젝트를 기본 판매자 센터 계정에 연결하여 공식적인 연결을 설정합니다.
판매자 센터 계정의 사용자에게 API_DEVELOPER 역할을 할당하여 기술 담당자를 만듭니다. 이를 통해 Google은 서비스 공지사항 및 새 기능에 관한 정보와 같은 API에 관한 중요한 업데이트를 전송할 수 있습니다.

Google Cloud 프로젝트 등록

등록하려면 developerRegistration.registerGcp 메서드를 호출합니다. 이 호출은 호출에 사용하는 Google Cloud 프로젝트를 요청에 지정한 판매자 센터 계정과 연결합니다.

요청 본문에서 기술 담당자로 사용할 개발자 이메일 주소를 제공해야 합니다. 이 주소는 Google 계정(Google Workspace 계정 또는 Gmail 계정)과 연결되어야 합니다(예: sampleuser@gmail.com).

이메일 주소가 이미 판매자 센터 계정의 사용자에게 속한 경우 해당 사용자에게 API_DEVELOPER 역할이 부여됩니다.
이메일 주소가 기존 사용자의 주소가 아닌 경우 해당 주소로 초대가 전송됩니다. API_DEVELOPER 역할이 있는 새 사용자로 추가되려면 수신자가 초대를 수락해야 합니다.

다음은 요청의 예입니다.

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

{
  "developerEmail": "{DEVELOPER_EMAIL}"
}

호출에 성공하면 프로젝트와 계정 간의 링크를 확인하는 DeveloperRegistration 리소스가 반환됩니다.

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

개발자 연락처 및 권한 관리

등록 후에는 여러 개발자를 추가하고 추가 액세스 권한을 부여하는 것이 좋습니다.

추가 권한 부여

API_DEVELOPER 역할은 중요한 알림을 받는 데 필요하지만 판매자 센터 내 권한은 최소한입니다. 이 사용자가 다른 API를 호출하거나 판매자 센터 UI에서 설정을 관리하도록 허용하려면 STANDARD 또는 ADMIN과 같은 추가 역할을 부여해야 합니다. 자세한 내용은 액세스 유형을 참고하세요.

accounts.users.patch 메서드로 사용자의 액세스 권한을 업데이트할 수 있습니다.

다음 예는 사용자에게 ADMIN 및 API_DEVELOPER 역할을 모두 부여하도록 사용자를 업데이트하는 방법을 보여줍니다. 이렇게 하면 계정을 완전히 관리할 수 있으며 API 관련 커뮤니케이션도 수신하게 됩니다.

PATCH https://merchantapi.googleapis.com/accounts/v1/accounts/{ACCOUNT_ID}/users/{DEVELOPER_EMAIL}?update_mask=access_rights

{
  "access_rights": [
    "ADMIN",
    "API_DEVELOPER"
  ]
}

백업 개발자 추가

기본 개발자 연락처가 조직을 떠날 경우 API 액세스가 중단되지 않도록 백업 개발자를 한 명 이상 추가해야 합니다.

accounts.users.create 메서드를 사용하여 사용자를 추가하거나 accounts.users.patch 메서드를 사용하여 기존 사용자를 업데이트할 수 있습니다. 이 사용자에게 ADMIN 및 API_DEVELOPER 역할을 모두 부여하는 것이 좋습니다.

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

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

POST https://merchantapi.googleapis.com/datasources/v1/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/v1/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}를 이전에 복사한 값으로 바꿉니다.