Collezioni di prodotti

Con le raccolte di prodotti puoi definisci gruppi di prodotti da utilizzare con formati avanzati, come Immagini Shopping Ciascuna può includere fino a 100 prodotti. Puoi creare una raccolta con Google Merchant Center o l'API Content.

Questa guida illustra come utilizzare le raccolte di prodotti tramite l'API Content, inclusi esempi di come creare una collezione per le immagini Shopping e di come per controllare lo stato di una raccolta.

Utilizza le raccolte di prodotti

L'API Content include due servizi per gestire le raccolte di prodotti:

  • collections: consente di visualizzare, elencare, inserire ed eliminare raccolte di prodotti.

  • collectionstatuses: ti consente di visualizzare ed elencare lo stato delle raccolte su Scopri se una raccolta presenta problemi che potrebbero causare non essere valido per una destinazione, ad esempio Annunci Shopping.

Esempio: creare una raccolta per le immagini Shopping

Le immagini Shopping sono molto immagini di qualità che mostrano uno o più prodotti annotati e che sono configurate utilizzando le raccolte. Per utilizzare le immagini Shopping, devi specificare i valori per i campi imageLink e featuredProduct, oltre a quelli obbligatori per in tutte le raccolte. Per ulteriori informazioni sui campi obbligatori, consulta documentazione di riferimento dell'API Content.

Per utilizzare le immagini Shopping, devi creare una raccolta di prodotti e utilizzare la imageLink per specificare un'immagine contenente fino a dieci prodotti. Me consigliamo di utilizzare immagini quadrate (con proporzioni 1:1).

Devi inoltre specificare i prodotti mostrati nell'immagine utilizzando il Campo featuredProduct, che include le coordinate dei prodotti nell'immagine utilizzando i campi x e y. Questi campi sono obbligatori solo per le raccolte utilizzati con le immagini Shopping. I valori x e y devono essere compresi tra 0 e 1, inclusi.

Ogni collezione può includere un massimo di 100 prodotti. Tuttavia, per Immagini Shopping, ti consigliamo di specificare coordinate non superiori a 10 prodotti per immagine per assicurarti che ci sia spazio sufficiente per mostrare i callout dei prodotti. La offerId che fa parte dell'oggetto featuredProduct deve corrispondere al valore offerId sulla risorsa products, che è diverso dal Valore id sulla risorsa products.

Oltre ai campi imageLink e featuredProduct, che sono obbligatori per le immagini Shopping, puoi anche specificare il titolo di una collezione utilizzando campo facoltativo headline. Ti consigliamo di includere un titolo per fornire i clienti con ulteriori dettagli sulla collezione.

Per creare una nuova raccolta per le immagini Shopping, invia una richiesta POST alla Endpoint collections.insert utilizzando il seguente URL e il seguente corpo della richiesta:

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

Esempio: controllare lo stato di una raccolta

Per scoprire se la raccolta creata in precedenza presenta problemi che potrebbero impedire alla raccolta di pubblicare annunci, invia una richiesta GET al collectionsstatuses.get utilizzando il seguente URL e includi id della raccolta di cui vuoi recuperare lo stato. Non è necessario fornire il corpo della richiesta.

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

Esempio di risposta dello stato della raccolta

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