Telefonbestätigung

Die telefonische Bestätigung besteht aus zwei Kontomethoden, mit denen Sie Telefonnummern für ein Händlerkonto hinzufügen und bestätigen können. Mithilfe der telefonischen Bestätigung eingereichte Telefonnummern ersetzen Telefonnummern, die Sie möglicherweise über accounts.AccountBusinessInformation eingereicht haben.

Die Bestätigung der Telefonnummer wird allen neuen und bestehenden Händlern dringend empfohlen. Andernfalls wird Ihr Konto möglicherweise mit dem Kontostatusproblem PENDING_PHONE_VERIFICATION gesperrt, bis Sie eine Telefonnummer bestätigt haben.

Zum Bestätigen einer Telefonnummer sind zwei Schritte erforderlich:

  1. Rufen Sie accounts.requestphoneverification an, um eine Anfrage zur Bestätigung der Telefonnummer zu starten.
    Geben Sie Ihren aus zwei Buchstaben bestehenden Regionscode ein.
    Geben Sie Ihre Telefonnummer ein.
    Wählen Sie eine Bestätigungsmethode aus (SMS oder PHONE_CALL).
  2. Rufen Sie accounts.verifyphonenumber an, um die Telefonnummer zu bestätigen.
    Geben Sie die verificationId aus Schritt 1 ein.
    Gib die sechsstellige verificationCode ein, die an dein Smartphone gesendet wurde.
    Geben Sie die verwendete phoneVerificationMethod ein.
    Dieser Aufruf gibt ein verifiedPhoneNumber zurück. Diese Telefonnummer ist jetzt bestätigt.

Sie können den Status der Telefonbestätigung für Ihr Konto in AccountBusinessInformation.phoneVerificationStatus einsehen.

accounts.requestphoneverification

Starten Sie den Bestätigungsprozess für die Telefonnummer, indem Sie phoneRegionCode, phoneNumber und phoneVerificationMethod an accounts.requestphoneverification übergeben. Dieser Aufruf gibt verificationId zurück.

Sie können das optionale Feld languageCode verwenden, um die Prüfung in einer anderen Sprache als der Standardsprache (US-Englisch) durchzuführen.

Sie können eine Telefonnummer maximal fünfmal alle vier Stunden bestätigen.

POST https://www.googleapis.com/content/v2.1/merchantId/accounts/accountId/requestphoneverification

Hier ein Beispielaufruf:

{
  "phoneRegionCode": "US",
  "phoneNumber": "phoneNumber",
  "phoneVerificationMethod": "SMS",
  "languageCode": "en-US"
}

Sie sehen hier ein Beispiel:

{
  "verificationId": "2-47b7ef80ff494daf8079f4808e750dcb-1626331725036"
}

accounts.verifyphonenumber

Bestätigen Sie die Telefonnummer für das Konto, indem Sie die verificationId von accounts.requestphoneverification, die sechsstellige verificationCode, die an Ihr Smartphone gesendet wurde, und die verwendete phoneVerificationMethod, z. B. SMS, an accounts.verifyphonenumber übergeben. Bei diesem Anruf wird die bestätigte Telefonnummer in einem Standardformat für Ihre Region zurückgegeben.

Ihre erste Bestätigungsanfrage läuft nach 15 Minuten ab. Danach müssen Sie eine neue Anfrage zur Bestätigung der Telefonnummer stellen, bevor Sie accounts.verifyphonenumber aufrufen.

POST https://www.googleapis.com/content/v2.1/merchantId/accounts/accountId/verifyphonenumber

Hier ein Beispielaufruf:

{
  "verificationId": "verificationId",
  "verificationCode": "verificationCode",
  "phoneVerificationMethod": "SMS"
}

Sie sehen hier ein Beispiel:

{
  "verifiedPhoneNumber": "(123) 456-7890"
}

AccountBusinessInformation.phoneVerificationStatus

Sie können den Status der Telefonbestätigung für Ihr Konto im Feld AccountBusinessInformation.phoneVerificationStatus prüfen.

Rufen Sie die Methode accounts.get mit accountId und merchantId auf, um die Informationen zum Unternehmen Ihres Kontos aufzurufen:

GET https://www.googleapis.com/content/v2.1/v2.1/merchantId/accounts/accountId