Aktualisieren Sie die Integration der Google Business Profile API, bevor wichtige Endpunkte deaktiviert werden. Im Zeitplan für die Einstellung finden Sie weitere Informationen und eine Anleitung, wie Sie Unterbrechungen ab April 2022 vermeiden können.

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 Google Unternehmensprofil-UI erledigen.

Aktuellen Status abrufen

Nutzer können locations.getVoiceOfMerchantState für einen Standort aufrufen, um seinen aktuellen Status abzurufen. Wenn der boolesche Wert hasVoiceOfMerchant true ist, wurde der Standort bereits bestätigt und es sind keine weiteren Maßnahmen erforderlich. Falls die Aktion gain_voice_of_merchant in der Antwort verify enthält, müssen Sie die Bestätigung abschließen. Weitere Informationen finden Sie in der Anleitung unten.

Bestätigungsoptionen abrufen

Anbieter können die Methode 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://mybusinessverifications.googleapis.com/v1/{locationId}:fetchVerificationOptions

{
  "languageCode": "en"
}

Bestätigungsvorgang starten

Wählen Sie eine Bestätigungsmethode aus und starten Sie den Vorgang dann mit locations.verify. Als Ergebnis dieses Aufrufs wird der Status des Standorts entweder zu bestätigt geändert oder es wird ein Fehlerstatus zurückgegeben.

HTTP
POST
https://mybusinessverifications.googleapis.com/v1/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 locations.verifications.list werden der Verlauf der Bestätigungsanfragen und ihr Status für den im Aufruf angegebenen Standort abgerufen.

Verwenden Sie folgenden Code, um alle Bestätigungsanfragen abzurufen:

HTTP
GET
https://mybusinessverifications.googleapis.com/v1/locations/{locationId}
/verifications

Ausstehende Bestätigung abschließen

Normalerweise sind ein PIN-Code und die Methode 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://mybusinessverifications.googleapis.com/v1/locations/{locationId}
/verifications/{verificationId}:complete

{
  "pin": "123456"
}