보조 피드를 사용하여
feedId를 쿼리 매개변수로
products.insert,
products.delete,
products.custombatch.insert,
및
products.custombatch.delete
메서드를 참조하세요.
예를 들어 products.insert 보조 피드 메서드를 호출하여
다음 URL을 사용하세요.
POST https://shoppingcontent.googleapis.com/content/v2.1/merchantId/products?feedId=feedId
products.insert
보조 피드 products.insert 메서드는 전송하는 제품 필드를 추가합니다.
요청 본문에 삽입하여 기존 필드가 있으면 덮어씁니다.
이 방법을 사용하면 다른 모든 제품 필드가 변경되지 않습니다.
필드가 동일한 피드에 대한 이전 요청에 포함되어 있었습니다. 데이터는
영향을 받지 않으며, 각 요청은 이전
동일한 피드에 대한 요청수입니다. 즉, 피처스토어를 통해 필드를 추가하거나 업데이트하면
보조 피드 요청과 함께 입력한 다음 후속 피드에는 해당 필드를
요청에서 생략된 필드의 데이터가 피드에서 삭제됩니다. 이 동작
보조 피드 없이 products.insert를 호출하는 것과는 다릅니다.
기존 제품 데이터를 모두 삭제하고 전송한 필드로 대체합니다.
요청 본문입니다.
다음 URL을 사용하여 보조 피드에 요청합니다.
서비스 Product.insert개:
POST https://shoppingcontent.googleapis.com/content/v2.1/merchantId/products?feedId=feedId
offerId, feedLabel, channel 및
요청 본문에 contentLanguage 필드가 있습니다. 다른 입력란은 선택사항입니다.
예
제품의 재고를 '재고 있음'에서 '재고 없음'으로 변경하려면
다음 요청 본문을 사용하여 보조 피드를 만들 수 있습니다.
Product.insert 메서드 호출:
{
"offerId": "1111111111",
"contentLanguage": "en",
"feedLabel": "US",
"channel": "online",
"availability": "out of stock",
}
products.delete
products.delete 메서드는 이전에 설정한 모든 보조 데이터를
이전에 지정된 보조 항목을 사용하여 products.insert개의 호출로 추가된 그룹
있습니다. 보조 피드에 이 메서드를 호출해도 원본
보조 피드 Product.insert 호출 전에 추가된 제품 데이터
있습니다. 이는 특정 피드의 데이터 레이어를 삭제하는 것과 같습니다.
다른 피드를 통해 추가된 데이터는 영향을 받지 않으며 제품은 사실상
보조 피드 레이어가 추가되기 전에 이전 상태로 되돌아갑니다. 이
보조 피드 없이 products.delete를 호출하는 것과는 다릅니다.
전체 제품과 모든 해당 데이터를 삭제합니다.
다음 URL을 사용하여 보조 피드(products.delete)를 요청합니다.
서비스로, 여기서 productId는
REST ID
제품의 형태로, channel:contentLanguage:feedLabel:offerId로 표현됩니다.
DELETE https://shoppingcontent.googleapis.com/content/v2.1/merchantId/products/productId?feedId=feedId
보조 피드 products.delete 메서드 호출에는 요청 본문이 필요하지 않습니다.
products.custombatch
custombatch 메서드를 사용하면 보조 피드를 insert 또는 delete할 수 있습니다.
API 수를 최소화하기 위해 단일 API 호출을 사용하는 여러 제품의 데이터
수 있습니다.
다음 요청 URL을 사용하여 custombatch 호출을 실행합니다.
https://shoppingcontent.googleapis.com/content/v2.1/products/batch
모든 보조 피드 custombatch 호출의 경우 batchId,
요청의 merchantID, method, feedId 매개변수
본문입니다.
products.custombatch:insert
products.custombatch:insert 메서드에 대해 보조 피드 호출을 실행할 때
offerId, feedLabel, channel,
필수 batchId 외에 요청 본문의 contentLanguage
merchantID, method 매개변수 다른 모든 제품 입력란은 선택사항입니다.
예
기존 제품 2개의 price 값을 업데이트하려면 다음을 사용합니다.
다음 요청을 사용하여 products.custombatch:insert 메서드를 호출합니다.
{
"entries": [
{
"batchId": 1111,
"merchantId": 1234567,
"method": "insert",
"feedId": "7654321",
"product": {
"offerId": "1111111111",
"contentLanguage": "en",
"targetCountry": "US",
"feedLabel": "US",
"channel": "online",
"price": {
"value": "30.99",
"currency": "USD"
}
}
},
{
"batchId": 1112,
"merchantId": 1234567,
"method": "insert",
"feedId": "7654321",
"product": {
"offerId": "2222222222",
"contentLanguage": "en",
"targetCountry": "US",
"feedLabel": "US",
"channel": "online",
"price": {
"value": "33.99",
"currency": "USD"
},
},
}
}
products.custombatch:delete
지정된 보조 피드를 통해 두 제품의 모든 업데이트를 삭제하려면 다음 안내를 따르세요.
다음 요청을 사용하여 products.custombatch:delete
메서드 호출:
{
"entries": [
{
"batchId": 1115,
"merchantId": 1234567,
"method": "delete",
"feedId": "7654321",
"productId": "online:en:US:1111111111"
},
{
"batchId": 1116,
"merchantId": 1234567,
"method": "delete",
"feedId": "7654321",
"productId": "online:en:US:2222222222"
}
]
}