เริ่มกระบวนการยืนยันตัวตนสำหรับสถานที่ตั้ง
คำขอ 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 ระบบจะแสดง INVALID_ARGUMENT หากตั้งค่าไว้สำหรับสถานที่ตั้งธุรกิจประเภทอื่นๆ |
| ข้อมูลที่ผู้ใช้ป้อนสำหรับวิธีการที่เฉพาะเจาะจงนอกเหนือจากข้อมูลที่แสดง ข้อมูลต้องตรงกับเมธอดที่ขอ เว้นว่างไว้หากไม่ต้องการข้อมูล รายการต่อไปนี้คือช่องที่ใช้ร่วมกันไม่ได้ ระบบจะตั้งค่าช่องอย่างน้อย 1 ช่องในการตอบกลับ ดังนี้ | |
emailAddress |
ไม่บังคับ อินพุตสำหรับวิธีการ EMAIL อีเมลที่ควรส่ง PIN ไปให้ ระบบจะยอมรับอีเมลก็ต่อเมื่อเป็นอีเมลที่ระบุโดย locations.fetchVerificationOptions หาก [EmailVerificationData] [google.mybusiness-verifications.v1.VerificationOption.EmailVerificationData] มี isUserNameEditable ตั้งค่าเป็น "จริง" ลูกค้าอาจระบุชื่อผู้ใช้ (ส่วนที่อยู่หน้าเครื่องหมาย @) อื่นได้ แต่ต้องตรงกับชื่อโดเมน |
mailerContact |
ไม่บังคับ อินพุตสำหรับเมธอด ADDRESS ชื่อผู้ติดต่อที่ควรส่งอีเมลถึง |
phoneNumber |
ไม่บังคับ ข้อมูลที่ป้อนสำหรับวิธีการ PHONE_CALL/SMS หมายเลขโทรศัพท์ที่ควรโทรหาหรือส่ง SMS ไปให้ โดยต้องเป็นหมายเลขโทรศัพท์หมายเลขใดหมายเลขหนึ่งในตัวเลือกที่มีสิทธิ์ |
token |
ไม่บังคับ ข้อมูลที่ป้อนสำหรับเมธอด VETTED_PARTNER พร้อมให้พาร์ทเนอร์บางรายเลือกใช้ ไม่จำเป็นต้องป้อนข้อมูลสำหรับบัญชีที่ตรวจสอบแล้ว โทเค็นที่เชื่อมโยงกับสถานที่ตั้ง โทเค็นที่เชื่อมโยงกับสถานที่ตั้ง |
trustedPartnerToken |
อินพุตสำหรับเมธอด TRUSTED_PARTNER โทเค็นการยืนยันที่เชื่อมโยงกับสถานที่ตั้ง |
| สิ้นสุดฟิลด์ที่แยกกัน | |
เนื้อหาการตอบกลับ
ข้อความตอบกลับสำหรับ Verifications.VerifyLocation
หากทำสำเร็จ เนื้อหาการตอบกลับจะมีข้อมูลซึ่งมีโครงสร้างดังต่อไปนี้
| การแสดง JSON |
|---|
{
"verification": {
object ( |
| ช่อง | |
|---|---|
verification |
คำขอการยืนยันที่สร้างขึ้น |
ขอบเขตการให้สิทธิ์
ต้องใช้ขอบเขต OAuth ต่อไปนี้
https://www.googleapis.com/auth/business.manage
ดูข้อมูลเพิ่มเติมได้ที่ OAuth 2.0 Overview
VerificationToken
โทเค็นที่สร้างโดยพาร์ทเนอร์ที่ผ่านการตรวจสอบแล้ว
| การแสดง JSON |
|---|
{ "tokenString": string } |
| ช่อง | |
|---|---|
tokenString |
สตริงโทเค็น |