Panoramica dell'API Merchant

Questa pagina fornisce un'introduzione all'API Merchant e spiega come utilizzarla per automatizzare i vari flussi di lavoro relativi alla gestione di account, prodotti e inventari su Merchant Center.

Puoi utilizzare l'API Merchant per raggiungere più clienti e mostrare i tuoi prodotti su Google. Puoi utilizzare l'API Merchant per gestire account Merchant Center grandi o complessi. Ecco alcuni casi d'uso tipici:

  • Gestione automatizzata dell'account
  • Gestione automatizzata dei prodotti
  • Gestione automatica dell'inventario
  • Rapporti personalizzati

L'API Merchant consente di creare e gestire più origini dati, consentendo una migliore organizzazione delle informazioni su prodotti, promozioni e recensioni. Con l'API Merchant puoi gestire i prodotti in modo da integrare altri metodi di caricamento dei dati di prodotto, come i file e il feed automatico. L'API Merchant ti consente anche di eseguire più richieste individuali in parallele.

L'API Merchant è una riprogettazione dell'API Content for Shopping e comprende più API secondarie.

I rivenditori sono tenuti a rispettare le norme relative agli annunci Shopping e alle schede senza costi. Google Shopping si riserva il diritto di applicare queste norme e di rispondere in modo appropriato se individuiamo contenuti o comportamenti che violano queste norme.

Novità dell'API Merchant

Ecco alcuni motivi per eseguire l'upgrade all'API Merchant Center:

Per ulteriori informazioni, consulta l'articolo Nuove funzionalità introdotte nella versione beta dell'API Merchant.

Prima di iniziare

Per eseguire una richiesta API Merchant, devi disporre di quanto segue:

  • Un account Merchant Center: si tratta dell'account su cui eseguirai le query, aggiornerai e caricherai i dati. Assicurati di disporre delle autorizzazioni necessarie per gestire i prodotti e gli inventari in questo account.

  • Un progetto Google Cloud: il progetto viene utilizzato per ottenere l'accesso API al tuo account.

Autenticazione con l'API Merchant

Per l'autenticazione puoi utilizzare le seguenti opzioni:

  • Puoi generare un ID client e un secret OAuth 2.0 per la tua app. L'ID e il secret possono quindi essere utilizzati per generare le credenziali OAuth 2.0 necessarie nelle chiamate API all'account Merchant Center.
  • Puoi creare un account di servizio e scaricare la relativa chiave privata per effettuare chiamate API.

ID account e ID prodotto

L'API Merchant utilizza i nomi delle risorse anziché gli ID per l'identificazione. Un esempio di nome di risorsa per un prodotto può essere accounts/123456/products/online~en~US~sku123, dove 123456 è l'identificatore univoco dell'account e online~en~US~sku123 è l'identificatore univoco del prodotto.

Formato dell'URL della richiesta

Per eseguire operazioni su una risorsa, invia richieste agli URL nel seguente formato:

https://merchantapi.googleapis.com/{SUB_API}/{VERSION}/{RESOURCE_NAME}:{METHOD}

La parte :{METHOD} viene omessa per i metodi standard come list e get.

Ad esempio, la seguente richiesta elimina l'inventario regionale:

DELETE https://merchantapi.googleapis.com/inventories/v1beta/accounts/123456/products/online~en~US~sku123/regionalInventories/456

Per creare una risorsa, puoi utilizzare il nome della risorsa della risorsa padre e il seguente URL:

POST https://merchantapi.googleapis.com/{SUB_API}/{VERSION}/{RESOURCE_NAME_OF_PARENT}/{RESOURCE}

Ad esempio, la seguente richiesta mostra come creare una regione per accounts/123456:

POST https://merchantapi.googleapis.com/accounts/v1beta/accounts/123456/regions?regionId=WA HTTP/1.1

{
  "displayName": "Washington",
  "name": "Washington",
  "postalCodeArea": {
    "postalCodes": [
      {
        "begin": "98039",
        "end": "98118"
      }
    ],
    "regionCode": "US"
  }
}

Per ulteriori dettagli su servizi specifici, consulta la documentazione di riferimento dell'API Merchant.

Iniziare a utilizzare l'API Merchant

Per scoprire rapidamente come funziona l'API Merchant e provare a caricare un prodotto di esempio, consulta la pagina Iniziare a utilizzare l'API Merchant.

Utilizza gRPC o REST

L'API Merchant supporta gRPC e REST. Ecco i due modi per effettuare chiamate all'API Merchant:

gRPC (consigliato) REST
  1. Crea il corpo della richiesta come buffer di protocollo.
  2. Invia il corpo della richiesta al server con HTTP/2.
  3. Deserializza la risposta a un buffer di protocollo.
  4. Interpreta i risultati.
  1. Crea il corpo della richiesta come oggetto JSON.
  2. Inviala al server utilizzando HTTP 1.1.
  3. Deserializza la risposta come oggetto JSON.
  4. Interpreta i risultati.

Utilizzare le librerie client e gli esempi di codice

Ogni API secondaria dispone di librerie client per aiutarti a iniziare. Gli esempi di codice possono aiutarti a iniziare a scrivere codice in Java, PHP e Python. Per maggiori informazioni, consulta la sezione Esempi per l'API Merchant.

Ricevi assistenza

Per le risorse di assistenza, consulta la pagina Ricevere assistenza per l'API Merchant.

Invia feedback

Il periodo beta ci offre l'opportunità di raccogliere e gestire i tuoi feedback prima del rilascio della disponibilità generale. Per fornire il tuo feedback, invia uno dei seguenti documenti:

  • Funzionalità dell'API: invia il modulo di feedback
  • Documentazione: utilizza le valutazioni delle miniature in-page e il pulsante Invia feedback.
  • Campioni e librerie: crea un problema nel repository GitHub per gli esempi di codice.

Per fornire un feedback generale dopo l'implementazione di ogni attività, utilizza il modulo di feedback.

Passaggi successivi

  • Per informazioni sulla compatibilità con le versioni precedenti, consulta la pagina relativa alla compatibilità con l'API Content for Shopping.

  • Per saperne di più sulle funzionalità principali dell'API Merchant, consulta le guide nel menu di navigazione a sinistra.

  • Per informazioni sulle risorse e sui servizi disponibili, consulta la documentazione di riferimento.

Avanti
Design