Inizia a utilizzare i Servizi di shopping comparativo (CSS)

Eseguire operazioni di base con l'API è un buon modo per iniziare a utilizzarla.

Prerequisiti

Prima di iniziare, completa le seguenti operazioni:

  • Assicurati di avere un account CSS Center valido.
  • Registra uno sviluppatore di API.
  • Verifica la correttezza della configurazione delle autorizzazioni.
  • Verifica di aver attivato l'API CSS.
  • Verifica di aver installato le librerie client per il tuo ambiente.

Per ulteriori informazioni, consulta la sezione Guida rapida.

Abilita l'API CSS

Per registrarti come sviluppatore per utilizzare l'API CSS, devi collegare il tuo account CSS Center e il tuo progetto Google Cloud utilizzando il metodo di registrazione dello sviluppatore, come segue:

Collega CSS Center e il tuo progetto Google Cloud: il collegamento viene stabilito automaticamente, poiché il chiamante ha accesso al progetto Google Cloud in base al token di accesso o alla chiave API ed è un utente autorizzato dell'account CSS Center.

Registrare uno sviluppatore di API

Aggiungi un utente sviluppatore API all'account CSS Center: se un utente esiste già, gli verrà concesso il nuovo tipo di accesso "Sviluppatore API". Nel caso di un nuovo utente, riceve un invito via email a CSS Center.

Dopo la registrazione, puoi visualizzare lo stato della registrazione utilizzando GetDeveloperRegistration o annullare la registrazione utilizzando UnregisterGCP. Puoi utilizzare la seguente chiamata di registrazione:

POST https://merchantapi.googleapis.com/accounts/v1/accounts/{ACCOUNT_ID}/developerRegistration:registerGcp

{
      developer_email:"example-email@example.com"
}

Dopo l'esecuzione corretta della richiesta, prevedi la risposta:

{
      "developerRegistration":
{
            "name": "accounts/ACCOUNT_ID/developerRegistration",
           "gcpIds": [
            "GOOGLE_CLOUD_PROJECT_ID"
        ]
    }
}

Prodotti CSS

Analogamente alla sotto-API Products, l'API CSS distingue tra CssProductInput e ListCssProduct. Inserisci un prodotto con InsertCssProductInput.

Una volta che i nostri sistemi interni hanno elaborato il prodotto (l'operazione può richiedere alcuni minuti), recuperalo con ListCssProducts.

Identifica i tuoi prodotti utilizzando raw_provided_id. Ti consigliamo di utilizzare un identificatore che utilizzi già nel tuo sistema. In alternativa, i metodi comuni per crearne uno includono l'utilizzo di uno dei seguenti elementi:

  • Identificatori univoci globali (GUID)
  • Identificatori univoci universali (UUID)
  • Attributi di prodotto univoci concatenati (ad esempio brand_model_color_size)

Per saperne di più, consulta Inserire/Elencare/Aggiornare/Eliminare un prodotto.

Operazioni di base

Ecco alcune richieste di base che puoi provare.

  1. Inserisci un prodotto di test utilizzando InsertCssProductInput. Per assistenza sugli attributi da inviare, consulta questo codice di esempio.

  2. Elenca tutti i tuoi prodotti utilizzando ListCssProducts. Tieni presente che si verifica un piccolo ritardo di elaborazione tra l'inserimento di un prodotto e la sua visualizzazione nell'elenco. Se non ne vedi subito uno, riprova dopo qualche secondo.

  3. Aggiorna un singolo prodotto utilizzando UpdateCssProductInput utilizzando il tuo cssproductinput.name. Devi inviare solo gli attributi che devono essere aggiornati. Per un esempio, consulta il codice campione.

  4. Elimina il prodotto di test utilizzando DeleteCssProductInpu, fornendo raw_provided_id.

Limitazioni

L'inserimento o l'eliminazione di un singolo prodotto può essere lento. Per migliorare le prestazioni, utilizza Async per migliorare le prestazioni. In questo modo, è possibile chiamare l'API in parallelo.

Elencare ed etichettare i tuoi account

La gestione delle etichette nell'API CSS ti consente di organizzare in modo programmatico i tuoi account Merchant Center cliente utilizzando tag personalizzati. Questa funzionalità ti aiuta a classificare in modo efficiente i clienti (ad esempio, per tipo o strategia), consentendo una migliore organizzazione e operazioni semplificate. Puoi utilizzare l'API per eseguire le seguenti funzioni sulle etichette: