제품 컬렉션

제품 컬렉션을 사용하면 리치 형식과 함께 사용할 제품 그룹을 쇼퍼블 이미지. 각 최대 100개의 제품을 포함할 수 있습니다 다음을 사용하여 컬렉션을 만들 수 있습니다. Google 판매자 센터 또는 Content API

이 가이드에서는 Content API를 통해 제품 컬렉션을 사용하는 방법을 보여줍니다. 예를 들어 쇼퍼블 이미지를 위한 컬렉션을 만드는 방법과 컬렉션 상태를 확인할 수 있습니다

제품 컬렉션 사용

Content API에는 제품 컬렉션을 관리하기 위한 두 가지 서비스가 포함되어 있습니다.

  • collections: 제품 컬렉션을 가져오고, 나열하고, 삽입하고, 삭제할 수 있습니다.

  • collectionstatuses: 컬렉션 상태를 가져오고 나열할 수 있습니다. 컬렉션에 컬렉션의 결과를 야기할 수 있는 문제가 있는지 대상 유형(예: 쇼핑 광고.

예: 쇼퍼블 이미지 컬렉션 만들기

쇼퍼블 이미지는 하나 이상의 주석이 달린 제품을 표시하고 이러한 이미지를 컬렉션을 사용하죠 쇼퍼블 이미지를 사용하려면 imageLinkfeaturedProduct 필드 및 확인할 수 있습니다. 필수 입력란에 대한 자세한 내용은 Content API 참조 문서

쇼퍼블 이미지를 사용하려면 제품 컬렉션을 만들고 imageLink 필드를 사용하여 최대 10개의 제품이 포함된 이미지를 지정합니다. 정사각형 이미지 (가로세로 비율 1:1)를 사용하는 것이 좋습니다.

또한 featuredProduct 필드(이미지에 있는 제품의 좌표 포함) xy 필드 사용 이 필드는 컬렉션에만 필요합니다. 쇼퍼블 이미지와 함께 사용됩니다. xy 값은 0과 1 사이여야 합니다. 포괄성

각 컬렉션은 최대 100개의 제품을 포함할 수 있습니다. 그러나 쇼퍼블 이미지의 경우 좌표를 10개 이하로 지정하는 것이 좋습니다. 이미지를 표시할 수 있는 공간이 충분한지 확인하기 위해 제품 콜아웃 이 offerId 드림 featuredProduct 객체의 일부인 필드는 offerId와 일치해야 합니다. 값으로, products 리소스의 id 값 (products 리소스에서)

필수 imageLinkfeaturedProduct 필드 외에도 쇼퍼블 이미지의 경우 headline 필드(선택사항)를 입력합니다. 광고 제목을 포함하여 고객에게 컬렉션에 대한 추가 세부정보를 제공할 수 있습니다.

쇼퍼블 이미지의 새 컬렉션을 만들려면 POST 요청을 collections.insert 엔드포인트에 다음 URL과 요청 본문을 사용합니다.

https://shoppingcontent.googleapis.com/content/v2.1/merchantId/collections
{
  "id": "exampleCollection"
  "language": "en",
  "productCountry": "UK",
  "imageLink": ["www.imageLink.example"],
  "featuredProduct": [
{
  "offerId": '432',
  "x": 0.11,
  "y": 0.99
},
{ "offerId": '433',
  "x": 0.53,
  "y": 0.89
}
],
  "link": "www.link.example",
  "mobileLink": "www.mobileLink.example",
  "headline": "www.link.example",
  "customLabel0": "Organize",
  "customLabel1": "Your",
  "customLabel2": "Bidding/Reporting",
  "customLabel3": "With",
  "customLabel4": "Me"
}

예: 컬렉션 상태 확인

위에서 만든 컬렉션에 다음과 같은 문제가 있는지 확인 컬렉션을 광고 게재에서 무효화하려면 GET 요청을 collectionsstatuses.get 엔드포인트에 다음 URL을 사용하고 id를 포함합니다. 상태를 검색할 컬렉션의 이름을 지정합니다. 제공하실 필요가 없습니다. 요청 본문입니다.

https://shoppingcontent.googleapis.com/content/v2.1/merchantID/collectionstatuses/collection ID

컬렉션 상태 응답 예시

{
  "id": "exampleCollection",
  "creationDate": "2020-09-22T00:26:51Z",
  "lastUpdateDate": "2020-09-22T00:26:51Z",
  "collectionLevelIssues": [
    {
      "code": "invalid_url",
      "servability": "unaffected",
      "resolution": "merchant_action",
      "attributeName": "link",
      "description": "Invalid URL [link]",
      "detail": "Use a complete URL that starts with http:// or https:// and
          links to a valid destination such as an image or a landing page",
      "documentation": "https://support.google.com/merchants/answer/7052112"
    },
    {
      "code": "invalid_url",
      "servability": "unaffected",
      "resolution": "merchant_action",
      "attributeName": "imageLink",
      "description": "Invalid URL [imageLink]",
      "detail": "Use a complete URL that starts with http:// or https:// and
          links to a valid destination such as an image or a landing page",
      "documentation": "https://support.google.com/merchants/answer/7052112"
    }
  ]
}