Ürün koleksiyonları, Alışveriş Özellikli Resimler gibi zengin biçimlerle kullanılacak ürün gruplarını tanımlamanıza olanak tanır. Her koleksiyonda en fazla 100 ürün bulunabilir. Google Merchant Center veya Content API ile koleksiyon oluşturabilirsiniz.
Bu kılavuzda, Alışveriş Özellikli Resimler için koleksiyon oluşturma ve koleksiyonların durumunu kontrol etmeyle ilgili örnekler de dahil olmak üzere Content API aracılığıyla ürün koleksiyonlarının nasıl kullanılacağı gösterilmektedir.
Ürün koleksiyonlarını kullanma
Content API, ürün koleksiyonlarını yönetmek için iki hizmet içerir:
collections: Ürün koleksiyonlarını almanıza, listelemenize, eklemenize ve silmenize olanak tanır.collectionstatuses: Koleksiyonun, Alışveriş Reklamları gibi bir hedef için geçersiz olmasına yol açabilecek herhangi bir sorun olup olmadığını anlamak amacıyla koleksiyonların durumunu almanıza ve listelemenize olanak tanır.
Örnek: Alışveriş Özellikli Resimler için koleksiyon oluşturma
Alışveriş Özellikli Resimler, bir veya daha fazla ek açıklamalı ürünü gösteren ve koleksiyonlar kullanılarak yapılandırılan yüksek kaliteli resimlerdir. Alışveriş Özellikli Resimleri kullanmak istiyorsanız tüm koleksiyonlar için gerekli alanların yanı sıra imageLink ve featuredProduct alanları için değerler belirtmeniz gerekir. Zorunlu alanlar hakkında daha fazla bilgi için Content API referans belgelerine bakın.
Alışveriş Özellikli Resimleri kullanmak için ürün koleksiyonu oluşturmanız ve en fazla on ürün içeren bir resim belirtmek için imageLink alanını kullanmanız gerekir. Kare resimler (1:1 en boy oranına sahip) kullanmanızı öneririz.
Resimde gösterilen ürünleri featuredProduct alanını kullanarak ve resimdeki ürünlerin koordinatlarını da x ve y alanlarını kullanarak belirtmeniz gerekir. Bu alanlar yalnızca Alışveriş Özellikli Resimlerle kullanılan koleksiyonlar için gereklidir. x ve y değerleri 0 ile 1 arasında (0 ve 1 dahil) olmalıdır.
Her koleksiyonda en fazla 100 ürün bulunabilir. Bununla birlikte, Alışveriş Özellikli Resimlerde, resimde ürün açıklama metinlerini göstermek için yeterli alan bulunduğundan emin olmak amacıyla resim başına en fazla 10 ürünün koordinatlarını belirtmenizi öneririz. featuredProduct nesnesinin parçası olan offerId alanı, products kaynağındaki offerId değeriyle eşleşmelidir. Bu değer, products kaynağındaki id değerinden farklıdır.
Alışveriş Özellikli Resimler için gerekli olan imageLink ve featuredProduct alanlarının yanı sıra isteğe bağlı headline alanını kullanarak bir koleksiyon başlığı da belirtebilirsiniz. Müşterilere koleksiyon hakkında ek ayrıntılar sağlamak için bir başlık eklemenizi öneririz.
Alışveriş Özellikli Resimlere yönelik yeni bir koleksiyon oluşturmak için aşağıdaki URL'yi ve istek gövdesini kullanarak collections.insert uç noktasına bir POST isteği gönderin:
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"
}
Örnek: Bir koleksiyonun durumunu kontrol etme
Yukarıda oluşturduğunuz koleksiyonda, koleksiyonun reklam yayınlamasını geçersiz kılacak sorunlar olup olmadığını öğrenmek için aşağıdaki URL'yi kullanarak collectionsstatuses.get uç noktasına GET isteğinde bulunun ve durumunu almak istediğiniz koleksiyonun id özelliğini dahil edin. İstek metni sağlamanız gerekmez.
https://shoppingcontent.googleapis.com/content/v2.1/merchantID/collectionstatuses/collection ID
Örnek koleksiyon durumu yanıtı
{
"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"
}
]
}