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

제품 리소스 호출

products 리소스를 활용하면 더 많은 작업을 보다 유연하고 폭넓게 제어할 수 60개가 넘는 제품 속성이 있습니다.필수 입력란도 많지만 Google 쇼핑에 표시하도록 승인을 받으려면 이 속성을 포함해야 합니다. 다양한 선택 사항에 따라 필수가 될 수 있는 여러 가지 선택사항 입력란이 있습니다. 위치, 제품 유형, 제품 옵션, 제품 등의 조건 있습니다 여기에 표시될 수 있는 60개 이상의 선택적 매개변수에 대한 자세한 내용은 자세히 알아보려면 제품 데이터 사양을 참조하세요.

products 리소스를 사용하면 insert, get, update, delete 작업을 할 수 있습니다. 제품을 하나씩 구성하고 판매자 센터 데이터베이스의 모든 제품을 list할 수 있습니다.

이 productstatuses 드림 리소스를 사용하여 특정 제안서의 승인 또는 비승인 상태를 목적지에 대한 제품을 찾을 수 있습니다. 제품 상태를 참고하세요. 가이드를 참조하세요. 제품에는 데이터 품질 문제가 있을 수 있으며 어떤 문제가 있는지 알아봅니다.

API 예제에서는 세 가지 제품, 즉 Google 티셔츠 2개와 Google 상한 Google에서는 아래 표에 표시된 최소한의 제품 데이터 세트를 사용합니다. 삽입, 가져오기, 업데이트, 나열, 삭제를 위해 products 리소스 호출 개별 제품 및 제품 배치를 살펴보겠습니다.

배송 및 세금 정보를 구성하는 것이 좋습니다. 계정에서 등급이 아닌 제품 수준에서 작동합니다

복수 판매자 하위 계정의 경우 마켓의 경우 모든 제품이 external_seller_id 필드를 포함해야 합니다 자세한 내용은 제품 ID를 참조하세요.


id	online:en:US:1111111111	online:en:US:2222222222	online:en:US:3333333333
offerId	1111111111	2222222222	3333333333
제목	검은색 Google 티셔츠	Google 티셔츠 초록색	Google 트윌 캡
설명	검은색 Google 티셔츠	면 100% Google 티셔츠	기존 Google 상한
상품 그룹 ID	google_tee	google_tee
링크	http://my.site.com/blacktee	http://my.site.com/greentee	http://my.site.com/blackhat
조건	신규	신규	신규
가격	21990.00 KRW	21990.00 KRW	10990.00 KRW
availability	재고 있음	재고 있음	재고 있음
imageLink	https://shop.example.com/store/20160512512/assets/items/images/GGOEGXXX1100.jpg	https://shop.example.com/store/20160512512/assets/items/images/GGOEGXXX0906.jpg	https://shop.example.com/store/20160512512/assets/items/images/GGOEGHPB071610.jpg
GTIN	9504000059422	9504000059446	9504000059452
MPN	00638NIC	00638ANG	00638ABC
brand	Google	Google	Google
Google 제품 카테고리	의류 및 액세서리 > 의류	의류 및 액세서리 > 의류	의류 및 액세서리 > 의류 액세서리 > 모자
색상	검정색	녹색	검정색
크기	L	M	M
age_group	성인	성인	성인
gender	남성	남성	남녀공용
included_destination	Shopping Actions, 쇼핑 광고	Shopping Actions, 쇼핑 광고	Shopping Actions

products.insert

단일 제품을 삽입하려면 다음 요청 URL을 사용하여 판매자 ID 및 샘플 JSON 본문입니다. 삽입을 통해 새 제품이 만들어집니다. 값이 channel, contentLanguage, offerId 및 지정된 제품의 feedLabel인 경우, 이 메서드는 해당 항목을 업데이트하고 지정된 제품에 대한 이전 API 호출의 모든 데이터입니다.

모든 대상 유형에서 7일 이상 제외되는 제품은 다음과 같습니다. 자동으로 삭제됩니다

이 예시에서는 '검은색 Google 티셔츠'를 새로 삽입합니다. 제공됩니다

