Versionshinweise zur Merchant Accounts API

Woche vom 3. August 2026

• „ucp_checkout_management“ als Diensttyp zur Ressource „AccountService“ hinzugefügt. Hinweis: UCP-Checkout ist eine Funktion mit eingeschränktem Zugriff.
• Unterstützung für das Programm „ucp-integration“ (eingeschränkter Zugriff) hinzugefügt.
• Unterstützung für die Art der Nutzungsbedingungen „ucp_integration“ hinzugefügt.

Woche vom 29. Juni 2026

• Start des Filters access, der im Endpunkt der Kontoliste verwendet wird. Mit dieser Funktion können Sie Konten nach Ihrer Zugriffsebene filtern. Mögliche Werte sind DIRECT, INDIRECT und ALL. Standardmäßig werden alle Konten zurückgegeben, auf die Sie Zugriff haben. Weitere Informationen finden Sie unter Konten filtern, auf die Sie Zugriff haben.

Woche vom 20. April 2026

• Der Liste der verfügbaren Programmnamen in der accounts.programs Ressourcenbeschreibung wurde youtube-affiliate hinzugefügt.
• Programm-API für YouTube Shopping-Affiliate aktivieren. Für Trusted Tester verfügbar.

Woche vom 6. April 2026

• Der Genehmigungsstatus wurde um den Status WAITING erweitert. 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 in der Accounts API wurde eingeführt. Damit können Entwickler programmatisch dedizierte Testkonten erstellen, die in einer isolierten Sandbox-ähnlichen Umgebung ausgeführt werden. So haben sie 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. Es muss genau einer der folgenden Werte 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 mit dem Feld setAlias in CreateAndConfigureAccountRequest einen Alias für eine Beziehung festzulegen.

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

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

Woche vom 10. November 2025

• Die Version v1alpha der Services API wurde veröffentlicht.
• Das neue Feld product_filters in der Nutzlast CampaignManagement der Services API wurde 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 Batch-Methoden 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

• Die Ressource „CheckoutSettings“ wurde eingeführt. Damit können API-Nutzer Checkout-Einstellungen erstellen, aktualisieren, löschen und abrufen.

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.

• Das schreibgeschützte Zugriffsrecht wurde eingeführt. Nutzer mit schreibgeschütztem Zugriffsrecht 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

• Die Ressource „OnlineReturnPolicy“ wurde eingeführt. Damit können API-Nutzer Rückgaberichtlinien erstellen, aktualisieren und löschen.
• Die Ressource „OmnichannelSettingsService“ und „OmnichannelSetting“ wurde eingeführt. Damit können API-Nutzer ihre Omni-Channel-Erfahrung verwalten.
• Die Ressource „LfpProvidersService“ und „LfpProvider“ wurde eingeführt. Damit können API-Nutzer ihre Local Feeds Partnership-Beziehung verwalten.
• Die Ressource „GbpAccountsService“ und „GbpAccount“ wurde eingeführt. Damit können API-Nutzer ihr Google Unternehmensprofil verwalten.
• Der Diensttyp „LocalListingManagement“ in „AccountService“ wurde eingeführt. Damit wird eine Standortgruppe verknüpft, die für Anzeigen für lokales Inventar oder lokale Einträge verwendet wird.

Woche vom 28. April 2025

• Die Ressourcen „AccountService“ und „AccountRelationship“ wurden eingeführt. Damit können API-Nutzer Beziehungen verwalten und Dienste für Dienstanbieter einrichten.

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/... (und nicht providers/...) aufgerufen werden muss. So wird verhindert, dass diese Methode außerhalb des Bereichs accounts liegt (also GET accounts/123:listSubAccounts anstelle von GET providers/123:listSubAccounts).

Woche vom 31. März 2025

• Für das Filtern von Konten wurde der Filter externalAccountId 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:

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

-Entwickler sollten ihren Code entsprechend aktualisieren.

Der Dienst AutomaticImprovements wurde eingeführt. Damit können Sie Folgendes verwalten:

• Artikelaktualisierungen
• Bildverbesserungen
• Versandverbesserungen

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 mit Eventual Consistency 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 das Filtern 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 (anstelle von accounts/123) bezeichnet werden. Das bedeutet, dass das Feld nicht mehr als Kontoreferenz gekennzeichnet ist. Aus Gründen der Abwärtskompatibilität können jedoch weiterhin Kontonamen wie accounts/123 verwendet werden.

Der Anbieter in ListSubAccountsRequest sollte jetzt das Format providers/123 haben. Aus Gründen der Abwärtskompatibilität kann jedoch weiterhin accounts/123 verwendet werden.

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 Business-Hilfe für unterstützte Versandunternehmen hinzugefügt.

Woche vom 14. Oktober 2024

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

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

ClaimHomepageRequest wurde der Parameter overwrite hinzugefügt.

Woche vom 30. September 2024

Der Parameter „force“ für die Methode „Accounts.delete“ wurde eingeführt.

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 in ListAccountIssuesRequest wurde 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-Start der Accounts-Unter-API