Mit Kontodaten arbeiten

In dieser Anleitung erfahren Sie, wie Sie mit Kontodaten arbeiten. My Business Account Management API bietet Ihnen folgende Möglichkeiten:

• Alle Konten auflisten
• Ein bestimmtes Konto zurückgeben
• Aktualisieren Sie ein Konto.

Hinweis

Bevor Sie die My Business Account Management API verwenden können, müssen Sie Ihre Anwendung registrieren und OAuth 2.0-Anmeldedaten abrufen.

Weitere Informationen zu den ersten Schritten mit den Business Profile APIs finden Sie unter Grundlegende Einrichtung:

Alle Konten auflisten

Eine gute Möglichkeit, die Konten zu validieren, die mit einem authentifizierten Nutzer verknüpft sind, besteht darin, alle ihre Konten aufführen. Verwenden Sie den accounts.list. API zur Auflistung aller Konten, die einem Nutzer zugeordnet sind.

So listen Sie alle Konten für einen authentifizierten Nutzer auf:

$ GET https://mybusinessaccountmanagement.googleapis.com/v1/accounts

Ein bestimmtes Konto zurückgeben

Manchmal möchten Sie nur Informationen zu einem bestimmten Konto für ein authentifizierten Nutzer. Verwenden Sie den accounts.get. API verwenden, um ein bestimmtes Konto zurückzugeben und zusätzliche Kontodetails zu prüfen.

So rufen Sie ein bestimmtes Konto anhand des Namens ab:

$ GET https://mybusinessaccountmanagement.googleapis.com/v1/accounts/{accountId}

Konto aktualisieren

Das Ändern eines Kontonamens ist eine grundlegende administrative Aufgabe. Verwenden Sie die Methode accounts.update API zum Ändern den Kontonamen.

So aktualisieren Sie ein bestimmtes Konto anhand des Namens:

$ PUT https://mybusinessaccountmanagement.googleapis.com/v1/accounts/{accountId}

{
  "account": {
    "accountName": "Anne Droyd"
  },
  "languageCode": "en",
  "validateOnly": "true"
}

Einschränkungen

• Das einzige bearbeitbare Feld für ein Konto ist accountName. Sonstige Felder bestanden wurden, werden ignoriert.
• Nur Konten des Typs BUSINESS können auf diese Weise aktualisiert werden.