Panoramica dell'API Merchant

Puoi utilizzare l'API Merchant per:

  • Gestisci il modo in cui la tua attività e i tuoi prodotti vengono visualizzati su Google.
  • Ottieni l'accesso programmatico a dati, insight e funzionalità uniche.
  • Fai crescere la tua attività e raggiungi più clienti su Google.

L'API Merchant può gestire account Merchant Center di grandi dimensioni o complessi. I casi d'uso tipici includono:

  • Gestione automatizzata degli account
  • Gestione automatizzata dei prodotti
  • Gestione automatica dell'inventario
  • Gestione automatizzata dei report sul rendimento e su Market Insights

L'API Merchant ti 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 consente anche di eseguire più richieste singole in parallelo.

L'API Merchant è una versione riprogettata dell'API Content for Shopping. Comprende più API secondarie.

Novità dell'API Merchant

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

Prima di iniziare

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

  • Un account Merchant Center: questo è l'account su cui eseguirai query, aggiornamenti e caricamenti dei dati. Assicurati di disporre delle autorizzazioni necessarie per gestire i prodotti e gli inventari su questo account.

  • Un progetto cloud Google Cloud: utilizza il progetto per ottenere l'accesso all'API per il tuo account.

  • Un link dal tuo account Merchant Center al progetto Google Cloud. Crea il link chiamando il metodo di registrazione dello sviluppatore. Utilizzerai questo account e questi utenti per le comunicazioni relative all'integrazione dell'API, ai sondaggi e alle opportunità.

  • Collega il tuo account Merchant Center al progetto Google Cloud registrandoti come sviluppatore. Gli utenti con il ruolo di sviluppatore di API riceveranno comunicazioni relative alle API, tra cui annunci di servizio obbligatori, sondaggi per gli sviluppatori e opportunità.

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 poi essere utilizzati per generare le credenziali OAuth 2.0 necessarie per le chiamate API all'account Merchant Center.
  • Puoi creare un service account e scaricare la relativa chiave privata per effettuare chiamate API.

Identificatori di account e ID prodotto

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

Formato dell'URL di richiesta

Per operare 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/v1/accounts/123456/products/en~US~sku123/regionalInventories/456

Per creare una risorsa, utilizza il nome della risorsa della risorsa principale e questo 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/v1/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.

Inizia a utilizzare l'API Merchant

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

Utilizza gRPC o REST

L'API Merchant supporta gRPC e REST. Ecco i due modi per effettuare chiamate 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 in un buffer di protocollo.
  4. Interpreta i risultati.
  1. Crea il corpo della richiesta come oggetto JSON.
  2. Inviarla al server utilizzando HTTP 1.1.
  3. Deserializza la risposta come oggetto JSON.
  4. Interpreta i risultati.

Utilizza 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 saperne di più, consulta Esempi per l'API Merchant.

Ricevi assistenza

Per informazioni su come ricevere assistenza, consulta Ricevi assistenza per l'API Merchant.

Invia feedback

Per fornire un feedback, invia uno dei seguenti elementi:

  • Funzionalità dell'API: seleziona l'opzione Invia feedback nella sezione Qual è il problema/la domanda? del modulo di feedback.
  • Documentazione: utilizza le valutazioni con il pollice nella pagina e il pulsante Invia feedback.
  • Esempi e librerie: crea un problema nel repository GitHub per gli esempi di codice.

Passaggi successivi

Avanti
Merchant API terms and conditions