POST https://shoppingcontent.googleapis.com/content/v2.1/{merchantId}/products

products.insert의 샘플 요청 본문 호출:

{
 "kind": "content#product",
 "offerId": "1111111111",
 "title": "Google Tee Black",
 "description": "The Black Google Tee is available in unisex sizing.",
 "link": "http://my.site.com/blacktee/",
 "imageLink": "https://shop.example.com/.../images/GGOEGXXX1100.jpg",
 "contentLanguage": "en",
 "targetCountry": "US",
 "feedLabel": "US",
 "channel": "online",
 "ageGroup": "adult",
 "availability": "in stock",
 "availabilityDate": "2019-01-25T13:00:00-08:00",
 "brand": "Google",
 "color": "black",
 "condition": "new",
 "gender": "male",
 "googleProductCategory": "1604",
 "gtin": "608802531656",
 "itemGroupId": "google_tee",
 "mpn": "608802531656",
 "price": {
  "value": "21.99",
  "currency": "USD"
 },
 "sizes": [
  "Large"
 ]
}

제품의 JSON 본문에서 커스텀 속성을 설정할 수도 있습니다. 예를 들어 단일 제품에 purchase_quantity_limit를 설정하여 고객이 주문할 수 있는 상품 수:

"customAttributes": [
 {
   "name": "purchase_quantity_limit",
   "value": "4"
 }
]

purchase_quantity_limit 맞춤 속성은 구매 한도를 설정합니다. 제품 정의에 적용할 수 있으며 피드에서도 지원됩니다. 이 속성은 API에서 완전히 지원할 때까지 현재 베타 버전입니다. 모든 문자 판매자가 추가 맞춤 속성을 추가할 수 있지만 이로 인해 API에 의한 특정 처리도 포함되지 않습니다.

호출이 성공하면 HTTP 200 코드 및 다음이 포함된 응답 본문이 반환됩니다. id, offerId, contentLanguage만 포함된 삽입된 제품 리소스 feedLabel 및 channel가 채워짐:

{
 "kind": "content#product",
 "id": "online:en:US:1111111111",
 "offerId": "1111111111",
 "contentLanguage": "en",
 "targetCountry": "US",
 "feedLabel": "US",
 "channel": "online"
}

products.get

판매자 센터 데이터베이스에서 특정 제품에 대한 정보를 가져오려면 다음을 사용하세요. products.get 새로 삽입된 제품이 업로드되기까지 몇 분 정도 이 통화를 통해 제공됩니다.

다음 HTTP 요청 URL 및 매개변수, 판매자 ID 및 가져올 제품의 제품 ID (REST ID 형식):

GET https://shoppingcontent.googleapis.com/content/v2.1/{merchantId}/products/{productId}

호출이 성공하면 HTTP 200 및 '제품 리소스'가 반환됩니다. 를 응답 본문입니다. 다음은 ID가 있는 제품에서 가져온 샘플 제품 데이터입니다. online:en:US:1111111111:

{
 "kind": "content#product",
 "id": "online:en:US:1111111111",
 "offerId": "1111111111",
 "source": "api",
 "title": "Google Tee Black",
 "description": "The Black Google Tee is available in unisex sizing.",
 "link": "http://my.site.com/blacktee/",
 "imageLink": "https://shop.example.com/.../images/GGOEGXXX1100.jpg",
 "contentLanguage": "en",
 "targetCountry": "US",
 "feedLabel": "US",
 "channel": "online",
 "ageGroup": "adult",
 "availability": "in stock",
 "availabilityDate": "2019-01-25T13:00:00-08:00",
 "brand": "Google",
 "color": "black",
 "condition": "new",
 "gender": "male",
 "googleProductCategory": "1604",
 "gtin": "608802531656",
 "itemGroupId": "google_tee",
 "mpn": "608802531656",
 "price": {
  "value": "21.99",
  "currency": "USD"
 },
 "sizes": [
  "Large"
 ]
}

products.update

