Versionshinweise zur Merchant Accounts API

Woche vom 29. Juni 2026

Woche vom 20. April 2026

  • youtube-affiliate wurde der Liste der verfügbaren Programmnamen in der accounts.programs Ressourcenbeschreibung hinzugefügt.
  • Aktivieren Sie die Programm-API für das YouTube Shopping-Affiliate-Programm. Verfügbar für Trusted Tester.

Woche vom 6. April 2026

  • Der Status WAITING wurde dem Genehmigungsstatus hinzugefügt. Für Preisvergleichsportale ist WAITING ein Übergangsstatus zwischen PENDING und ESTABLISHED. Er wird verwendet, wenn das ursprüngliche Preisvergleichsportal Zeit benötigt, um alle erforderlichen Bereinigungen durchzuführen, bevor das Konto vollständig an das neue Preisvergleichsportal übertragen wird.

Woche vom 16. März 2026

  • Die Methode CreateTestAccount wurde in der Accounts API eingeführt. So können Entwickler programmatisch dedizierte Testkonten erstellen, die in einer isolierten Sandbox-ähnlichen Umgebung ausgeführt werden. Das bietet einen sicheren Ort, um Integrationen zu entwickeln und zu testen.

Woche vom 17. November 2025

  • CreateAndConfigureAccountRequest bietet jetzt neue Dienste, die bei der Kontoeinrichtung konfiguriert werden können. Genau einer der folgenden Werte muss angegeben werden: AccountAggregation, AccountManagement und ComparisonShopping. Außerdem können beliebig viele ProductsManagement- und CampaignsManagement-Dienste angegeben werden. Es dürfen jedoch nicht zwei solche Dienste mit derselben Anbieter- und externen Konto-ID vorhanden sein.

  • Die Methode AccountsService.CreateAndConfigure bietet jetzt eine Einstellung, mit der gesteuert werden kann, ob eine Bestätigungs-E-Mail gesendet werden soll.

  • CreateAndConfigureAccountRequest.AddAccountService hat jetzt ein external_account_id Feld. Dieses Feld ist bereits in der Ressource AccountService vorhanden. Es kann zusammen mit den Diensten CampaignsManagement und ProductsManagement angegeben werden.

  • Der Ressource AccountService wurde ein Dienst ComparisonShopping hinzugefügt. Weitere Informationen finden Sie unter https://support.google.com/merchants/answer/12653197.

  • Es ist jetzt möglich, bei der Kontoerstellung einen Alias für eine Beziehung festzulegen. Verwenden Sie dazu das Feld setAlias in CreateAndConfigureAccountRequest.

  • Der Ressource UserService wurde die Methode VerifySelf hinzugefügt, mit der der Status für die Ressource User, die den Nutzer darstellt, der den Aufruf ausführt, von PENDING in VERIFIED geändert werden kann.

  • Das neue Feld radius_area wird in der Nutzlast Region der Regions API eingeführt. Damit können Händler Regionen mit einem Radius erstellen.

Woche vom 10. November 2025

  • Die v1alpha-Version der Services API wird veröffentlicht.
  • Das neue Feld product_filters wird in der Nutzlast CampaignManagement der Services API eingeführt. Damit können Händler nur eine Teilmenge ihres Feeds für Google Ads-Konten freigeben, basierend auf einer bedingten Filterung der Attribute der Produkte des Händlers. Diese Funktion ist nur für Händler auf der Zulassungsliste verfügbar.

Woche vom 25. August 2025

  • Der Regions API wurden neue Batchmethoden hinzugefügt:
    • BatchCreateRegions: Ermöglicht das Erstellen mehrerer Regionen in einer einzigen Anfrage.
    • BatchUpdateRegions: Ermöglicht das Aktualisieren mehrerer Regionen in einer einzigen Anfrage.
    • BatchDeleteRegions: Ermöglicht das Löschen mehrerer Regionen anhand des Namens in einer einzigen Anfrage.

Woche vom 1. Juli 2025

  • Einführung der Ressource CheckoutSettings, mit der API-Nutzer CheckoutSettings erstellen, aktualisieren, löschen und abrufen können.

