Panoramica dell'API Merchant Products

Questa pagina spiega come caricare e gestire i prodotti in modo programmatico. Con l'API Merchant Products, puoi inserire o aggiornare un prodotto in un'origine data, recuperare un prodotto dal tuo account ed eliminare un prodotto da un'origine data.

L'API Merchant Products contiene due risorse.

  • productInputs rappresenta le parti di input dei tuoi prodotti.
  • products rappresenta i prodotti elaborati creati dalle parti di input.

productInputs può essere principale e supplementare, a seconda che venga caricato in un'origine dati principale o in un'origine dati supplementare. Ogni product verrà costruito da un singolo productInput principale e da un qualsiasi numero di productInputs supplementari.

Puoi utilizzare l'API Merchant Products per creare cataloghi di negozi online o locali, ovvero prodotti che possono essere visualizzati su più destinazioni di acquisto. Puoi utilizzare la risorsa productInputs dopo aver creato il tuo account Merchant Center, aver configurato la tua prima origine dati e aver caricato un primo insieme di prodotti tramite l'API.

Sebbene i commercianti abbiano la possibilità di caricare i prodotti utilizzando un file chiamato PrimaryProductDataSource, esistono diversi vantaggi nella creazione e nell'eliminazione dei prodotti tramite l'API Merchant. Questi vantaggi includono tempi di risposta più rapidi e la possibilità di aggiornare i prodotti in tempo reale, senza dover gestire file di grandi dimensioni. Potrebbero essere necessarie fino a diverse ore prima che le modifiche ai prodotti apportate tramite le chiamate API vengano visualizzate nel database Shopping.

Prerequisiti

Se non hai un'origine dati, creane una utilizzando l'API Merchant DataSources o Merchant Center.

Se hai già un'origine dati creata utilizzando l'interfaccia utente di Merchant Center o l'API, puoi utilizzare l'API Merchant Products per aggiungere i tuoi prodotti. Se utilizzi l'API Content for Shopping per aggiungere prodotti, consulta la guida alla migrazione per scoprire come iniziare a utilizzare l'API Merchant Products.

Sei responsabile della conformità alle norme relative agli annunci Shopping e alle schede senza costi. Google si riserva il diritto di applicare queste norme e di rispondere in modo appropriato se vengono rilevati contenuti o comportamenti che le violano.

Risorse

La risorsa products ti consente di recuperare le informazioni sui prodotti dal database Shopping.

La risorsa productInput rappresenta i dati di input che invii per un prodotto. Fornisce inoltre metodi che ti consentono di aggiornare o eliminare le informazioni sui prodotti una alla volta o più alla volta in modalità batch. Una risorsa productInput deve avere i seguenti campi:

  • channel: il canale del prodotto.
  • offerId: l'identificatore univoco del prodotto.
  • contentLanguage: il codice lingua ISO 639-1 di due lettere per il prodotto.
  • feedLabel: l'etichetta del feed per il prodotto.

Caricare un input del prodotto nel tuo account

Per caricare un input del prodotto nel tuo account, utilizza il metodo accounts.productInputs.insert. Devi passare l'identificatore univoco dell'origine dati principale o supplementare.

La seguente richiesta di esempio mostra come utilizzare il metodo accounts.productInputs.insert per caricare un input prodotto nel tuo account commerciante. La richiesta imposta il prezzo e la regione di spedizione, nonché attributi personalizzati come la data di produzione e le dimensioni.

POST https://merchantapi.googleapis.com/products/v1beta/accounts/{ACCOUNT_ID}/productInputs:insert?dataSource={DATASOURCE}

{
  "name": "{PRODUCT_TITLE}",
  "versionNumber": {VERSION_NUMBER},
  "contentLanguage": "{CONTENT_LANGUAGE}",
  "feedLabel": "{FEED_LABEL}",
  "offerId": "{OFFER_ID}",
  "channel": "ONLINE",
  "attributes": {
    "availability": "in stock",
    "imageLink": "{IMAGE_LINK}",
    "link": "{PRODUCT_LINK}",
    "brand": "{BRAND_NAME}",
    "price": {
      "currencyCode": "{CURRENCY_CODE}",
      "amountMicros": {PRICE}
    },
    "color": "red",
    "productWeight": {
      "value": 320,
      "unit": "g"
    },
    "adult": false,
    "shipping": [
      {
        "country": "GB",
        "price": {
          "amountMicros": {SHIPPING_COST},
          "currencyCode": "{CURRENCY_CODE_SHIPPING}"
        },
        "postalCode": "{SHIPPING_POSTALCODE}",
        "service": "",
        "region": "{SHIPPING_REGION}",
        "maxHandlingTime": "{MAX_HANDLING_TIME}",
        "minHandlingTime": "{MIN_HANDLING_TIME}",
        "maxTransitTime": "{MAX_TRANSIT_TIME}",
        "minTransitTime": "{MIN_TRANSIT_TIME}"
      }
    ],
    "gender": "Female"
  },
  "customAttributes": [
    {
      "name": "size",
      "value": "Large"
    },
    {
      "name": "Date of Manufacturing",
      "value": "2024-05-05"
    }
  ]
}

