제품 컬렉션을 사용하면 리치 형식과 함께 사용할 제품 그룹을 쇼퍼블 이미지. 각 최대 100개의 제품을 포함할 수 있습니다 다음을 사용하여 컬렉션을 만들 수 있습니다. Google 판매자 센터 또는 Content API
이 가이드에서는 Content API를 통해 제품 컬렉션을 사용하는 방법을 보여줍니다. 예를 들어 쇼퍼블 이미지를 위한 컬렉션을 만드는 방법과 컬렉션 상태를 확인할 수 있습니다
제품 컬렉션 사용
Content API에는 제품 컬렉션을 관리하기 위한 두 가지 서비스가 포함되어 있습니다.
collections
: 제품 컬렉션을 가져오고, 나열하고, 삽입하고, 삭제할 수 있습니다.collectionstatuses
: 컬렉션 상태를 가져오고 나열할 수 있습니다. 컬렉션에 컬렉션의 결과를 야기할 수 있는 문제가 있는지 대상 유형(예: 쇼핑 광고.
예: 쇼퍼블 이미지 컬렉션 만들기
쇼퍼블 이미지는
하나 이상의 주석이 달린 제품을 표시하고 이러한 이미지를
컬렉션을 사용하죠 쇼퍼블 이미지를 사용하려면
imageLink
및 featuredProduct
필드 및
확인할 수 있습니다. 필수 입력란에 대한 자세한 내용은
Content API 참조 문서
쇼퍼블 이미지를 사용하려면 제품 컬렉션을 만들고
imageLink
필드를 사용하여 최대 10개의 제품이 포함된 이미지를 지정합니다.
정사각형 이미지 (가로세로 비율 1:1)를 사용하는 것이 좋습니다.
또한
featuredProduct
필드(이미지에 있는 제품의 좌표 포함)
x
및 y
필드 사용 이 필드는 컬렉션에만 필요합니다.
쇼퍼블 이미지와 함께 사용됩니다. x
및 y
값은 0과 1 사이여야 합니다.
포괄성
각 컬렉션은 최대 100개의 제품을 포함할 수 있습니다. 그러나
쇼퍼블 이미지의 경우 좌표를 10개 이하로 지정하는 것이 좋습니다.
이미지를 표시할 수 있는 공간이 충분한지 확인하기 위해
제품 콜아웃 이
offerId
드림
featuredProduct
객체의 일부인 필드는 offerId
와 일치해야 합니다.
값으로, products
리소스의
id
값
(products
리소스에서)
필수 imageLink
및 featuredProduct
필드 외에도
쇼퍼블 이미지의 경우
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"
}
]
}