Account di test nell'API Merchant

La funzionalità Account di prova dell'API Merchant fornisce uno spazio sicuro e isolato per testare a fondo le integrazioni prima di eseguirne il deployment in un ambiente live. Utilizzando gli account di prova in sandbox, puoi sperimentare con 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 involontariamente le norme di Merchant Center.

Prerequisiti

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

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

Vantaggi degli account di prova

L'utilizzo degli account di prova offre diversi vantaggi principali:

  • Configurazione semplice: la configurazione dell'account di prova è 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 mantenere un account di produzione parallelo a scopo di test.
  • Convalida immediata delle offerte: approfitta dell'esenzione automatica dalla rivendicazione e dalla verifica della home page per gli account di prova per testare rapidamente gli inserimenti delle offerte. Per impostazione predefinita, le offerte vengono approvate per gli account di prova.
  • Simulazione realistica: l'ambiente rispecchia il comportamento di produzione per le funzionalità critiche come i caricamenti dei prodotti e la gestione dell'inventario, garantendo l'affidabilità dei risultati dei test.
  • Migrazioni API più fluide: gli account di prova facilitano una transizione sicura e senza interruzioni 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 prova

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 prova. 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 prova.

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

  • 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 prova:accountId

  {
    "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"
  }

I seguenti esempi di codice mostrano come creare un account di prova:

Java

import com.google.api.gax.core.FixedCredentialsProvider;
import com.google.auth.oauth2.GoogleCredentials;
import com.google.shopping.merchant.accounts.v1.Account;
import com.google.shopping.merchant.accounts.v1.AccountsServiceClient;
import com.google.shopping.merchant.accounts.v1.AccountsServiceSettings;
import com.google.shopping.merchant.accounts.v1.CreateTestAccountRequest;
import com.google.type.TimeZone;
import shopping.merchant.samples.utils.Authenticator;
import shopping.merchant.samples.utils.Config;

/**
 * This class demonstrates how to create a new Merchant Center test account.
 *
 * <p>For more information refer to:
 * https://developers.google.com/merchant/api/guides/accounts/test-accounts
 */
public class CreateTestAccountSample {

  // Method to create a test account.
  public static void createTestAccount(Config config, String newAccountName) throws Exception {

    // Obtains OAuth token based on the user's configuration.
    GoogleCredentials credential = new Authenticator().authenticate();

    // Creates service settings using the credentials retrieved above.
    AccountsServiceSettings accountsServiceSettings =
        AccountsServiceSettings.newBuilder()
            .setCredentialsProvider(FixedCredentialsProvider.create(credential))
            .build();

    // Calls the API and catches and prints any network failures/errors.
    try (AccountsServiceClient accountsServiceClient =
        AccountsServiceClient.create(accountsServiceSettings)) {

      // The test account to be created.
      Account account =
          Account.newBuilder()
              .setAccountName(newAccountName)
              .setTimeZone(TimeZone.newBuilder().setId("Europe/Zurich"))
              .setLanguageCode("en-US")
              .build();

      // Creates parent to identify where to insert the account.
      String parent = String.format("accounts/%s", config.getAccountId());

      // Create the request message.
      CreateTestAccountRequest request =
          CreateTestAccountRequest.newBuilder().setParent(parent).setAccount(account).build();

      System.out.println("Sending Create Test Account request:");
      Account response = accountsServiceClient.createTestAccount(request);

      System.out.println("Created Test Account below:");
      System.out.println(response);
    } catch (Exception e) {
      System.err.println("Error during test account creation:");
      e.printStackTrace();
    }
  }

  // Main method to run the sample.
  public static void main(String[] args) throws Exception {
    Config config = Config.load();

    // This is the name of the new test account to be created.
    String newAccountName = "MyNewTestShop";

    createTestAccount(config, newAccountName);
  }
}
CreateTestAccountSample.java

cURL

curl -X POST \
"https://merchantapi.googleapis.com/accounts/v1/accounts/{ACCOUNT_ID}/:createTestAccount" \
-H "Authorization: Bearer {ACCESS_TOKEN}" \
-H "Content-Type: application/json" \
-d '{
 "account_name": "{TEST_ACCOUNT_NAME}",
 "time_zone": {
   "id": "America/Los_Angeles"
   },
 "language_code": "en-US"
}'

Limitazioni

Gli account di prova sono progettati per la convalida funzionale e hanno restrizioni specifiche:

  • Numero di account di prova: puoi creare un massimo di 5 account di prova per Account Google. Gli account di prova vengono conteggiati nel 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 tratta gli account di prova come account di produzione. Gli account di prova 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 prova avanzati o convertire un account avanzato in un account di prova.
  • Nessuna pubblicazione pubblica: i dati inviati a un account di prova non verranno mai pubblicati su nessuna piattaforma Google, ad esempio nella Ricerca o negli annunci Shopping.
  • Endpoint limitati: non puoi utilizzare gli account di prova quando utilizzi determinate funzionalità, ad esempio:
  • Restrizioni di collegamento: non puoi collegare gli account di prova ad altri account Google Ads o Profilo dell'attività su Google.
  • Nessuna registrazione per gli account di prova: non puoi eseguire la registrazione per gli account di prova.

Best practice

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

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