제품 관리 이전

Merchant API를 사용하여 프로그래매틱 방식으로 제품을 업로드하고 관리할 수 있습니다. accounts.products 리소스를 사용하면 제품 및 제품의 목록인 온라인 상점 카탈로그를 만들 수 있습니다. Merchant API를 사용하여 제품을 업로드하고 관리하는 방법에 관한 자세한 내용은 Merchant Products API 개요를 참고하세요.

리소스 변경사항

Content API의 productsproductstatuses 리소스가 productInputsproducts 리소스로 대체됩니다.

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}