Merchant API를 사용하여 프로그래매틱 방식으로 제품을 업로드하고 관리할 수 있습니다. accounts.products 리소스를 사용하면 제품 및 제품의 목록인 온라인 상점 카탈로그를 만들 수 있습니다. Merchant API를 사용하여 제품을 업로드하고 관리하는 방법에 관한 자세한 내용은 Merchant Products API 개요를 참고하세요.
리소스 변경사항
Content API의 products 및 productstatuses 리소스가 productInputs 및 products 리소스로 대체됩니다.
Merchant API의 productInputs 리소스를 사용하여 제품 정보를 업로드할 수 있습니다. Merchant API의 product 리소스는 상태를 포함하여 처리된 제품을 검색하는 데 사용할 수 있으며 productInputs가 삽입된 후 몇 분 후에만 검색할 수 있습니다.
데이터 소스 요구사항
Merchant API에서는 제품을 업로드할 때 대상 데이터 소스를 지정해야 합니다. 기본 데이터 소스 또는 보조 데이터 소스일 수 있습니다. dataSources.list를 사용하여 기존 데이터 소스를 검색하거나 dataSources.create를 사용하여 새 데이터 소스를 만들 수 있습니다.
또는 판매자 센터 UI를 사용하여 데이터 소스를 관리할 수 있습니다.
데이터 소스 및 데이터 소스를 만들고 관리하는 방법에 관한 자세한 내용은 판매자 데이터 소스 API 개요를 참고하세요.
식별자 변경사항
Merchant API는 name을 사용하여 제품을 식별합니다. 제품 이름은 accounts/{account}/products/{product} 형식을 따르며 여기서 {product}은 channel~language~feedLabel~offerId 형식입니다.
Content API 리소스는 ID:channel:language:feedLabel:offerId의 각 값 사이에 ~ 대신 :를 사용했습니다.
모든 Merchant API 호출은 ID 값 사이에 ~가 있는 새 형식을 반환합니다. 응답에서 새 name 필드를 저장하고 향후 호출에 사용하는 것이 좋습니다.
메서드
다음은 Content API for Shopping과 Merchant Products API의 제품 메서드 비교입니다.
| Content API for Shopping | Merchant Products API |
|---|---|
| products.custombatch | 사용할 수 없습니다. 대신 일괄 요청을 사용하세요. |
| products.insert | productInputs.insert |
| products.update | productInputs.patch |
| products.update | productInputs.patch |
| products.delete | productInputs.delete |
| products.get | products.get |
| products.list | products.list |
| productstatuses.custombatch | 사용할 수 없습니다. 대신 일괄 요청을 사용하세요. |
| productstatuses.get | products.get |
| productstatuses.list | products.list |
요청
| Content API 메서드 | Content API for Shopping의 URL | Merchant Products API의 URL | |||
|---|---|---|---|---|---|
products.insert |
POST https://shoppingcontent.googleapis.com/content/v2.1/{MERCHANT_ID}/products |
POST https://merchantapi.googleapis.com/products/v1beta/{PARENT}/productsInputs:insert?dataSource=accounts/{MERCHANT_ID}/dataSources/{DATASOURCE_ID} |
|||
products.update |
PATCH https://shoppingcontent.googleapis.com/content/v2.1/{MERCHANT_ID}/products/{PRODUCT_ID} |
PATCH https://merchantapi.googleapis.com/products/v1beta/{productInput.name=accounts/*/productInputs/*} |
PATCH https://merchantapi.googleapis.com/products/v1beta/account/{ACCOUNT_ID}/productInputs/{PRODUCT_ID} |
MERCHANT_ID, PRODUCT_ID | NAME=accounts/{ACCOUNT_ID}/productInputs/{PRODUCT_ID} |
products.delete |
DELETE https://shoppingcontent.googleapis.com/content/v2.1/{MERCHANT_ID}/products/{PRODUCT_ID} |
DELETE https://merchantapi.googleapis.com/products/v1beta/{NAME}?dataSource=accounts/{MERCHANT_ID}/dataSources/{DATASOURCE_ID} |
|||
products.get |
GET https://shoppingcontent.googleapis.com/content/v2.1/{MERCHANT_ID}/products/{PRODUCT_ID} |
GET https://merchantapi.googleapis.com/products/v1beta/{NAME} |
|||
products.list |
GET https://shoppingcontent.googleapis.com/content/v2.1/{MERCHANT_ID}/products |
GET https://merchantapi.googleapis.com/products/v1beta/{PARENT}/products |
|||
productstatuses.get |
GET https://shoppingcontent.googleapis.com/content/v2.1/{MERCHANT_ID}/productstatuses/{PRODUCT_ID} |
GET https://merchantapi.googleapis.com/products/v1beta/{NAME} |
|||
productstatuses.list |
GET https://shoppingcontent.googleapis.com/content/v2.1/{MERCHANT_ID}/productstatuses |
GET https://merchantapi.googleapis.com/products/v1beta/{PARENT}/products |
식별자
| 메서드 | Content API의 식별자 | Merchant Products API의 식별자 |
|---|---|---|
products.insert |
MERCHANT_ID | accounts/{ACCOUNT_ID} |
products.delete |
MERCHANT_ID, PRODUCT_ID | accounts/{ACCOUNT_ID}/productInputs/{PRODUCT_ID_WITH_TILDES} |
products.get |
PRODUCT_ID MERCHANT_ID | accounts/{ACCOUNT_ID}/products/{PRODUCT_ID_WITH_TILDES} |
products.list |
MERCHANT_ID | accounts/{ACCOUNT_ID} |