Hinweis: Es stehen größere Änderungen an der API an, für die Migrationen erforderlich sein werden. Aktuelle Informationen finden Sie auf der Seite Anstehende Releases der Google My Business API und im Zeitplan für die Einstellung. Sie können sich auch auf die Mailingliste setzen lassen, um entsprechende Benachrichtigungen zu erhalten.

Bestätigung verwalten

Anbieter, die Einträge direkt auf ihrer Plattform verwalten, können das Unternehmen eines Händlers auf ihrer Website bestätigen. Der Händler muss das dann nicht selbst in der Benutzeroberfläche von Google My Business erledigen.

Hier sehen Sie eine Übersicht des Bestätigungsprozesses:

Abbildung 1: Swimlane-Diagramm für die Bestätigung von Standorten in Google My Business

Aktuellen Bestätigungsstatus abrufen

Nutzer können accounts.locations.get für einen Standort aufrufen, um seinen aktuellen Status abzurufen. Wenn location.LocationState.isVerified auf true gesetzt ist, ist der Standort bereits bestätigt. Andernfalls müssen Sie die Schritte in den folgenden Abschnitten ausführen, um ihn zu bestätigen.

Bestätigungsoptionen abrufen

Anbieter können die Methode accounts.locations.fetchVerificationOptions verwenden, um Händler aufzufordern, eine bevorzugte Kontaktmethode aus einer Liste der verfügbaren Bestätigungsmethoden auszuwählen.

Verwenden Sie folgenden Code, um die Bestätigungsoptionen abzurufen:

HTTP
POST
https://mybusiness.googleapis.com/v4/accounts/{accountId}/locations/{locationId}
:fetchVerificationOptions

{
  "languageCode": "en"
}

Bestätigungsvorgang starten

Nachdem eine Bestätigungsmethode ausgewählt wurde, wird accounts.locations.verify verwendet, um den Bestätigungsvorgang zu starten. Als Ergebnis dieses Aufrufs wechselt der Status des Standorts entweder zu bestätigt oder es wird ein Fehlerstatus zurückgegeben.

HTTP
POST
https://mybusiness.googleapis.com/v4/accounts/{accountId}/locations/{locationId}
:verify

// Use only one of the below verification methods

// For postcard verification:
{
  "method": "ADDRESS",
  "languageCode": "en",
  "addressInput": {
    "mailerContactName": "Ann Droyd"
  }
}

// For phone verification:
{
  "method": "PHONE_CALL",
  "languageCode": "en",
  "phoneInput": {
    "phoneNumber": "800-555-0136"
  }
}

// For SMS verification:
{
  "method": "SMS",
  "languageCode": "en",
  "phoneInput": {
    "phoneNumber": "800-555-0136"
  }
}

// For email verification:
{
  "method": "EMAIL",
  "languageCode": "en",
  "emailInput": {
    "emailAddress": "ex@google.com"
  }
}

Aktuelle Bestätigungsstatus abrufen

Mit dem Aufruf accounts.locations.verifications wird der aktuelle Bestätigungsstatus und -verlauf für den entsprechenden Standort abgerufen.

Verwenden Sie folgenden Code, um aktuelle Bestätigungsstatus abzurufen:

HTTP
GET
https://mybusiness.googleapis.com/v4/accounts/{accountId}/locations/{locationId}
/verifications

Ausstehende Bestätigung abschließen

Manchmal sind ein PIN-Code und die Methode accounts.locations.verifications.complete erforderlich, um die Bestätigung eines Unternehmens abzuschließen.

Verwenden Sie folgenden Code, um eine ausstehende Bestätigung abzuschließen:

HTTP
POST
https://mybusiness.googleapis.com/v4/accounts/{accountId}/locations/{locationId}
/verifications/{verificationId}:complete

{
  "pin": "123456"
}