- คำขอ HTTP
- พารามิเตอร์เส้นทาง
- เนื้อความของคำขอ
- เนื้อหาการตอบกลับ
- ขอบเขตการให้สิทธิ์
- VerificationToken
เริ่มกระบวนการยืนยันสถานที่ตั้ง
คำขอ HTTP
POST https://mybusinessverifications.googleapis.com/v1/{name=locations/*}:verify
URL ใช้ไวยากรณ์การแปลง gRPC
พารามิเตอร์เส้นทาง
พารามิเตอร์ | |
---|---|
name |
ต้องระบุ ชื่อทรัพยากรของสถานที่ตั้งที่จะยืนยัน |
เนื้อหาของคำขอ
เนื้อหาของคำขอมีข้อมูลที่มีโครงสร้างต่อไปนี้
การแสดง JSON |
---|
{ "method": enum ( |
ช่อง | |
---|---|
method |
ต้องระบุ วิธีการยืนยัน |
languageCode |
ไม่บังคับ รหัสภาษา BCP 47 ที่แสดงถึงภาษาที่จะใช้ในกระบวนการยืนยัน |
context |
ไม่บังคับ ข้อมูลบริบทเพิ่มเติมสำหรับการยืนยันธุรกิจบริการ จำเป็นต้องระบุเฉพาะสถานที่ที่มีประเภทธุรกิจ CUSTOMER_LOCATION_ONLY เท่านั้น สำหรับการยืนยันที่อยู่ ระบบจะใช้ที่อยู่เพื่อส่งไปรษณียบัตร สำหรับวิธีการอื่นๆ วิธีการนั้นควรเหมือนกับวิธีการที่ส่งไปยัง GetVerificationOptions nofollow_ARGUMENT จะถูกทิ้งหากตั้งค่าไว้สำหรับที่ตั้งธุรกิจประเภทอื่นๆ |
ฟิลด์การรวม RequestData ข้อมูลอินพุตของผู้ใช้สำหรับวิธีการที่เฉพาะเจาะจงนอกเหนือจากข้อมูลการแสดงผล ข้อมูลต้องตรงกับเมธอดที่ขอ ปล่อยว่างไว้หากไม่จำเป็นต้องใช้ข้อมูล RequestData ต้องเป็นค่าใดค่าหนึ่งต่อไปนี้เท่านั้น |
|
emailAddress |
ไม่บังคับ อินพุตสำหรับเมธอด EMAIL ที่อยู่อีเมลที่ควรส่ง PIN ไปให้ เราจะยอมรับอีเมลก็ต่อเมื่ออีเมลนั้นเป็นหนึ่งในที่อยู่ที่ locations.fetchVerificationOptions ระบุไว้เท่านั้น หาก [EmailConfirmData] [google.mybusiness-verifications.v1.VerificationOption.EmailVerificationData] ตั้งค่า isUserNameEditable เป็น "จริง" ไคลเอ็นต์อาจระบุชื่อผู้ใช้อื่น (local-part) แต่ต้องตรงกับชื่อโดเมน |
mailerContact |
ไม่บังคับ อินพุตสำหรับเมธอด ADDRESS ชื่อผู้ติดต่อที่ควรส่งอีเมล |
phoneNumber |
ไม่บังคับ อินพุตสำหรับวิธี PHONE_CALL/SMS หมายเลขโทรศัพท์ที่ควรโทรหาหรือส่ง SMS ถึง ต้องเป็นหมายเลขโทรศัพท์หนึ่งในตัวเลือกที่มีสิทธิ์ |
token |
ไม่บังคับ อินพุตสำหรับเมธอด VETTED_PARTNER ที่มีให้สำหรับpartners.ที่เลือก ไม่จำเป็นต้องป้อนข้อมูลสำหรับบัญชีที่ได้รับการตรวจสอบแล้ว โทเค็นที่เชื่อมโยงกับสถานที่ตั้ง โทเค็นที่เชื่อมโยงกับสถานที่ตั้ง |
เนื้อหาการตอบกลับ
ข้อความตอบกลับสำหรับ Verifications.VerifyLocation
หากทำสำเร็จ เนื้อหาการตอบกลับจะมีข้อมูลซึ่งมีโครงสร้างดังต่อไปนี้
การแสดง JSON |
---|
{
"verification": {
object ( |
ช่อง | |
---|---|
verification |
คำขอการยืนยันที่สร้าง |
ขอบเขตการให้สิทธิ์
ต้องใช้ขอบเขต OAuth ต่อไปนี้
https://www.googleapis.com/auth/business.manage
ดูข้อมูลเพิ่มเติมได้ที่ภาพรวมของ OAuth 2.0
VerificationToken
โทเค็นที่สร้างโดยพาร์ทเนอร์ที่ผ่านการตรวจสอบ
การแสดง JSON |
---|
{ "tokenString": string } |
ช่อง | |
---|---|
tokenString |
สตริงโทเค็น |