Standorte übertragen

Mit der My Business Account Management API können Sie Standorte in andere Konten oder Standortgruppen übertragen. Eine entsprechende Anleitung finden Sie hier.

Erste Schritte

Folgendes ist erforderlich, um Standorte zu übertragen:

Ausgangskonto: Das Ausgangskonto ist ein Inhaber des Standorts. Es kann ein privates Konto oder eine Standortgruppe sein. Nach der Übertragung hat das Ausgangskonto keinen Zugriff mehr auf den Standort.
Zielkonto: Das Zielkonto ist das Konto, in das der Standort übertragen werden soll. Dieses Konto kann ein privates Konto oder eine Standortgruppe sein. Nach der Übertragung ist das Zielkonto der primäre Inhaber des Standorts.
OAuth 2.0-Aktualisierungs-/‑Zugriffstokens: Für den API-Aufruf sind die OAuth 2.0-Aktualisierungs-/‑Zugriffstokens für das Ausgangs- und Zielkonto erforderlich.

Standorte übertragen

So übertragen Sie Standorte:

  1. Wenn Sie kein Inhaber des Standorts sind, müssen Sie zuerst einer werden. Verwenden Sie die OAuth-Anmeldedaten des aktuellen Geschäftsinhabers, um account.admins.create aufzurufen und einen Nutzer als Inhaber des Eintrags einzuladen. Rufen Sie dann über die OAuth-Anmeldedaten des eingeladenen Nutzers accounts.invitations.list auf, um die Einladungs-ID zu erhalten. Rufen Sie accounts.invitations.accept auf, um die Einladung anzunehmen.

  2. Verwenden Sie die OAuth-Anmeldedaten des gewünschten Zielkontos, um accounts.list aufzurufen. Suchen Sie dann in der Liste nach der ID des Kontos, in das Sie den Standort übertragen möchten. Die Administrator-ID in der Antwort auf den account.admins.create-Aufruf oder den accounts.invitations.list-Aufruf in Schritt 1 kann auch als Konto-ID verwendet werden. Das kann die Konto-ID eines privaten Kontos oder einer Standortgruppe sein.

  3. Verwenden Sie Konto-ID, die Sie in Schritt 2 abgerufen haben, als Zielkonto. Das ist das Feld destinationAccount im Anfragetext, mit dem Sie locations.transfer aufrufen können.

Verwenden Sie die OAuth-Anmeldedaten des Zielkontos, um accounts.locations.list aufzurufen und zu prüfen, ob der übertragene Standort in den Ergebnissen angezeigt wird. Wenn Sie den accounts.locations.list-Endpunkt mit dem Ausgangskonto aufrufen, ist der übertragene Standort nicht in den Ergebnissen enthalten.

Um einen Standort auf eine location group in der Organisation zu übertragen, rufen Sie locations.admins.create mit den merchant-OAuth-Anmeldedaten auf. Verwenden Sie das Feld account in der Ressource Admin, um die location group account ID zusammen mit der entsprechenden role zu übergeben. Verwenden Sie die location group-Administrator-Anmeldedaten, um accounts.invitations.list mit der Konto-ID der Standortgruppe als parent-Argument aufzurufen und Einladungen zur location group abzurufen. Suchen Sie die Einladung mit der richtigen Zielregion und rufen Sie accounts.invitations.accept auf, um die richtige Einladung anzunehmen.