Bestätigung per Telefon

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

Die Telefonbestätigung wird allen neuen und bestehenden Händlern dringend empfohlen. Andernfalls kann Ihr Konto mit dem Problem Kontostatus PENDING_PHONE_VERIFICATION gesperrt werden, bis Sie eine Telefonnummer bestätigen.

Die Bestätigung einer Telefonnummer erfolgt in zwei Schritten:

  1. Rufen Sie accounts.requestphoneverification auf, um eine telefonische Bestätigung anzufordern.
    Geben Sie den zweistelligen Regionscode ein.
    Geben Sie Ihre Telefonnummer ein.
    Wählen Sie eine Bestätigungsmethode aus (SMS oder PHONE_CALL).
  2. Rufe accounts.verifyphonenumber an, um die Telefonnummer zu bestätigen.
    : Geben Sie die verificationId aus Schritt 1 ein.
    Geben Sie den 6‑stelligen verificationCode ein, der an Ihr Smartphone gesendet wurde.
    Geben Sie die verwendete phoneVerificationMethod ein.
    Dieser Aufruf gibt eine verifiedPhoneNumber zurück. Diese Telefonnummer wurde bestätigt.

Den Status der Telefonbestätigung Ihres Kontos können Sie unter AccountBusinessInformation.phoneVerificationStatus einsehen.

accounts.requestphoneverification

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

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

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

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

Hier ein Beispiel für einen Aufruf:

{
  "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, den sechsstelligen verificationCode, der an Ihr Smartphone gesendet wurde, und die phoneVerificationMethod, die Sie verwendet haben, z. B. SMS, in accounts.verifyphonenumber übergeben. Bei diesem Aufruf 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 Telefonbestätigung anfordern, bevor Sie accounts.verifyphonenumber aufrufen.

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

Hier ein Beispiel für einen Aufruf:

{
  "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 Ihres Kontos im Feld AccountBusinessInformation.phoneVerificationStatus einsehen.

Rufen Sie die Methode accounts.get mit einem 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