Bestätigung verwalten

Anbieter, die Einträge direkt auf ihrer Plattform verwalten, können die auf ihrer Website durchführen. Es ist nicht mehr notwendig, den Händler in den Benutzeroberfläche des Unternehmensprofils

Aktuellen Status abrufen

Nutzer können locations.getVoiceOfMerchantState anrufen für einen Standort, um seinen aktuellen Status abzurufen. Wenn die hasVoiceOfMerchant ist true, befindet sich der Standort bereits in einwandfreiem Zustand und es sind keine weiteren Maßnahmen erforderlich. Wenn 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

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

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

POST
https://mybusinessverifications.googleapis.com/v1/{locationId}:fetchVerificationOptions

{
  "languageCode": "en"
}

Überprüfungsverfahren einleiten

Nachdem du eine Bestätigungsmethode ausgewählt hast, starte den Bestätigungsprozess mit locations.verify Als Ergebnis dieses Aufrufs wird der Standort in einen bestätigten Status versetzt oder es wird ein Fehlerstatus zurückgegeben.

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ätigungen abrufen

Die locations.verifications.list ruft den Verlauf der Bestätigungsanfragen und ihren Status für den im Anruf angegebenen Standort ab.

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

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

Ausstehende Bestätigung abschließen

Ein PIN-Code und die locations.verifications.complete erforderlich, um die Überprüfung eines Unternehmens abzuschließen.

So schließen Sie eine ausstehende Bestätigung ab:

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 und Funktionen zur Standorterstellung bereitstellen. Wenn Sie Händler bitten, einen neuen Standort hinzuzufügen, gehen Sie so vor:

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

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

Alternativ können Sie wie folgt nach einem potenziellen übereinstimmenden 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 Standortantwort vorhanden ist, helfen Sie dem Händler, Zugriff und Inhaberschaft für diesen Standort in Google Unternehmensprofil anzufordern.
4. Ist requestAdminRightsUrl nicht vorhanden, erstellen Sie einen neuen Standort mit der Orts-ID in der Standortantwort.
5. Bestätigen Sie den neuen Standort.

Hinweis:Wenn bei der ersten Suchanfrage keine potenziellen Standortübereinstimmungen angezeigt werden, verwenden Sie eine leere Orts-ID, um einen neuen Standort zu erstellen. Bestätigen Sie den neuen Standort.

Standortbestätigung

So starten Sie den Bestätigungsprozess über die GBP APIs:

1. Rufen Sie die Methode accounts.locations.list auf, um alle Standorte für ein Google-Konto aufzulisten.
2. Wählen Sie einen Standort zur Bestätigung aus.
3. Rufen Sie die API-Methode GetVoiceOfMerchant auf, um zu prüfen, ob dieser Standort bestätigt werden muss.
4. Wenn in der Antwort eine Bestätigung zurückgegeben wird, rufen Sie fetchVerificationOptions auf. Sie erhalten dann eine Liste mit Methoden, mit denen der Standort bestätigt werden kann.
5. Prüfe, ob die verificationOption-Daten die richtige Adresse, Telefonnummer und E-Mail-Adresse enthalten.
6. Nachdem der Händler die beste verfügbare Bestätigungsoption ausgewählt hat, rufen Sie die Methode locations.verify auf, um die entsprechende Überprüfung zu starten. Rufen Sie die locations.verifications.list. auf, um zu bestätigen, dass die Initiierung durchgeführt wird.
7. Rufen Sie die Methode locations.verification.complete mit der PIN des Händlers auf.
8. Rufen Sie die API-Methode GetVoiceOfMerchant auf. Wenn HasVoiceOfMerchant = true, haben Sie den Standort erfolgreich bestätigt.

Hinweis:Wenn für den Standort die Bestätigung AUTO verfügbar ist, muss der Händler keine Bestätigungsschritte ausführen.

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

Leitfaden zu Bestätigungsmethoden für zertifizierte Partner