การยืนยันทางโทรศัพท์

การยืนยันทางโทรศัพท์ประกอบด้วยวิธีการยืนยันบัญชี 2 วิธีที่คุณสามารถใช้เพื่อเพิ่มและยืนยันหมายเลขโทรศัพท์สำหรับบัญชีผู้ขาย หมายเลขโทรศัพท์ที่ส่งผ่านการยืนยันทางโทรศัพท์จะใช้แทนหมายเลขโทรศัพท์ที่คุณอาจส่งผ่าน accounts.AccountBusinessInformation

เราขอแนะนำอย่างยิ่งให้ดำเนินการยืนยันทางโทรศัพท์สำหรับผู้ขายรายใหม่และรายเดิมทั้งหมด มิเช่นนั้นบัญชีอาจถูกระงับเนื่องจากปัญหาเกี่ยวกับสถานะบัญชี PENDING_PHONE_VERIFICATION จนกว่าคุณจะยืนยันหมายเลขโทรศัพท์

การยืนยันหมายเลขโทรศัพท์มี 2 ขั้นตอนดังนี้

  1. โทรหา accounts.requestphoneverification เพื่อเริ่มคําขอยืนยันทางโทรศัพท์
    ป้อนรหัสภูมิภาค 2 ตัวอักษร
    ป้อนหมายเลขโทรศัพท์
    เลือกวิธีการยืนยัน (SMS หรือ PHONE_CALL)
  2. โทรหา accounts.verifyphonenumber เพื่อยืนยันหมายเลขโทรศัพท์
    ป้อน verificationId จากขั้นตอนที่ 1
    ป้อน verificationCode 6 หลักที่ส่งไปยังโทรศัพท์
    ป้อน phoneVerificationMethod ที่ใช้
    การเรียกนี้จะแสดงผลเป็น verifiedPhoneNumber หมายเลขโทรศัพท์นี้ได้รับการยืนยันแล้ว

คุณตรวจสอบสถานะการยืนยันทางโทรศัพท์ของบัญชีได้ใน AccountBusinessInformation.phoneVerificationStatus

accounts.requestphoneverification

เริ่มกระบวนการยืนยันหมายเลขโทรศัพท์โดยส่ง phoneRegionCode, phoneNumber และ phoneVerificationMethod ไปยัง accounts.requestphoneverification การเรียกนี้จะแสดงผลเป็นverificationId

คุณสามารถใช้ช่องตัวเลือก languageCode เพื่อยืนยันในภาษาอื่นนอกเหนือจากภาษาเริ่มต้น (อังกฤษแบบสหรัฐอเมริกา)

คุณพยายามยืนยันหมายเลขโทรศัพท์เดียวกันได้สูงสุด 5 ครั้งทุก 4 ชั่วโมง

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

ตัวอย่างการเรียกใช้มีดังนี้

{
  "phoneRegionCode": "US",
  "phoneNumber": "phoneNumber",
  "phoneVerificationMethod": "SMS",
  "languageCode": "en-US"
}

ตัวอย่างการตอบกลับมีดังนี้

{
  "verificationId": "2-47b7ef80ff494daf8079f4808e750dcb-1626331725036"
}

accounts.verifyphonenumber

ยืนยันหมายเลขโทรศัพท์ของบัญชีโดยส่ง verificationId จาก accounts.requestphoneverification, verificationCode 6 หลักที่ส่งไปยังโทรศัพท์ และ phoneVerificationMethod ที่คุณใช้ เช่น SMS ไปยัง accounts.verifyphonenumber การเรียกใช้นี้จะแสดงหมายเลขโทรศัพท์ที่ยืนยันแล้วในรูปแบบมาตรฐานสำหรับภูมิภาคของคุณ

คำขอยืนยันครั้งแรกจะหมดอายุหลังผ่านไป 15 นาที หลังจากนั้นคุณต้องเริ่มคําขอยืนยันทางโทรศัพท์ใหม่ก่อนโทรหาaccounts.verifyphonenumber

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

ตัวอย่างการเรียกใช้มีดังนี้

{
  "verificationId": "verificationId",
  "verificationCode": "verificationCode",
  "phoneVerificationMethod": "SMS"
}

ตัวอย่างการตอบกลับมีดังนี้

{
  "verifiedPhoneNumber": "(123) 456-7890"
}

AccountBusinessInformation.phoneVerificationStatus

คุณตรวจสอบสถานะการยืนยันทางโทรศัพท์ของบัญชีได้ในช่องAccountBusinessInformation.phoneVerificationStatus

เรียกใช้เมธอด accounts.get ด้วย accountId และ merchantId เพื่อดูข้อมูลทางธุรกิจของบัญชี

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