Mit Kontodaten arbeiten

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

• Alle Konten abrufen
• Ein bestimmtes Konto abrufen
• Ein Konto aktualisieren

Vor dem Start

Sie können die My Business Account Management API erst verwenden, nachdem Sie Ihre Anwendung registriert und OAuth 2.0-Anmeldedaten abgerufen haben.

Weitere Informationen zu den ersten Schritten mit den Google Unternehmensprofil-APIs finden Sie unter Grundlegende Einrichtung.

Alle Konten abrufen

Wenn Sie die Konten validieren möchten, die einem authentifizierten Nutzer zugewiesen sind, bietet es sich an, alle seine Konten abzurufen. Dazu können Sie die accounts.list API verwenden.

So rufen Sie alle Konten für einen authentifizierten Nutzer ab:

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

Ein bestimmtes Konto abrufen

Manchmal möchten Sie nur Informationen zu einem bestimmten Konto eines authentifizierten Nutzers abrufen. In diesem Fall können Sie die accounts.get API verwenden, um ein bestimmtes Konto abzurufen und zusätzliche Kontodetails zu prüfen.

So rufen Sie ein bestimmtes Konto anhand seines Namens ab:

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

Ein Konto aktualisieren

Das Ändern von Kontonamen ist eine grundlegende administrative Aufgabe. Sie können die accounts.update API verwenden, um den Kontonamen zu ändern.

So aktualisieren Sie ein bestimmtes Konto anhand seines 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. Alle anderen übergebenen Felder werden ignoriert.
• Nur Konten vom Typ BUSINESS können auf diese Weise aktualisiert werden.