Ürün koleksiyonları

Ürün koleksiyonları şunları yapmanıza olanak tanır: Zengin biçimlerle kullanılacak ürün gruplarını tanımlamak Alışveriş Özellikli Resimler. Her biri koleksiyonunda en fazla 100 ürün bulunabilir. Koleksiyon oluşturmak için kullanabileceğiniz Google Merchant Center veya Content API.

Bu kılavuzda, Content API aracılığıyla ürün koleksiyonlarının nasıl kullanılacağı Alışveriş özellikli resimler için koleksiyon oluşturmaya ve bunları koleksiyonunun durumunu kontrol edebilirsiniz.

Ü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: Koleksiyonların durumunu almak ve listelemek için bir koleksiyonda, koleksiyonun kapatılmasına neden olabilecek herhangi bir sorun olup olmadığını bir hedef için geçersiz olmalıdır, örneğin Alışveriş Reklamları.

Örnek: Alışveriş Özellikli Resimler için koleksiyon oluşturma

Alışveriş Edilebilir Resimler, bir veya daha fazla ek açıklamalı ürün gösteren ve yapılandırılmış kaliteli resimler nasıl kullanacağınızı göstereceğim. Alışveriş Özellikli Resimler kullanmak için imageLink ve featuredProduct alanları ile birlikte tüm koleksiyonlarda kullanılabilir. Zorunlu alanlar hakkında daha fazla bilgi için Content API referans belgeleri.

Alışveriş Özellikli Resimleri kullanmak için ürün koleksiyonu oluşturmanız ve imageLink alanını kullanın. Biz kare resimler (1:1 en boy oranına sahip) kullanmanızı öneririz.

Ayrıca, featuredProduct alanı (resimdeki ürünlerin koordinatları dahil) (x ve y alanları kullanılır). Bu alanlar yalnızca koleksiyonlar için gereklidir Alışveriş Özellikli Resimlerde kullanılır. x ve y değerleri 0 ile 1 arasında olmalıdır. dahil edin.

Her koleksiyonda en fazla 100 ürün bulunabilir. Ancak, Alışveriş Özellikli Resimlerde bu resim için 10'dan fazla resim koordinatlarını belirtmenizi öneririz. ürün başına düşen ürün sayısını gösterir. Böylece, resimde ürün açıklama metinleri. İlgili içeriği oluşturmak için kullanılan offerId featuredProduct nesnesinin parçası olan alan, offerId ile eşleşmelidir products kaynağındaki değeri, bu değer id değeri products kaynağında.

Zorunlu kılınan imageLink ve featuredProduct alanlarına ek olarak Alışveriş Özellikli Resimlerde ise isteğe bağlı headline alanı. Açıklama için bir başlık eklemenizi öneririz müşterilere koleksiyonla ilgili ek bilgiler verin.

Alışveriş Özellikli Resimler için yeni bir koleksiyon oluşturmak üzerePOST Aşağıdaki URL'yi ve istek gövdesini kullanan collections.insert uç noktası:

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: Koleksiyonun durumunu kontrol etme

Yukarıda oluşturduğunuz koleksiyonda reklamların sunulması için koleksiyonu geçersiz kılarsak, GET Aşağıdaki URL'yi kullanan collectionsstatuses.get uç noktası ve id dahil durumunu görüntülemek istediğiniz koleksiyonun ait olduğu koleksiyondur. Şunları sağlamanız gerekmez: bir istek gövdesidir.

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"
    }
  ]
}