Sostituisci quanto segue:

  • {ACCOUNT_ID}: l'identificatore univoco del tuo account Merchant Center.
  • {DATASOURCE}: l'identificatore univoco della fonte di dati. Deve essere nel formato accounts/{ACCOUNT_ID}/dataSources/{DATASOURCE_ID}.
  • {PRODUCT_TITLE}: il nome del prodotto.
  • {VERSION_NUMBER}: il numero di versione del prodotto. Facoltativo.
  • {CONTENT_LANGUAGE}: il codice lingua ISO 639-1 di due lettere del prodotto. Obbligatorio.
  • {FEED_LABEL}: il codice di territorio CLDR per la regione in cui vuoi vendere il prodotto. Se il valore fornito per feedLabel non è valido, il campo targetCountry non viene compilato.
  • {OFFER_ID}: l'identificatore univoco del prodotto. Obbligatorio.
  • {IMAGE_LINK}: il link all'immagine del prodotto sul tuo sito web. Facoltativo.
  • {PRODUCT_LINK}: il link al prodotto sul tuo sito web. Facoltativo.
  • {CURRENCY_CODE}: la valuta del prezzo utilizzando acronimo di tre lettere in base allo standard ISO 4217. Facoltativo.
  • {PRICE}: il prezzo del prodotto rappresentato come numero in micro. Facoltativo.
  • {SHIPPING_COST}: il prezzo fisso della spedizione rappresentato come numero. Facoltativo.
  • {SHIPPING_POSTALCODE}: l'intervallo di codici postali a cui si applica la tariffa di spedizione. Facoltativo.
  • {MAX_HANDLING_TIME}: il tempo di elaborazione massimo in giorni lavorativi tra la ricezione e la spedizione dell'ordine. Facoltativo.
  • {MIN_HANDLING_TIME}: il tempo di elaborazione minimo in giorni lavorativi tra la ricezione e la spedizione dell'ordine. Il valore 0 indica che l'ordine viene consegnato lo stesso giorno in cui viene ricevuto. Facoltativo.
  • {MAX_TRANSIT_TIME}: il tempo di transito massimo in giorni lavorativi tra la data di spedizione e la data di consegna dell'ordine. Facoltativo.
  • {MIN_TRANSIT_TIME}: il tempo di transito minimo in giorni lavorativi tra la data di spedizione e la data di consegna dell'ordine. Il valore 0 indica che l'ordine viene consegnato lo stesso giorno della spedizione. Facoltativo.

Quando la richiesta viene eseguita correttamente, viene visualizzata la seguente risposta:

{
  "name": "{PRODUCT_NAME}",
  "product": "{PRODUCT_ID}",
  "channel": "ONLINE",
  "offerId": "{OFFER_ID}",
  "contentLanguage": "{CONTENT_LANGUAGE}",
  "feedLabel": "{FEED_LABEL}",
  "versionNumber": "{VERSION_NUMBER}",
  "attributes": {
    "link": "{PRODUCT_LINK}",
    "imageLink": "{IMAGE_LINK}",
    "adult": false,
    "availability": "in stock",
    "brand": "{BRAND_NAME}",
    "color": "red",
    "gender": "Female",
    "price": {
      "amountMicros": "{PRICE}",
      "currencyCode": "{CURRENCY_CODE}"
    },
    "shipping": [
      {
        "price": {
          "amountMicros": "{SHIPPING_COST}",
          "currencyCode": "{CURRENCY_CODE}"
        },
        "country": "{SHIPPING_COUNTRY}",
        "region": "{SHIPPING_REGION}",
        "postalCode": "{SHIPPING_POSTALCODE}",
        "minHandlingTime": "{MIN_HANDLING_TIME}",
        "maxHandlingTime": "{MAX_HANDLING_TIME}",
        "minTransitTime": "{MIN_TRANSIT_TIME}",
        "maxTransitTime": "{MAX_TRANSIT_TIME}"
      }
    ],
    "productWeight": {
      "value": 320,
      "unit": "g"
    }
  },
  "customAttributes": [
    {
      "name": "Size",
      "value": "Large"
    },
    {
      "name": "Date of Manufacturing",
      "value": "2024-05-05"
    }
  ]
}

Recuperare un prodotto elaborato dal tuo account

Per recuperare un prodotto elaborato dal tuo account, utilizza il metodo accounts.products.get. Potrebbero essere necessari diversi minuti prima che il prodotto elaborato venga visualizzato dopo l'inserimento.

Puoi ottenere il nome della risorsa del prodotto elaborato dal campo product nella risposta di accounts.productInputs.insert

Eliminare un input del prodotto dal tuo account

Per eliminare un input del prodotto dal tuo account, utilizza il metodo accounts.productInputs.delete. Per eliminare un prodotto utilizzando l'API Merchant Products, devi passare l'identificatore univoco dell'origine dati principale o supplementare a cui appartiene il prodotto.

Elenca i prodotti dal tuo account

Per elencare i prodotti elaborati nel tuo account, utilizza il accounts.products.list metodo.