Versionshinweise zur Merchant Accounts API

Woche vom 26. Oktober 2026

  • Die Dokumentation für die Methode accounts.homepage.unclaim und das Feld claimed der Ressource Homepage wurde klarer formuliert. Wenn ein Konto den Anspruch auf die Startseite von seinem erweiterten Konto übernimmt, gibt unclaim eine erfolgreiche Antwort zurück, der Anspruch auf die Startseite bleibt jedoch bestehen. Wenn das Konto selbst von der Inanspruchnahme ausgenommen ist, gibt unclaim einen FAILED_PRECONDITION-Fehler zurück.

Woche vom 28. September 2026

  • youtube_affiliate_management wurde als Diensttyp zur Ressource AccountService in v1alpha hinzugefügt. Hinweis: Die YouTube-Affiliate-Verwaltung ist eine Funktion mit eingeschränktem Zugriff.

  • Alpha-Einführung des Dienstes LoyaltyPrograms, mit dem Sie Treuepunkteprogramme verwalten können. Diese Funktion ist nur für ausgewählte Händler verfügbar. Weitere Informationen finden Sie unter Treuepunkteprogramme.

  • Das schreibgeschützte Feld home_page_uri wurde der Ressource accounts hinzugefügt, um den URI der Startseite des Stores zurückzugeben.

Woche vom 3. August 2026

  • „ucp_checkout_management“ wurde der Ressource „account service“ als Diensttyp hinzugefügt. Hinweis: Der Direktkauf über die UCP 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 Nutzungsbedingungen „ucp_integration“ hinzugefügt.

Woche vom 29. Juni 2026

  • Einführung des Filters access, der im Endpunkt für die Kontenliste verwendet wird. Mit dieser Funktion können Sie Konten anhand 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 zugreifen können.

Woche vom 20. April 2026

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

Woche vom 6. April 2026

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

Woche vom 16. März 2026

  • Die Methode CreateTestAccount in der Accounts API wurde eingeführt. So können Entwickler programmatisch dedizierte Testkonten erstellen, die in einer isolierten Sandbox-ähnlichen Umgebung ausgeführt werden. Das bietet eine sichere Umgebung für die Entwicklung und das Testen von Integrationen.

Woche vom 17. November 2025

  • CreateAndConfigureAccountRequest bietet jetzt neue Dienste, die bei der Kontoeinrichtung konfiguriert werden können. Es muss genau eines von AccountAggregation, AccountManagement und ComparisonShopping angegeben werden. Außerdem können Sie eine beliebige Anzahl von ProductsManagement- und CampaignsManagement-Diensten angeben. Es darf jedoch keine zwei Dienste mit demselben Anbieter und derselben externen Konto-ID geben.

  • Die Methode AccountsService.CreateAndConfigure bietet jetzt eine Einstellung, mit der Sie festlegen können, ob eine Bestätigungs-E-Mail gesendet werden soll.

  • CreateAndConfigureAccountRequest.AddAccountService hat jetzt ein external_account_id-Feld (dieses Feld ist bereits in der AccountService-Ressource vorhanden). Sie kann zusammen mit den Diensten CampaignsManagement und ProductsManagement angegeben werden.

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

  • Es ist jetzt möglich, während der Kontoerstellung mit dem Feld setAlias in CreateAndConfigureAccountRequest einen Alias für eine Beziehung festzulegen.

  • Der UserService wurde die Methode VerifySelf hinzugefügt, mit der der Status der Ressource User, die den Nutzer darstellt, der den Aufruf ausführt, von PENDING auf VERIFIED aktualisiert werden kann.

  • Einführung des neuen Felds radius_area in der Region-Nutzlast der Regions API, mit dem Händler Regionen anhand eines Radius erstellen können.

Woche vom 10. November 2025

  • Veröffentlichen Sie die v1alpha-Version für die Services API.
  • Einführung des neuen Felds product_filters in der Nutzlast CampaignManagement der Services API, mit dem Händler nur einen Teil ihres Feeds für Google Ads-Konten freigeben können, basierend auf einer bedingten Filterung der Attribute der Produkte des Händlers. Diese Funktion ist nur für zugelassene Konten und eine begrenzte Anzahl von Händlern verfügbar.

Woche vom 25. August 2025

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

Woche vom 1. Juli 2025

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

Woche vom 26. Mai 2025

  • Konten können jetzt nach capabilities gefiltert werden. Derzeit ist der einzige mögliche Wert CAN_UPLOAD_PRODUCTS. Mit diesem Filter können Sie Konten abrufen, die Produkte hochladen 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 zum Filtern.

  • Einführung des Lesezugriffs. Nutzer mit Lesezugriff können Händlerdaten aufrufen, aber nicht ändern.

Woche vom 19. Mai 2025

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

