Telefonbestätigung

Für die Bestätigung von Telefonnummern gibt es zwei Kontomethoden, mit denen du Telefonnummern für ein Händlerkonto hinzufügen und bestätigen kannst. Telefonnummern, die über die Bestätigung der Telefonnummer eingereicht werden, 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 Problem Kontostatus 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 erhalten.
    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 den 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 telefonischen Bestätigung für Ihr Konto unter AccountBusinessInformation.phoneVerificationStatus einsehen.

accounts.requestphoneverification

Starten Sie den Prozess zur Bestätigung der Telefonnummer. Übergeben Sie dazu phoneRegionCode, phoneNumber und phoneVerificationMethod an accounts.requestphoneverification. Dieser Aufruf gibt verificationId zurück.

Sie können das optionale Feld languageCode verwenden, um die Bestätigung in einer anderen Sprache als der Standardsprache (Englisch (USA)) 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 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 von accounts.requestphoneverification, die sechsstellige verificationCode, die an dein Smartphone gesendet wurde, und die phoneVerificationMethod, die du verwendet hast, z. B. SMS, an accounts.verifyphonenumber übergibst. 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 musst du eine neue Anfrage zur Bestätigung der Telefonnummer senden, bevor du accounts.verifyphonenumber anrufst.

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 telefonischen Bestätigung für Ihr Konto finden Sie im Feld AccountBusinessInformation.phoneVerificationStatus.

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