Method: accounts.locations.verify

เริ่มกระบวนการยืนยันสถานที่ตั้ง

คำขอ HTTP

POST https://mybusiness.googleapis.com/v4/{name=accounts/*/locations/*}:verify

URL ใช้ไวยากรณ์การแปลง gRPC

พารามิเตอร์เส้นทาง

พารามิเตอร์
name

string

ชื่อทรัพยากรของสถานที่ที่จะยืนยัน

เนื้อหาของคำขอ

เนื้อหาของคำขอมีข้อมูลที่มีโครงสร้างต่อไปนี้

การแสดง JSON 
{
  "method": enum (VerificationMethod),
  "languageCode": string,
  "context": {
    object (ServiceBusinessContext)
  },

  // Union field RequestData can be only one of the following:
  "emailInput": {
    object (EmailInput)
  },
  "addressInput": {
    object (AddressInput)
  },
  "phoneInput": {
    object (PhoneInput)
  }
  // End of list of possible types for union field RequestData.
}
ช่อง
method

enum (VerificationMethod)

วิธีการยืนยัน
languageCode

string

รหัสภาษา BCP 47 ที่แสดงถึงภาษาที่จะใช้ในการยืนยันตัวตน
context

object (ServiceBusinessContext)

ข้อมูลบริบทเพิ่มเติมสำหรับการยืนยันธุรกิจที่ให้บริการ ต้องระบุสำหรับสถานที่ตั้งที่มีประเภทธุรกิจเป็น CUSTOMER_LOCATION_ONLY สำหรับการยืนยันที่อยู่ ระบบจะใช้ที่อยู่ดังกล่าวเพื่อส่งไปรษณียบัตร สําหรับวิธีการอื่นๆ ควรจะเหมือนกับที่ส่งไปยัง locations.fetchVerificationOptions ระบบจะแสดงข้อผิดพลาด INVALID_ARGUMENT หากตั้งค่าไว้สำหรับสถานที่ตั้งธุรกิจประเภทอื่นๆ
ฟิลด์สหภาพ RequestData ข้อมูลอินพุตของผู้ใช้สำหรับวิธีการที่เฉพาะเจาะจงนอกเหนือจากข้อมูลการแสดงผล ข้อมูลต้องตรงกับวิธีการที่ขอ ปล่อยว่างไว้หากไม่ต้องการใช้ข้อมูล RequestData ต้องเป็นค่าใดค่าหนึ่งต่อไปนี้เท่านั้น
emailInput

object (EmailInput)

อินพุตสําหรับเมธอด EMAIL
addressInput

object (AddressInput)

อินพุตสําหรับเมธอด ADDRESS
phoneInput

object (PhoneInput)

อินพุตสำหรับเมธอด PHONE_CALL/SMS

เนื้อหาการตอบกลับ

หากทำสำเร็จ เนื้อหาการตอบกลับจะมีข้อมูลซึ่งมีโครงสร้างดังต่อไปนี้

ข้อความตอบกลับสําหรับ Verifications.VerifyLocation

การแสดง JSON 
{
  "verification": {
    object (Verification)
  }
}
ช่อง
verification

object (Verification)

คำขอการยืนยันที่สร้างขึ้น

ขอบเขตการให้สิทธิ์

ต้องใช้ขอบเขต OAuth ต่อไปนี้

  • https://www.googleapis.com/auth/plus.business.manage
  • https://www.googleapis.com/auth/business.manage

ดูข้อมูลเพิ่มเติมได้ที่ภาพรวม OAuth 2.0

EmailInput

ป้อนข้อมูลสำหรับการยืนยันอีเมล

การแสดง JSON 
{
  "emailAddress": string
}
ช่อง
emailAddress

string

อีเมลที่จะส่ง PIN ไปให้

เราจะยอมรับอีเมลก็ต่อเมื่อเป็นหนึ่งในที่อยู่ที่ locations.fetch VerificationOptions แจ้งไว้ หาก EmailVerificationData มีการตั้งค่า isUserNameEditable เป็น "จริง" ลูกค้าอาจระบุชื่อผู้ใช้อื่น (ส่วนภายใน) ได้ แต่ต้องตรงกับชื่อโดเมน

AddressInput

อินพุตสําหรับการยืนยันที่อยู่

การแสดง JSON 
{
  "mailerContactName": string
}
ช่อง
mailerContactName

string

ชื่อผู้ติดต่อที่จะส่งอีเมลไปให้

PhoneInput

อินพุตสำหรับการยืนยัน PHONE_CALL/SMS

การแสดง JSON 
{
  "phoneNumber": string
}
ช่อง
phoneNumber

string

หมายเลขโทรศัพท์ที่ควรโทรหาหรือส่ง SMS ไป หมายเลขโทรศัพท์ต้องเป็นหนึ่งในตัวเลือกที่มีสิทธิ์