단일 제품을 업데이트하려면 PATCH 메서드와 함께 다음 요청 URL을 사용합니다. 판매자 ID, 제품 ID, 판매자가 제공한 데이터가 포함된 JSON 본문을 에서 제품을 업데이트하려고 합니다. products.insert와 달리 필수 입력란입니다. products.update에서는 다음 작업만 수행해야 합니다. 변경할 입력란을 지정합니다.

속성을 추가하거나 수정하려면 JSON에서 새 값으로 필드를 지정하세요. 본문입니다. 표시된 예는 기존 title 및 description '검은색 Google 티셔츠' 요청 본문에 제공된 제품 데이터로 교체합니다. 다른 모든 필드는 변경되지 않습니다.

PATCH https://shoppingcontent.googleapis.com/content/v2.1/{merchantId}/products/{productId}

products.update의 샘플 요청 본문 호출:

{
 "title": "Google Tee Black Limited Edition",
 "description": "The Limited Edition Tee is available in unisex sizing and features a retail fit."
}

최상위 필드만 products.update 요청을 통해 업데이트할 수 있습니다. 중첩된 필드를 업데이트하려면 전체 최상위 객체를 제공해야 합니다.

표시된 예시는 중첩된 객체를 포함하여 최상위 salePrice 객체를 업데이트합니다. 필드를 만들고, 아래 섹션에 제공된 제품 데이터를 요청 본문을 포함하여 다른 모든 필드는 그대로 둡니다.

PATCH https://shoppingcontent.googleapis.com/content/v2.1/{merchantId}/products/{productId}

{
 "salePrice": {
  "value": "17.99",
  "currency": "USD"
 }
}

포함된 다른 필드를 변경하지 않고 업데이트할 특정 필드를 선택하려는 경우 요청 본문에 updateMask를 지정하면 됩니다. 이 쿼리 문자열 매개변수는 수정할 필드의 쉼표로 구분된 목록이어야 합니다. updateMask는 이름이 지정된 필드만 업데이트됩니다. updateMask를 지정하지 않으면 모두 필드가 업데이트되어야 합니다.

표시된 예는 description 및 availability만 업데이트됩니다. 기존 '검은색 Google 티셔츠' 각 제품 데이터는 요청 본문 중 title를 포함한 다른 모든 필드는 그대로 둡니다.

PATCH https://shoppingcontent.googleapis.com/content/v2.1/{merchantId}/products/{productId}?updateMask=description,availability

products.update의 샘플 요청 본문 호출:

{
 "title": "Google Tee Black",
 "description": "This Limited Edition is out of print.",
 "availability": "out of stock"
}

필드가 updateMask 목록에는 제공되지만 요청 본문에는 제공되지 않는 경우 Product 리소스에서 해당 필드가 삭제됩니다(있는 경우).

표시된 예에서는 updateMask를 사용하여 필드의 값을 삭제합니다. salePrice

PATCH https://shoppingcontent.googleapis.com/content/v2.1/{merchantId}/products/{productId}?updateMask=salePrice

샘플 요청 본문에는 다음과 같은 이유로 salePrice 필드가 포함되지 않아야 합니다. 삭제합니다. 본문을 제공하지 않거나 빈 본문을 제공할 수도 있습니다. 다른 필드에는 updateMask에 표시되지 않는 한 변경되지 않습니다.

products.custombatch 요청 내에서 updateMask를 사용하려면 updateMask 요청 본문에 지정해야 합니다

표시된 예는 기존 price 및 availability '검은색 Google 티셔츠' 제공된 제품 데이터로 products.custombatch 사용 일괄 항목에 입력되어 title 및 description를 포함한 다른 모든 필드는 그대로 둡니다. 있습니다.

POST https://shoppingcontent.googleapis.com/content/v2.1/products/batch

{
  "entries": [{
    "batchId": 1,
    "merchantId": "MERCHANT_ID",
    "productId": "online:en:US:1111111111",
    "method": "update",
    "product": {
      "title": "Google Tee Black",
      "description": "The Black Google Tee is available in unisex sizing.",
      "availability": "in stock",
      "price": {
        "value": "19.99",
        "currency": "USD"
      }
    },
    "updateMask": "availability,price"
  }]
}