Woche vom 26. Mai 2025

  • Es ist jetzt möglich, Konten nach capabilities zu filtern. Derzeit ist nur der Wert CAN_UPLOAD_PRODUCTS möglich. Mit diesem Filter können Sie Konten abrufen, mit denen Produkte hochgeladen werden können. Das bedeutet, dass die folgenden Klauseln jetzt auf Kontoebene verwendet werden können:

    • capabilities:CAN_UPLOAD_PRODUCTS
    • -capabilities:CAN_UPLOAD_PRODUCTS
    • NOT capabilities:CAN_UPLOAD_PRODUCTS Weitere Informationen finden Sie im Leitfaden zur Filterung.

  • Einführung des schreibgeschützten Zugriffsrechts. Nutzer mit schreibgeschütztem Zugriff können Händlerdaten ansehen, aber nicht ändern.

Woche vom 19. Mai 2025

  • Die Dokumentation für die Programm-API wurde aktualisiert. Die falsche Aussage, dass die Methoden Enable/Disable auf Administratoren beschränkt sind, wurde entfernt.

Woche vom 12. Mai 2025

  • Einführung der Ressource Online Return Policy, mit der API-Nutzer Rückgaberichtlinien erstellen, aktualisieren und löschen können.
  • Einführung von OmnichannelSettingsService und der Ressource OmnichannelSetting, mit der API-Nutzer ihre Omni-Channel-Erfahrung verwalten können.
  • Einführung von LfpProvidersService und der Ressource LfpProvider, mit der API-Nutzer ihre Beziehung zur Local Feeds Partnership verwalten können.
  • Einführung von GbpAccountsService und der Ressource GbpAccount, mit der API-Nutzer ihr Google Unternehmensprofil verwalten können.
  • Einführung des Diensttyps LocalListingManagement in AccountService, der eine Unternehmensgruppe verknüpft, die für Anzeigen für lokales Inventar oder lokale Einträge verwendet wird.

Woche vom 28. April 2025

  • Einführung der Ressourcen AccountService und AccountRelationship, mit denen API-Nutzer Beziehungen verwalten und Dienste für Dienstanbieter einrichten können.

Woche vom 14. April 2025

  • TermsOfServiceService.AcceptTermsOfService gibt jetzt den akzeptierten TermsOfServiceAgremeentState zurück, der in einen Antworttyp eingeschlossen ist.

  • Das Verb der Aktion TermsOfServiceService.AcceptTermsOfService ist jetzt POST (zuvor GET).

  • Es wurde klargestellt, dass AccountsService.ListSubAccounts im Format accounts/... (anstatt providers/...) aufgerufen werden muss. So wird verhindert, dass diese Methode aus dem Bereich accounts fällt. Das bedeutet, dass GET accounts/123:listSubAccounts anstelle von GET providers/123:listSubAccounts verwendet werden muss.

Woche vom 31. März 2025

  • Der Filter externalAccountId wurde in der Woche vom 2. Dezember 2024 als veraltet angekündigt und ist jetzt nicht mehr verfügbar. Das bedeutet, dass die Filterung nach externalAccountId jetzt nur noch auf service Ebene möglich ist. Ein Filter wie relationship(externalAccountId = "foo") funktioniert nicht mehr und muss als relationship(service(externalAccountId = "foo")) ausgedrückt werden.

  • In der Dokumentation zu AccountsService wurde klargestellt, dass keine eigenständigen Konten erstellt werden können.

Woche vom 3. März 2025

-The accounts.onlineReturnPolicies#SeasonalOverride wurde überarbeitet, um die Klarheit und Konsistenz zu verbessern. Diese Aktualisierungen umfassen:

  • Feldumbenennung:
    • begin ist jetzt start_date.
    • end ist jetzt end_date.
  • Feldentfernung:
    • Das veraltete Feld policy wurde entfernt.

-Entwickler sollten ihren Code entsprechend aktualisieren.

Einführung des Dienstes AutomaticImprovements, mit dem Sie Folgendes verwalten können:

Weitere Informationen finden Sie unter Automatische Verbesserungen aktivieren.

Woche vom 17. Februar 2025

Das Prädikat callerHasAccessToProviderFilter() wurde aus dem Kontofilter entfernt.

Woche vom 10. Februar 2025

  • Die Dokumentation für die Methode AccountsService.List wurde verbessert. Sie gibt alle Konten zurück, auf die der Nutzer Zugriff hat, nicht nur eigenständige Konten.

  • Für alle RPC-Methoden wurde eine Standardfrist von 10 Minuten hinzugefügt.

  • Der Ressourcenbeschreibung accounts.programs wurde die Liste der verfügbaren Programmnamen hinzugefügt.

  • User.accessRights ist jetzt REQUIRED. Das betrifft sowohl die Methode UserService.Create als auch AccountsService.CreateAndConfigure.

