Method: accounts.locations.fetchVerificationOptions

Báo cáo tất cả các phương thức xác minh đủ điều kiện cho một vị trí bằng một ngôn ngữ cụ thể.

Yêu cầu HTTP

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

URL sử dụng cú pháp Chuyển mã gRPC.

Tham số đường dẫn

Các tham số
name

string

Tên tài nguyên của vị trí cần xác minh.

Nội dung yêu cầu

Nội dung yêu cầu chứa dữ liệu có cấu trúc sau:

Biểu diễn dưới dạng JSON 
{
  "languageCode": string,
  "context": {
    object (ServiceBusinessContext)
  }
}
Các trường
languageCode

string

Mã ngôn ngữ BCP 47 đại diện cho ngôn ngữ sẽ được dùng trong quy trình xác minh. Các lựa chọn có sẵn sẽ khác nhau tuỳ theo ngôn ngữ.
context

object (ServiceBusinessContext)

Thông tin bổ sung về bối cảnh để xác minh doanh nghiệp cung cấp dịch vụ. Bắt buộc đối với các địa điểm có loại hình doanh nghiệp là CUSTOMER_LOCATION_ONLY. INVALID_ACCOUNT sẽ được gửi nếu địa điểm đó được đặt cho các loại địa điểm doanh nghiệp khác.

Nội dung phản hồi

Nếu thành công, phần nội dung phản hồi sẽ chứa dữ liệu có cấu trúc sau:

Thông báo phản hồi cho Verifys.FetchverifyOptions.

Biểu diễn dưới dạng JSON 
{
  "options": [
    {
      object (VerificationOption)
    }
  ]
}
Các trường
options[]

object (VerificationOption)

Các phương thức xác minh hiện có.

Phạm vi uỷ quyền

Yêu cầu một trong các phạm vi OAuth sau:

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

Để biết thêm thông tin, hãy xem Tổng quan về OAuth 2.0.

VerificationOption

Tuỳ chọn xác minh thể hiện cách xác minh vị trí (được biểu thị bằng phương pháp xác minh) và nơi gửi thông tin xác minh đến (được chỉ rõ bằng dữ liệu hiển thị).

Biểu diễn dưới dạng JSON 
{
  "verificationMethod": enum (VerificationMethod),

  // Union field DisplayData can be only one of the following:
  "phoneData": {
    object (PhoneVerificationData)
  },
  "addressData": {
    object (AddressVerificationData)
  },
  "emailData": {
    object (EmailVerificationData)
  }
  // End of list of possible types for union field DisplayData.
}
Các trường
verificationMethod

enum (VerificationMethod)

Phương thức để xác minh vị trí.
Trường nhóm DisplayData. Một trong các dữ liệu hiển thị. Dữ liệu phải khớp với phương thức. Để trống nếu phương thức tương ứng không có dữ liệu hiển thị nào. DisplayData chỉ có thể là một trong những trạng thái sau đây:
phoneData

object (PhoneVerificationData)

Chỉ đặt nếu phương thức là PHONE_CALL hoặc SMS.
addressData

object (AddressVerificationData)

Chỉ thiết lập nếu phương thức là THƯ.
emailData

object (EmailVerificationData)

Chỉ thiết lập nếu phương thức là EMAIL.

PhoneVerificationData

Hiển thị Dữ liệu cho các yêu cầu xác minh qua điện thoại, ví dụ: cuộc gọi điện thoại, tin nhắn SMS.

Biểu diễn dưới dạng JSON 
{
  "phoneNumber": string
}
Các trường
phoneNumber

string

Số điện thoại sẽ nhận mã PIN.

AddressVerificationData

Hiển thị dữ liệu về các yêu cầu xác minh thông qua bưu thiếp.

Biểu diễn dưới dạng JSON 
{
  "businessName": string,
  "address": {
    object (PostalAddress)
  }
}
Các trường
businessName

string

Tên doanh nghiệp của người bán.
address

object (PostalAddress)

Địa chỉ có thể gửi bưu thiếp đến.

EmailVerificationData

Hiển thị dữ liệu cho các yêu cầu xác minh qua email.

Biểu diễn dưới dạng JSON 
{
  "domainName": string,
  "userName": string,
  "isUserNameEditable": boolean
}
Các trường
domainName

string

Tên miền trong địa chỉ email. Ví dụ: "gmail.com" thì trong foo@gmail.com
userName

string

Tên người dùng trong địa chỉ email. Ví dụ: "foo" trong foo@gmail.com
isUserNameEditable

boolean

Liệu khách hàng có được phép cung cấp tên người dùng khác hay không.