Telefonbestätigung

Die Bestätigung per Telefonnummer umfasst zwei Kontomethoden, mit denen Sie Telefonnummern für ein Händlerkonto hinzufügen und bestätigen können. Telefonnummern, die über die Bestätigung per Telefon eingereicht wurden, ersetzen Telefonnummern, die Sie möglicherweise über accounts.AccountBusinessInformation eingereicht haben.

Die Bestätigung der Telefonnummer wird für alle neuen und bestehenden Händler dringend empfohlen. Andernfalls wird Ihr Konto möglicherweise mit dem Kontostatus-Problem PENDING_PHONE_VERIFICATION gesperrt, bis Sie eine Telefonnummer bestätigen.

Zur Bestätigung einer Telefonnummer sind zwei Schritte erforderlich:

  1. Rufen Sie accounts.requestphoneverification an, um eine Bestätigungsanfrage per Telefon zu starten.
    Geben Sie Ihren zweistelligen 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.
    Geben Sie den sechsstelligen verificationCode ein, der an Ihr Smartphone gesendet wurde.
    Geben Sie die verwendete phoneVerificationMethod ein.
    Dieser Aufruf gibt eine verifiedPhoneNumber zurück. Diese Telefonnummer ist jetzt bestätigt.

Den Status der Bestätigung per SMS für Ihr Konto können Sie unter AccountBusinessInformation.phoneVerificationStatus einsehen.

accounts.requestphoneverification

Starte den Bestätigungsprozess für die Telefonnummer, indem du phoneRegionCode, phoneNumber und phoneVerificationMethod an accounts.requestphoneverification weitergibst. Dieser Aufruf gibt eine verificationId zurück.

Mit dem optionalen Feld languageCode können Sie die Bestätigung in einer anderen Sprache als der Standardsprache (US-Englisch) vornehmen.

Sie können versuchen, dieselbe Telefonnummer alle vier Stunden maximal fünfmal zu 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ätige die Telefonnummer für das Konto, indem du die verificationId aus accounts.requestphoneverification, die sechsstellige verificationCode, die an dein Smartphone gesendet wurde, und die von dir verwendete phoneVerificationMethod, z. B. SMS, an accounts.verifyphonenumber weitergibst. Dieser Aufruf gibt die bestätigte Telefonnummer in einem Standardformat für Ihre Region zurück.

Ihre erste Bestätigungsanfrage läuft nach 15 Minuten ab. Anschließend müssen Sie einen neuen Antrag auf Bestätigung per Telefon stellen, bevor Sie accounts.verifyphonenumber anrufen können.

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

Den Status der Bestätigung per Telefon für Ihr Konto können Sie im Feld AccountBusinessInformation.phoneVerificationStatus einsehen.

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

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