Woche vom 27. Januar 2025

AccountsService.ListAccounts (und transitiv AccountsService.ListSubAccounts) geben Konten jetzt eventual konsistent zurück und sind keine starken Lesevorgänge mehr.

Woche vom 20. Januar 2025

Das Feld users von CreateAndConfigureAccountRequest ist veraltet und wird durch ein neues user ersetzt. Die referenzierte CreateUserRequest enthält das Feld parent, das im Kontext von CreateAndConfigureAccountRequest nicht erforderlich ist.

Woche vom 6. Januar 2025

Das Feld user der Nachricht CreateUserRequest ist jetzt korrekt als OPTIONAL gekennzeichnet.

Das Feld domain in zurückgegebenen Fehlern wird jetzt mit merchantapi.googleapis.com anstelle von global gefüllt.

Woche vom 2. Dezember 2024

Für die Filterung von Konten wird das externalAccountId Prädikat von der relationship Ebene auf die service Ebene verschoben. Ein Filter relationship(externalAccountId = "foo") muss jetzt also als relationship(service(externalAccountId = "foo")) geschrieben werden. Das alte Format wird aus Gründen der Abwärtskompatibilität weiterhin unterstützt, ist aber veraltet und führt in naher Zukunft zu einem Fehler. In der gesamten Dokumentation wird nur das neue Format erwähnt.

Woche vom 18. November 2024

Der Anbieter im Feld CreateAndConfigureAccountRequest.service.provider kann jetzt auch providers/GOOGLE_ADS oder providers/GOOGLE_BUSINESS_PROFILE sein. Andere Konten sollten als providers/123 (anstatt accounts/123) bezeichnet werden. Das bedeutet, dass das Feld nicht mehr als Kontoreferenz gekennzeichnet ist. Aus Gründen der Abwärtskompatibilität ist es jedoch weiterhin möglich, Kontonamen wie accounts/123 zu verwenden.

Der Anbieter in ListSubAccountsRequest sollte jetzt das Format providers/123 haben. Aus Gründen der Abwärtskompatibilität ist es jedoch weiterhin möglich, accounts/123 zu verwenden.

Woche vom 4. November 2024

Markieren Sie promotions_consent in der Ressource BusinessIdentity als REQUIRED (von OPTIONAL). Das betrifft nur die Aktualisierungsmethode. So wird klargestellt, dass promotions_consent nicht auf UNSPECIFIED aktualisiert werden kann. Das war bereits nicht möglich, aber der Fehler ist jetzt aussagekräftiger und das Feld ist korrekt gekennzeichnet.

Woche vom 28. Oktober 2024

Die Dokumentation verschiedener Ressourcen der Accounts-Unter-API wie User, Homepage, BusinessInfo usw. wurde verbessert.

Woche vom 21. Oktober 2024

Die Dokumentation der Felder update_mask in Aktualisierungsanfragen wurde verbessert, um genau anzugeben, welche Felder für die Aktualisierung unterstützt werden.

Der externen Dokumentation der Ressource ShippingSettings wurde ein Link zur Google-Hilfe für Unternehmen mit unterstützten Versandunternehmen hinzugefügt.

Woche vom 14. Oktober 2024

Markieren Sie provider in AccountsService.CreateAndConfigureAccountRequest.AddAccountService als REQUIRED.

Markieren Sie update_mask in der gesamten Accounts-Unter-API als optional (z.B. Unternehmensidentität, Unternehmensinformationen, Homepage usw.) und rückwirkend für die Ressource ConversionSources.

ClaimHomepageRequest wurde der Parameter overwrite hinzugefügt.

Woche vom 30. September 2024

Einführung des Parameters „force“ für die Methode „Accounts.delete“.

Woche vom 23. September 2024

Markieren Sie region_code und kind in RetrieveLatestTermsOfServiceRequest als REQUIRED.

Woche vom 16. September 2024

Der Typ des Parameters time_zone wurde in ListAccountIssuesRequest in „String“ geändert.

Woche vom 12. August 2024

Der Ressource BusinessInfo wurde das Feld korean_business_registration_number hinzugefügt.

Woche vom 27. Mai 2024

Beta-Einführung der Accounts-Unter-API