Account di test nell'API Merchant

La funzionalità Account di test API Merchant fornisce uno spazio sicuro e isolato per testare a fondo le integrazioni prima di eseguirne il deployment in un ambiente live. Utilizzando account di test in sandbox, puoi sperimentare le chiamate API, convalidare il codice e identificare potenziali problemi nelle prime fasi del ciclo di sviluppo, senza influire sui dati di produzione, interrompere le operazioni in tempo reale o violare inavvertitamente le norme di Merchant Center.

Prerequisiti

Prima di poter creare e utilizzare account di test, assicurati di soddisfare i seguenti requisiti:

  • Account Merchant Center:devi disporre di un account Merchant Center.
  • Accesso all'API Merchant:devi essere un utente registrato dell'API Merchant.

Vantaggi degli account di test

L'utilizzo di account di prova offre diversi vantaggi chiave:

  • Configurazione semplice:la configurazione dell'account di test è un processo a bassa complessità che ti consente di iniziare rapidamente a testare le funzionalità e le integrazioni.
  • Integrità e sicurezza dei dati:i dati di produzione rimangono protetti e il rischio di violazioni delle norme negli account di produzione viene eliminato.
  • Efficienza dei test:puoi testare un'ampia gamma di scenari diversi e casi limite senza l'onere di gestire un account di produzione parallelo a scopo di test.
  • Convalida immediata dell'offerta:approfitta dell'esenzione automatica dalla rivendicazione e dalla verifica della home page per gli account di test per testare rapidamente gli inserimenti delle offerte. Le offerte vengono approvate per impostazione predefinita per gli account di test.
  • Simulazione realistica:l'ambiente rispecchia il comportamento di produzione per funzionalità critiche come i caricamenti dei prodotti e la gestione dell'inventario, garantendo l'affidabilità dei risultati dei test.
  • Migrazioni delle API più fluide:gli account di test facilitano una transizione sicura e senza problemi per chi passa dall'API Content all'API Merchant o da una versione dell'API a un'altra, consentendo la convalida affiancata.

Come creare account di test

Gli account di prova vengono creati utilizzando un metodo personalizzato specifico nell'API Merchant.

Utilizza il metodo accounts.createTestAccount:

  POST https://merchantapi.googleapis.com/accounts/v1/accounts/{ACCOUNT_ID}:createTestAccount
  Content-Type: application/json
  Authorization: Bearer {ACCESS_TOKEN}"

  {
    "account_name": "{TEST_ACCOUNT_NAME}",
    "time_zone": {
      "id": "America/Los_Angeles"
    },
    "language_code": "en-US"
  }

Sostituisci quanto segue:

  • ACCOUNT_ID: il tuo ID Merchant Center.
  • ACCESS_TOKEN: il token di autorizzazione per effettuare la chiamata API
  • TEST_ACCOUNT_NAME: il nome dell'account di test. Ti consigliamo di utilizzare nomi significativi che suggeriscano che vengono utilizzati per i test. Ad esempio, inserisci la parola test nel nome dell'account di test.

I seguenti campi sono obbligatori quando crei un account di test:

  • time_zone: il fuso orario di reporting e visualizzazione per l'account.
  • language_code: il codice lingua BCP-47 per l'account, ad esempio en-US.

Una chiamata riuscita restituisce una risorsa Account che include l'accountId univoco e il nome della risorsa del nuovo account di test:

  {
    "name": "accounts/{TEST_ACCOUNT_ID}",
    "accountId": "{TEST_ACCOUNT_ID}",
    "accountName": "{TEST_ACCOUNT_NAME}",
    "adultContent": false,
    "testAccount": true,
    "timeZone": {
      "id": "America/Los_Angeles"
    },
    "languageCode": "en-US"
  }

Limitazioni

Gli account di test sono progettati per la convalida funzionale e hanno limitazioni specifiche:

  • Numero di account di test:puoi creare un massimo di 5 account di test per Account Google. Gli account di prova vengono conteggiati ai fini del limite predefinito di account Merchant Center per Account Google.
  • Integrazione con le quote dell'API Merchant: dal punto di vista delle quote API, l'API Merchant considera gli account di test come account di produzione. Gli account di test sono soggetti alle stesse quote degli account di produzione. Non è possibile aumentare le quote per gli account di prova.
  • Account avanzati:non puoi creare account di test avanzati o convertire un account avanzato in un account di test.
  • Nessuna pubblicazione pubblica: i dati inviati a un account di test non verranno mai pubblicati su alcuna piattaforma Google, come la Ricerca o gli annunci Shopping.
  • Endpoint con limitazioni:non puoi utilizzare account di test quando utilizzi determinate funzionalità, ad esempio:
  • Limitazioni al collegamento:non puoi collegare gli account di test ad altri account Google Ads o Profilo dell'attività su Google.
  • Nessuna registrazione per gli account di test:non puoi eseguire la registrazione per gli account di test.

Best practice

Ti consigliamo di seguire alcune best practice quando utilizzi gli account di test:

  • Sviluppo incentrato sulla sandbox:convalida sempre le nuove funzionalità di integrazione in un account di test prima di applicarle all'ambiente di produzione.
  • Test di integrazione automatizzati:utilizza gli account di test come ambienti stabili per eseguire test di regressione automatizzati.
  • Denominazione degli account di test: utilizza account_name per indicare lo scopo di ogni account di test, ad esempio "Test di migrazione" o "Account di test di integrazione".