Merchant API를 사용하여 프로그래매틱 방식으로 제품을 업로드하고 관리할 수 있습니다. accounts.products
리소스를 사용하면 제품 및 제품의 목록인 온라인 상점 카탈로그를 만들 수 있습니다. Merchant API를 사용하여 제품을 업로드하고 관리하는 방법에 관한 자세한 내용은 Merchant Products API 개요를 참고하세요.
리소스 변경사항
Content API의 products
및 productstatuses
리소스가 productInputs
및 products
리소스로 대체됩니다.
Merchant API의 productInputs
리소스를 사용하여 제품 정보를 업로드할 수 있습니다. Merchant API의 product
리소스를 사용하면 상태를 포함하여 처리된 제품을 검색할 수 있습니다.
데이터 소스 요구사항
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 | 아직 사용할 수 없음 |
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 | Content API의 식별자 | Merchant Products API의 식별자 |
---|---|---|---|---|
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} |
MERCHANT_ID | PARENT=accounts/{MERCHANT_ID} |
products.update |
PATCH https://shoppingcontent.googleapis.com/content/v2.1/ {MERCHANT_ID}/products/ {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} |
MERCHANT_ID, PRODUCT_ID | NAME=accounts/{MERCHANT_ID}/productInputs/{PRODUCT_ID_WITH_TILDES} |
products.get |
GET https://shoppingcontent.googleapis.com/content/v2.1/ {MERCHANT_ID}/products/ {PRODUCT_ID} |
GET https://merchantapi.googleapis.com/products/v1beta/ {NAME} |
MERCHANT_ID, PRODUCT_ID | NAME=accounts/{MERCHANT_ID}/products/{PRODUCT_ID_WITH_TILDES} |
products.list |
GET https://shoppingcontent.googleapis.com/content/v2.1/ {MERCHANT_ID}/products |
GET https://merchantapi.googleapis.com/products/v1beta/ {PARENT}/products |
MERCHANT_ID | PARENT=accounts/{MERCHANT_ID} |
productstatuses.get |
GET https://shoppingcontent.googleapis.com/content/v2.1/ {MERCHANT_ID}/productstatuses/ {PRODUCT_ID} |
GET https://merchantapi.googleapis.com/products/v1beta/ {NAME} |
PRODUCT_ID MERCHANT_ID | NAME=accounts/{MERCHANT_ID}/products/{PRODUCT_ID_WITH_TILDES} |
productstatuses.list |
GET https://shoppingcontent.googleapis.com/content/v2.1/ {MERCHANT_ID}/productstatuses |
GET https://merchantapi.googleapis.com/products/v1beta/ {PARENT}/products |
MERCHANT_ID | PARENT=accounts/{MERCHANT_ID} |