Method: locations.fetchVerificationOptions

รายงานตัวเลือกการยืนยันที่มีสิทธิ์ทั้งหมดสำหรับสถานที่ตั้งหนึ่งๆ เป็นภาษาใดภาษาหนึ่ง

คำขอ HTTP

POST https://mybusinessverifications.googleapis.com/v1/{location=locations/*}:fetchVerificationOptions

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

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

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

string

ต้องระบุ สถานที่ที่ต้องยืนยัน

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

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

การแสดง JSON
{
  "languageCode": string,
  "context": {
    object (ServiceBusinessContext)
  }
}
ช่อง
languageCode

string

ต้องระบุ รหัสภาษา BCP 47 ซึ่งแสดงภาษาที่ใช้สำหรับกระบวนการยืนยัน ตัวเลือกที่มีจะแตกต่างกันไปตามภาษา

context

object (ServiceBusinessContext)

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

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

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

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

การแสดง JSON
{
  "options": [
    {
      object (VerificationOption)
    }
  ]
}
ช่อง
options[]

object (VerificationOption)

ตัวเลือกการยืนยันที่มีให้

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

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

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

สำหรับข้อมูลเพิ่มเติม โปรดดูที่ภาพรวมของ OAuth 2.0

VerificationOption

ตัวเลือกการยืนยันแสดงถึงวิธียืนยันสถานที่ (ระบุโดยวิธีการยืนยัน) และตำแหน่งที่จะส่งการยืนยัน (ระบุด้วยข้อมูลที่แสดง)

การแสดง JSON
{
  "verificationMethod": enum (VerificationMethod),

  // Union field DisplayData can be only one of the following:
  "phoneNumber": string,
  "addressData": {
    object (AddressVerificationData)
  },
  "emailData": {
    object (EmailVerificationData)
  },
  "announcement": string
  // End of list of possible types for union field DisplayData.
}
ช่อง
verificationMethod

enum (VerificationMethod)

วิธีการยืนยันสถานที่

ช่องการรวม DisplayData หนึ่งในข้อมูลการแสดงผล ข้อมูลต้องตรงกับเมธอด เว้นว่างไว้หากเมธอดที่เกี่ยวข้องไม่มีข้อมูลการแสดงผล DisplayData ต้องเป็นค่าใดค่าหนึ่งต่อไปนี้
phoneNumber

string

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

addressData

object (AddressVerificationData)

ตั้งค่าเฉพาะในกรณีที่เมธอดคือ MAIL

emailData

object (EmailVerificationData)

ตั้งค่าเฉพาะในกรณีที่วิธีการคือ EMAIL

announcement

string

ตั้งค่าเฉพาะในกรณีที่วิธีการคือ VETTED_PARTNER

AddressVerificationData

แสดงข้อมูลสำหรับการยืนยันผ่านไปรษณียบัตร

การแสดง JSON
{
  "business": string,
  "address": {
    object (PostalAddress)
  },
  "expectedDeliveryDaysRegion": integer
}
ช่อง
business

string

ชื่อธุรกิจของผู้ขาย

address

object (PostalAddress)

ที่อยู่ที่สามารถส่งไปรษณียบัตรได้

expectedDeliveryDaysRegion

integer

จำนวนวันที่ต้องใช้ในการจัดส่งไปรษณียบัตรไปยังภูมิภาคของที่อยู่

EmailVerificationData

แสดงข้อมูลสำหรับการยืนยันทางอีเมล

การแสดง JSON
{
  "domain": string,
  "user": string,
  "isUserNameEditable": boolean
}
ช่อง
domain

string

ชื่อโดเมนในอีเมล เช่น "gmail.com" ใน foo@gmail.com

user

string

ชื่อผู้ใช้ในอีเมล เช่น "foo" ใน foo@gmail.com

isUserNameEditable

boolean

ลูกค้าได้รับอนุญาตให้ระบุชื่อผู้ใช้อื่นหรือไม่