Method: locations.verify

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

คำขอ HTTP

POST https://mybusinessverifications.googleapis.com/v1/{name=locations/*}:verify

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

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

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

string

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

เนื้อความของคำขอ

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

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

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "emailAddress": string,
  "mailerContact": string,
  "phoneNumber": string,
  "token": {
    object (VerificationToken)
  },
  "trustedPartnerToken": string
  // End of mutually exclusive fields.
}
ช่อง
method

enum (VerificationMethod)

ต้องระบุ วิธีการยืนยัน

languageCode

string

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

context

object (ServiceBusinessContext)

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

ข้อมูลที่ผู้ใช้ป้อนสำหรับวิธีการที่เฉพาะเจาะจงนอกเหนือจากข้อมูลที่แสดง ข้อมูลต้องตรงกับเมธอดที่ขอ เว้นว่างไว้หากไม่ต้องการข้อมูล รายการต่อไปนี้คือช่องที่ใช้ร่วมกันไม่ได้ ระบบจะตั้งค่าช่องอย่างน้อย 1 ช่องในการตอบกลับ ดังนี้
emailAddress

string

ไม่บังคับ อินพุตสำหรับวิธีการ EMAIL อีเมลที่ควรส่ง PIN ไปให้

ระบบจะยอมรับอีเมลก็ต่อเมื่อเป็นอีเมลที่ระบุโดย locations.fetchVerificationOptions หาก [EmailVerificationData] [google.mybusiness-verifications.v1.VerificationOption.EmailVerificationData] มี isUserNameEditable ตั้งค่าเป็น "จริง" ลูกค้าอาจระบุชื่อผู้ใช้ (ส่วนที่อยู่หน้าเครื่องหมาย @) อื่นได้ แต่ต้องตรงกับชื่อโดเมน

mailerContact

string

ไม่บังคับ อินพุตสำหรับเมธอด ADDRESS ชื่อผู้ติดต่อที่ควรส่งอีเมลถึง

phoneNumber

string

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

token

object (VerificationToken)

ไม่บังคับ ข้อมูลที่ป้อนสำหรับเมธอด VETTED_PARTNER พร้อมให้พาร์ทเนอร์บางรายเลือกใช้ ไม่จำเป็นต้องป้อนข้อมูลสำหรับบัญชีที่ตรวจสอบแล้ว โทเค็นที่เชื่อมโยงกับสถานที่ตั้ง โทเค็นที่เชื่อมโยงกับสถานที่ตั้ง

trustedPartnerToken

string

อินพุตสำหรับเมธอด TRUSTED_PARTNER โทเค็นการยืนยันที่เชื่อมโยงกับสถานที่ตั้ง

สิ้นสุดฟิลด์ที่แยกกัน

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

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

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

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

object (Verification)

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

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

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

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

ดูข้อมูลเพิ่มเติมได้ที่ OAuth 2.0 Overview

VerificationToken

โทเค็นที่สร้างโดยพาร์ทเนอร์ที่ผ่านการตรวจสอบแล้ว

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

string

สตริงโทเค็น