Testkonten in der Merchant API

Mit der Funktion „Merchant API Test Accounts“ (Merchant API-Testkonten) können Sie Integrationen in einer sicheren und isolierten Umgebung gründlich testen, bevor Sie sie in einer Live-Umgebung bereitstellen. Mit Testkonten in der Sandbox können Sie API-Aufrufe testen, Code validieren und potenzielle Probleme frühzeitig im Entwicklungszyklus erkennen, ohne Produktionsdaten zu beeinträchtigen, Echtzeitvorgänge zu unterbrechen oder unbeabsichtigt gegen Merchant Center-Richtlinien zu verstoßen.

Vorbereitung

Bevor Sie Testkonten erstellen und verwenden können, müssen Sie die folgenden Anforderungen erfüllen:

  • Merchant Center-Konto:Sie benötigen ein Merchant Center-Konto.
  • Merchant API-Zugriff:Sie müssen ein registrierter Nutzer der Merchant API sein.

Vorteile von Testkonten

Die Verwendung von Testkonten bietet mehrere wichtige Vorteile:

  • Einfache Einrichtung:Die Einrichtung des Testkontos ist ein unkomplizierter Prozess, mit dem Sie schnell mit dem Testen Ihrer Funktionen und Integrationen beginnen können.
  • Datenintegrität und ‑sicherheit:Produktionsdaten bleiben geschützt und das Risiko von Richtlinienverstößen in Produktionskonten wird eliminiert.
  • Effizienz beim Testen:Sie können eine Vielzahl verschiedener Szenarien und Grenzfälle testen, ohne ein paralleles Produktionskonto für Testzwecke verwalten zu müssen.
  • Sofortige Angebotsvalidierung:Nutzen Sie die automatische Ausnahme von der Inanspruchnahme und Bestätigung der Startseite für Testkonten, um Angebotsplatzierungen schnell zu testen. Angebote werden für Testkonten standardmäßig genehmigt.
  • Realistische Simulation:Die Umgebung spiegelt das Produktionsverhalten für wichtige Funktionen wie Produkt-Uploads und Inventarverwaltung wider, sodass die Testergebnisse zuverlässig sind.
  • Reibungslosere API-Migrationen:Mit Testkonten können Sie die Migration von der Content API zur Merchant API oder von einer API-Version zur anderen parallel validieren und so für einen reibungslosen Übergang sorgen.

Testkonten erstellen

Testkonten werden mit einer bestimmten benutzerdefinierten Methode in der Merchant API erstellt.

Verwenden Sie die Methode 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"
  }

Ersetzen Sie Folgendes:

  • ACCOUNT_ID: Ihre Merchant Center-ID.
  • ACCESS_TOKEN: das Autorisierungstoken für den API-Aufruf
  • TEST_ACCOUNT_NAME: der Name des Testkontos. Wir empfehlen, aussagekräftige Namen zu verwenden, die darauf hinweisen, dass sie für Tests verwendet werden. Der Name des Testkontos sollte beispielsweise das Wort test enthalten.

Die folgenden Felder sind beim Erstellen eines Testkontos erforderlich:

  • time_zone: Die Zeitzone für Berichte und Anzeigen für das Konto.
  • language_code: Der BCP-47-Sprachcode für das Konto, z. B. en-US.

Ein erfolgreicher Aufruf gibt eine Account-Ressource zurück, die die eindeutige accountId und den Ressourcennamen des neuen Testkontos enthält:

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

Beschränkungen

Testkonten sind für die funktionale Validierung vorgesehen und unterliegen bestimmten Einschränkungen:

  • Anzahl der Testkonten:Sie können maximal fünf Testkonten pro Google-Konto erstellen. Testkonten werden auf Ihr Standardlimit für Merchant Center-Konten pro Google-Konto angerechnet.
  • Integration mit Merchant API-Kontingenten:Aus Sicht der API-Kontingente werden Testkonten in der Merchant API wie Produktionskonten behandelt. Für Testkonten gelten dieselben Kontingente wie für Produktionskonten. Kontingenterhöhungen für Testkonten sind nicht möglich.
  • Erweiterte Konten:Sie können keine erweiterten Testkonten erstellen oder ein erweitertes Konto in ein Testkonto umwandeln.
  • Keine öffentliche Bereitstellung:Daten, die in einem Testkonto eingereicht werden, werden niemals auf einer Google-Plattform wie der Google Suche oder Shopping-Anzeigen veröffentlicht.
  • Eingeschränkte Endpunkte:Sie können Testkonten nicht verwenden, wenn Sie bestimmte Funktionen wie die folgenden nutzen:
  • Einschränkungen bei der Verknüpfung:Testkonten können nicht mit anderen Google Ads- oder Google Unternehmensprofil-Konten verknüpft werden.
  • Keine Registrierung für Testkonten:Sie können keine Registrierung für Testkonten durchführen.

Best Practices

Wir empfehlen, bei der Verwendung von Testkonten einige Best Practices zu beachten:

  • Sandbox-First Development:Validieren Sie neue Integrationsfunktionen immer in einem Testkonto, bevor Sie sie auf Ihre Produktionsumgebung anwenden.
  • Automatisierte Integrationstests:Verwenden Sie Testkonten als stabile Umgebungen zum Ausführen automatisierter Regressionstests.
  • Benennung von Testkonten:Verwenden Sie account_name, um den Zweck der einzelnen Testkonten anzugeben, z. B. „Migrationstest“ oder „Integrations-Testkonto“.