Panoramica dell'API Merchant

Questa pagina fornisce un'introduzione all'API Merchant e spiega come utilizzarla per automatizzare 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. Alcuni casi d'uso tipici includono:

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

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 complementare ad altri metodi di caricamento dei dati di prodotto, come file e feed automatici. L'API Merchant consente anche di eseguire più richieste individuali in parallelo.

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

Novità dell'API Merchant

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

Per ulteriori informazioni, consulta 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: Questo è 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 Google Cloud: il progetto viene utilizzato per ottenere l'accesso API al tuo account.

  • Collega il tuo account Merchant Center al progetto Google Cloud chiamando il metodo di registrazione sviluppatore. Gli utenti dell'account collegato riceveranno comunicazioni API, inclusi annunci di servizio obbligatori, sondaggi per 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 poi essere utilizzati per generare le credenziali OAuth 2.0 necessarie nelle 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 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/online~en~US~sku123, dove 123456 è l'identificatore univoco dell'account e online~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/v1beta/accounts/123456/products/online~en~US~sku123/regionalInventories/456

Per creare una risorsa, puoi utilizzare il nome 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 puoi 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 maggiori dettagli su servizi specifici, consulta la documentazione di riferimento dell'API Merchant.

Inizia a utilizzare l'API Merchant

Per vedere rapidamente come funziona l'API Merchant e provare a caricare un prodotto di esempio, consulta 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 protocol buffer.
  2. Invia il corpo della richiesta al server con HTTP/2.
  3. Deserializza la risposta in un protocol buffer.
  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 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.

Richiedi assistenza

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

Invia feedback

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

  • Funzionalità API:invia il modulo di feedback
  • Documentazione:utilizza le valutazioni con i pollici in-page e il pulsante Invia feedback.
  • Esempi e librerie: crea un problema nel repository GitHub per gli esempi di codice.

Per fornire un feedback generale dopo aver implementato ogni attività, utilizza il modulo di feedback.

Passaggi successivi

Indietro
Latest updates
Avanti
Design