Standorte übertragen

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

Hinweis: Damit ein Standort übertragen werden kann, muss der Aufrufer Inhaber des Standorts und der Inhaber des Zielkontos mindestens Administrator des Standorts sein. Weitere Informationen zum Gewähren der Inhaberschaft eines Eintrags finden Sie unter Administratoren für Konten und Standorte verwalten.

Erste Schritte

Folgendes ist erforderlich, um Standorte zu übertragen:

Quellkonto:Das Ausgangskonto ist ein Inhaber des Standorts. Dieses Konto kann ein privates Konto oder eine Standortgruppe sein. Nach der Übertragung hat das Quellkonto keinen Zugriff mehr auf den Standort.
Zielkonto:Das Zielkonto ist das Konto, auf 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:Die OAuth 2.0-Aktualisierungs-/-Zugriffstokens für die Quell- und Zielkonten sind für jedes Konto erforderlich, um die API aufzurufen.

Standorte übertragen

Hinweis :Für Administratoren von Standorten gibt es eine Probezeit. Wenn ein Nutzer einem Profil als Inhaber oder Administrator hinzugefügt wird, kann er in einem Zeitraum von sieben Tagen bestimmte Aktionen für die Nutzer des anderen Standorts und den Standort selbst ausführen. Während dieser Probezeit ist es nicht möglich, die primäre Inhaberschaft eines Profils auf sich selbst oder einen Dritten zu übertragen.

So übertragen Sie Standorte:

1. Wenn Sie kein Inhaber des Standorts sind, müssen Sie 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.

   Hinweis :Der Empfänger kann kein Mitglied eines Organisationskontos oder einer Nutzergruppe sein.

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

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

   Hinweis: Nach der Übertragung ist das Zielkonto das primäre Konto, das dem Inhaber des Eintrags zugeordnet ist. Wenn dies nicht beabsichtigt ist, wiederholen Sie die Schritte 1 bis 3 mit einem neuen Nutzer. Übertragen Sie den Standort dann wieder in das ursprüngliche primäre Konto. Mit dem Endpunkt accounts.admins.patch können Sie ein Downgrade der Administratorrolle des ursprünglichen Zielkontos ausführen.

Rufen Sie mit den OAuth-Anmeldedaten des Zielkontos accounts.locations.list auf und prüfen Sie, ob der übertragene Standort in den Ergebnissen angezeigt wird. Wenn Sie den Endpunkt accounts.locations.list mit dem Quellkonto aufrufen, ist der übertragene Standort nicht in den Ergebnissen enthalten.

In eine Standortgruppe übertragen

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 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.