Collections de produits

Les collections de produits vous permettent de définir des groupes de produits à utiliser avec des formats enrichis, tels que les images "shoppable". Chaque collection peut inclure jusqu'à 100 produits. Vous pouvez créer une collection avec Google Merchant Center ou Content API.

Ce guide explique comment utiliser les collections de produits via Content API, par exemple comment créer une collection pour les images "shoppable" et vérifier l'état d'une collection.

Remarque : Les images "shoppable" sont actuellement le seul format d'annonce compatible avec les collections. Des formats supplémentaires peuvent toutefois être ajoutés pour que vous puissiez réutiliser vos collections dans différents formats d'annonces.

Utiliser des collections de produits

Content API inclut deux services pour gérer les collections de produits :

• collections : permet d'obtenir, de lister, d'insérer et de supprimer des collections de produits.

• collectionstatuses : permet d'obtenir et de lister l'état des collections pour déterminer si une collection présente des problèmes pouvant la rendre non valide pour une destination, comme les annonces Shopping.

Exemple : Créer une collection pour les images "shoppable"

Les images "shoppable" sont des images de haute qualité qui représentent un ou plusieurs produits annotés. Elles sont configurées à l'aide de collections. Pour utiliser des images "shoppable", vous devez spécifier des valeurs pour les champs imageLink et featuredProduct, en plus des champs obligatoires pour toutes les collections. Pour en savoir plus sur les champs obligatoires, consultez la documentation de référence de Content API.

Pour utiliser des images "shoppable", vous devez créer une collection de produits et spécifier une image contenant jusqu'à dix produits à l'aide du champ imageLink. Nous vous recommandons d'utiliser des images carrées (au format 1:1).

Important : Le champ imageLink pour les collections accepte un tableau de valeurs de liens image. Cependant, seule la première valeur du tableau est utilisée pour le format Images "shoppable".

Vous devez également spécifier les produits affichés dans l'image à l'aide du champ featuredProduct, y compris leurs coordonnées via les champs x et y. Ces champs ne sont obligatoires que pour les collections utilisées avec des images "shoppable". Les valeurs x et y doivent être comprises entre 0 et 1 inclus.

Chaque collection peut inclure 100 produits au maximum. Toutefois, pour les images "shoppable", nous vous recommandons de spécifier les coordonnées de 10 produits maximum par image. De cette façon, l'espace disponible sur l'image est suffisant pour afficher les accroches. Le champ offerId qui fait partie de l'objet featuredProduct doit correspondre à la valeur offerId de la ressource products, qui est différente de la valeur id de la ressource products.

En plus des champs imageLink et featuredProduct, qui sont obligatoires pour les images "shoppable", vous pouvez également spécifier un titre de collection à l'aide du champ facultatif headline. Nous vous recommandons d'inclure un titre pour fournir aux clients des informations supplémentaires sur la collection.

Important : Le champ headline pour les collections accepte un tableau de valeurs de titre. Cependant, seule la première valeur du tableau est utilisée pour le format Images "shoppable".

Pour créer une collection pour les images "shoppable", envoyez une requête POST au point de terminaison collections.insert à l'aide de l'URL et du corps de requête suivants :

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

Avertissement : Si une collection existe avec le même id, une requête envoyée à collections.insert remplace complètement la ressource.

Exemple : Vérifier l'état d'une collection

Pour savoir si la collection que vous avez créée ci-dessus présente des problèmes qui l'empêcheraient de diffuser des annonces, envoyez une requête GET au point de terminaison collectionsstatuses.get à l'aide de l'URL suivante et incluez l'id de la collection dont vous souhaitez récupérer l'état. Vous n'avez pas besoin de fournir un corps de requête.

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

Exemple de réponse d'état de la collection

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