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 dessen aktuellen Status festzustellen. 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 durchlaufen. 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"
}

Best Practices für die Google Unternehmensprofil-Bestätigung über die API

Standorterstellung

Mit der Business Information API von Google Unternehmensprofil können Sie Ihre Plattform einbetten, um Standorterstellungsfunktionen bereitzustellen. Wenn Sie einen Händler bitten, einen neuen Standort hinzuzufügen, gehen Sie so vor:

Erfassen Sie Standortinformationen wie den Namen, die Adresse und die Kategorie des Unternehmens vom Händler.

  1. Rufen Sie den Endpunkt googleLocations.search auf.
  2. Geben Sie Standortdaten wie den Namen des Unternehmens sowie die Kategorie, Adresse, Telefonnummer und Website in der API-Anfrage an.

Alternativ können Sie so nach einem eventuell passenden Standort suchen:

  1. Fragen Sie mögliche Standortübereinstimmungen ab.
  2. Bitten Sie den Händler, den richtigen Standort auszuwählen.
  3. Wenn requestAdminRightsUrl in der standortbezogenen Antwort vorhanden ist, unterstützen Sie den Händler dabei, in Google Unternehmensprofil Zugriff und Inhaberschaft für diesen Standort anzufordern.
  4. Ist requestAdminRightsUrl nicht vorhanden, erstellen Sie einen neuen Standort mit der Orts-ID in der standortbezogenen Antwort.
  5. Bestätigen Sie den neuen Standort.

Hinweis: Falls bei der ersten Abfrage keine Ergebnisse für Standorte zurückgegeben werden, verwenden Sie eine leere Orts-ID, um einen neuen Standort zu erstellen. Bestätigen Sie dann den neuen Standort.

Standortbestätigung

So starten Sie die Google Unternehmensprofil-Bestätigung über die API:

  1. Rufen Sie die Methode accounts.locations.list auf, um alle Standorte für ein Google-Konto aufzulisten.
  2. Wählen Sie einen zu bestätigenden Standort aus.
  3. Rufen Sie die API-Methode GetVoiceOfMerchant auf, um zu prüfen, ob dieser Standort bestätigt werden muss.
  4. Wenn dies laut Antwort erforderlich ist, rufen Sie fetchVerificationOptions auf. Es wird dann eine Liste mit Bestätigungsmethoden für diesen Standort angezeigt.
  5. Prüfen Sie noch einmal, ob die in den verificationOption-Daten enthaltene Adresse, Telefonnummer und E-Mail-Adresse richtig sind.
  6. Nachdem sich der Händler für eine Bestätigungsoption entschieden hat, rufen Sie die Methode locations.verify auf, um den entsprechenden Bestätigungsvorgang zu starten. Rufen Sie locations.verifications.list. auf, um zu bestätigen, dass der Vorgang erfolgreich gestartet wurde.
  7. Rufen Sie die Methode locations.verification.complete mit der PIN des Händlers auf.
  8. Rufen Sie die API-Methode GetVoiceOfMerchant auf. Wird HasVoiceOfMerchant = true zurückgegeben, wurde der Standort erfolgreich bestätigt.

Hinweis: Wenn für den Standort die automatische Bestätigung (AUTO) verfügbar ist, muss der Händler nichts weiter tun.

Mehr Informationen zur Bestätigung in Google Unternehmensprofil finden Sie in diesem Hilfeartikel.

Leitfaden zu Bestätigungsmethoden für zertifizierte Partner