Panoramica dell'API Merchant

Puoi utilizzare l'API Merchant per:

  • Gestire la modalità di visualizzazione della tua attività e dei tuoi prodotti su Google.
  • Ottenere l'accesso programmatico a dati, approfondimenti e funzionalità uniche.
  • Far crescere la tua attività e raggiungere un maggior numero di clienti su Google.

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

  • Gestione automatizzata dell'account
  • Gestione automatizzata dei prodotti
  • Gestione automatizzata dell'inventario
  • Gestione automatizzata dei report su rendimento e approfondimenti di mercato

L'API Merchant ti consente di creare e gestire più origini dati, migliorando l'organizzazione delle informazioni su prodotti, promozioni e recensioni. Con l'API Merchant, puoi gestire i prodotti in modo complementare ad altri metodi di caricamento dei dati di prodotto, come file e feed automatici. L'API Merchant ti consente anche di eseguire più singole richieste in parallelo.

L'API Merchant è una riprogettazione dell' API Content for Shopping. È composta da più sotto-API.

Novità dell'API Merchant

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

Prima di iniziare

Per eseguire una richiesta dell'API Merchant, devi disporre di:

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

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

  • Un link dal tuo account Merchant Center al progetto Google Cloud. Crea il link chiamando il metodo di registrazione degli sviluppatori. 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 API riceveranno comunicazioni API, inclusi annunci di servizio obbligatori, sondaggi per gli sviluppatori e opportunità.

Autenticazione con l'API Merchant

Puoi utilizzare le seguenti opzioni per l'autenticazione:

  • Puoi generare un ID client e un secret OAuth 2.0 per la tua app. L'ID e il secret possono 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.

Identificatori di account e prodotti

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/en~US~sku123, dove 123456 è l'identificatore univoco dell'account e en~US~sku123 è l'identificatore univoco di il prodotto.

Formato dell'URL della 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/online~en~US~sku123/regionalInventories/456

Per creare una risorsa, utilizza il nome della risorsa del risorsa padre 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.

Iniziare a utilizzare l'API Merchant

Per vedere rapidamente come funziona l'API Merchant e provare a caricare un prodotto di esempio, consulta la guida introduttiva all'API Merchant.

Utilizzare gRPC o REST

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

gRPC (opzione consigliata) 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. Invialo al server utilizzando HTTP 1.1.
  3. Deserializza la risposta come oggetto JSON.
  4. Interpreta i risultati.

Utilizzare librerie client ed esempi di codice

Ogni sotto-API ha 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 la pagina Esempi per l'API Merchant.

Richiedere assistenza

Per informazioni su come richiedere assistenza, consulta la pagina Richiedere assistenza per l'API Merchant.

Inviare feedback

Per inviare un feedback, invia una delle seguenti opzioni:

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

Passaggi successivi

Indietro
Latest updates
Avanti
Design