products.delete

단일 제품을 삭제하려면 샘플 HTTP 요청과 함께 products.delete를 사용합니다. URL, 판매자 ID, 제품 ID (REST ID 형식, online:en:US:1111111111)합니다.

DELETE https://shoppingcontent.googleapis.com/content/v2.1/{merchantId}/products/{productId}

응답이 성공하면 응답 본문이 없는 HTTP Status 204가 반환됩니다.

products.list

products.list에는 판매자가 판매자 센터에 보유하고 있는 모든 제품이 나열됩니다. 데이터베이스입니다. 다음 요청 URL을 사용합니다.

GET https://shoppingcontent.googleapis.com/content/v2.1/{merchantId}/products

호출이 성공하면 HTTP 200 및 '리소스' 키를 누릅니다.

다음 세 가지 예시 제품이 반환됩니다.

{
 "kind": "content#productsListResponse",
 "resources": [
  {
   "kind": "content#product",
   "id": "online:en:US:1111111111",
   "offerId": "1111111111",
   "source": "api",
   "title": "Google Tee Black",
   "description": "The Black Google Tee is available in unisex sizing.",
   "link": "http://my.site.com/blacktee/",
   "imageLink": "https://shop.example.com/.../images/GGOEGXXX1100.jpg",
   "contentLanguage": "en",
   "targetCountry": "US",
   "feedLabel": "US",
   "channel": "online",
   "ageGroup": "adult",
   "availability": "in stock",
   "availabilityDate": "2019-01-25T13:00:00-08:00",
   "brand": "Google",
   "color": "black",
   "condition": "new",
   "gender": "male",
   "googleProductCategory": "1604",
   "gtin": "608802531656",
   "itemGroupId": "google_tee",
   "mpn": "608802531656",
   "price": {
    "value": "21.99",
    "currency": "USD"
   },
   "sizes": [
    "Large"
   ]
  },
  {
   "kind": "content#product",
   "id": "online:en:US:2222222222",
   "offerId": "2222222222",
   "source": "api",
   "title": "Google Tee Green",
   "description": "100% cotton jersey fabric sets this Google t-shirt above the crowd.
    Features the google logo across the chest. Unisex sizing.",
   "link": "http://my.site.com/greentee/",
   "imageLink": "https://shop.example.com/.../images/GGOEGXXX0906.jpg",
   "contentLanguage": "en",
   "targetCountry": "US",
   "feedLabel": "US",
   "channel": "online",
   "ageGroup": "adult",
   "availability": "in stock",
   "availabilityDate": "2019-01-25T13:00:00-08:00",
   "brand": "Google",
   "color": "green",
   "condition": "new",
   "gender": "male",
   "googleProductCategory": "1604",
   "gtin": "608802531649",
   "itemGroupId": "google_tee",
   "mpn": "608802531649",
   "price": {
    "value": "21.99",
    "currency": "USD"
   },
   "sizes": [
    "Medium"
   ]
  },
  {
   "kind": "content#product",
   "id": "online:en:US:3333333333",
   "offerId": "3333333333",
   "source": "api",
   "title": "Google Twill Cap",
   "description": "Classic urban styling distinguishes this Google cap.
    Retains its shape, even when not being worn.",
   "link": "http://my.site.com/blackhat/",
   "imageLink": "https://shop.example.com/.../images/GGOEGHPB071610.jpg",
   "contentLanguage": "en",
   "targetCountry": "US",
   "feedLabel": "US",
   "channel": "online",
   "ageGroup": "adult",
   "availability": "in stock",
   "availabilityDate": "2019-01-07T13:00:00-08:00",
   "brand": "Google",
   "color": "black",
   "condition": "new",
   "gender": "male",
   "googleProductCategory": "173",
   "gtin": "689355417246",
   "mpn": "689355417246",
   "price": {
    "value": "10.99",
    "currency": "USD"
   },
   "sizes": [
    "Medium"
   ]
  }
 ]
}

제품 ID

배치 모드