Woche vom 12. Mai 2025

  • Einführung der Ressource „Online-Rückgabebedingungen“, mit der API-Nutzer Rückgabebedingungen erstellen, aktualisieren und löschen können.
  • Einführung von OmnichannelSettingsService und der OmnichannelSetting-Ressource, mit denen API-Nutzer ihre Omni-Channel-Einstellungen verwalten können.
  • Einführung von LfpProvidersService und der LfpProvider-Ressource, mit denen API-Nutzer ihre Beziehung zu Partnern für lokale Feeds verwalten können.
  • Einführung des GbpAccountsService und der GbpAccount-Ressource, mit denen API-Nutzer ihr Google Unternehmensprofil verwalten können.
  • Starten Sie den Diensttyp „LocalListingManagement“ in „AccountService“, um die Unternehmensgruppe zu verknüpfen, die für Anzeigen für lokales Inventar oder lokale Einträge verwendet wird.

Woche ab dem 28. April 2025

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

Woche ab dem 14. April 2025

  • TermsOfServiceService.AcceptTermsOfService gibt jetzt die akzeptierte TermsOfServiceAgremeentState zurück, die in einem Antworttyp verpackt ist.

  • Das Verb der Aktion TermsOfServiceService.AcceptTermsOfService ist jetzt POST (früher GET).

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

Woche vom 31. März 2025

  • Der Filter externalAccountId zum Filtern von Konten wurde in der Woche vom 2. Dezember 2024 eingestellt und ist jetzt nicht mehr verfügbar. Das bedeutet, dass das Filtern nach externalAccountId jetzt nur noch auf der Ebene service 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 ab dem 3. März 2025

-Die accounts.onlineReturnPolicies#SeasonalOverride wurde refaktoriert, um die Verständlichkeit und Konsistenz zu verbessern. Zu den Änderungen gehören:

  • Felder umbenennen:
    • begin ist jetzt start_date.
    • end ist jetzt end_date.
  • Felder entfernen:
    • Das verworfene Feld policy wurde entfernt.

-Entwickler sollten ihren Code entsprechend aktualisieren.

Einführung des AutomaticImprovements-Dienstes, 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

  • Verbesserte Dokumentation für die Methode AccountsService.List. Es werden alle Konten zurückgegeben, auf die der Nutzer Zugriff hat, nicht nur eigenständige Konten.

  • Standardzeitlimit von 10 Minuten für alle RPC-Methoden hinzugefügt.

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

  • User.accessRights ist jetzt REQUIRED und wirkt sich sowohl auf die Methode UserService.Create als auch auf die Methode AccountsService.CreateAndConfigure aus.

Woche vom 27. Januar 2025

AccountsService.ListAccounts (und transitiv AccountsService.ListSubAccounts) geben Konten jetzt mit Eventual Consistency zurück, anstatt einen Strong Read auszuführen.

Woche vom 20. Januar 2025

Das Feld users von CreateAndConfigureAccountRequest wurde zugunsten eines neuen user eingestellt. Die referenzierte CreateUserRequest enthält das Feld parent, das im Kontext der CreateAndConfigureAccountRequest nicht erforderlich ist.

Woche vom 6. Januar 2025

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

Das Feld domain in zurückgegebenen Fehlern wird jetzt mit merchantapi.googleapis.com statt mit global ausgefüllt.

Woche vom 2. Dezember 2024

Zum Filtern von Konten wird das Prädikat externalAccountId von der Ebene relationship auf die Ebene service verschoben. Ein Filter relationship(externalAccountId = "foo") müsste 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 wird in naher Zukunft einen Fehler auslösen. 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 (und nicht als accounts/123) bezeichnet werden. Das bedeutet, dass das Feld nicht mehr als Kontoreferenz annotiert wird. 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 ist es jedoch weiterhin möglich, accounts/123 zu verwenden.

Woche vom 4. November 2024

Markieren Sie promotions_consent REQUIRED (von OPTIONAL) in der Ressource BusinessIdentity. Dies betrifft nur die Aktualisierungsmethode. Damit soll klargestellt werden, dass es nicht möglich ist, promotions_consent auf UNSPECIFIED zu aktualisieren. Dies war bereits nicht möglich, aber der Fehler ist jetzt aussagekräftiger und das Feld ist korrekt annotiert.

Woche vom 28. Oktober 2024

Verbesserung der Dokumentation verschiedener Ressourcen der Accounts-Sub-API, z. B. User, Homepage, BusinessInfo usw.

Woche vom 21. Oktober 2024

Die Dokumentation der update_mask-Felder in Aktualisierungsanfragen wurde verbessert, um explizit darauf hinzuweisen, welche Felder für die Aktualisierung unterstützt werden.

Link zur Google Unternehmensprofil-Hilfe für unterstützte Mobilfunkanbieter zum externen Dokument der Ressource ShippingSettings hinzugefügt

Woche vom 14. Oktober 2024

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

update_mask in der gesamten Accounts Sub-API (z.B. Unternehmensidentität, Unternehmensinformationen, Startseite usw.) und rückwirkend für die Ressource ConversionSources optional machen.

Der Parameter overwrite wurde zu ClaimHomepageRequest 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 als REQUIRED in RetrieveLatestTermsOfServiceRequest.

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 Sub-API