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