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:
- 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
oderPHONE_CALL
).
- Rufen Sie
- 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.
- Rufen Sie
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