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.

Hinweis: Um einen Standort zu übertragen, muss der Aufrufer Inhaber des Standorts sein. Der Inhaber des Zielkontos muss mindestens Administrator des Standorts sein. 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:

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

Hinweis: Für Administratoren eines Standorts gibt es bei Unternehmensprofilen eine Probezeit. Nachdem Nutzer einem Profil als Inhaber oder Administrator hinzugefügt wurden, können sie für einen Zeitraum von 7 Tagen noch nicht alle Vorgänge für andere Nutzer des 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 auf Dritte zu ü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.

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

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

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.

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