Method: 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://mybusinessverifications.googleapis.com/v1/{location=locations/*}:fetchVerificationOptions

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

Tham số đường dẫn

Tham số
location

string

Bắt buộc. 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)
  }
}
Trường
languageCode

string

Bắt buộc. Mã ngôn ngữ BCP 47 biểu thị ngôn ngữ được sử 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)

Không bắt buộc. Thông tin bổ sung liên quan đến việc xác minh doanh nghiệp cung cấp dịch vụ. Chỉ có thể áp dụng cho các vị trí có loại hình doanh nghiệp là CUSTOMER_LOCATION_ONLY. Việc chỉ định một địa chỉ chính xác có thể cho phép bạn có nhiều lựa chọn hơn. INVALID_ARGUMENT sẽ được gửi nếu nó được đặt cho các loại vị trí doanh nghiệp khác.

Nội dung phản hồi

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

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:

Biểu diễn dưới dạng JSON 
{
  "options": [
    {
      object (VerificationOption)
    }
  ]
}
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 phạm vi OAuth sau:

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

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

VerificationOption

Phương thức xác minh cho biết cách xác minh vị trí (được biểu thị bằng phương thức xác minh) và nơi thông tin xác minh sẽ được gửi đến (biểu thị 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:
  "phoneNumber": string,
  "addressData": {
    object (AddressVerificationData)
  },
  "emailData": {
    object (EmailVerificationData)
  },
  "announcement": string
  // End of list of possible types for union field DisplayData.
}
Trường
verificationMethod

enum (VerificationMethod)

Phương thức xác minh vị trí.
Trường kết hợp 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:
phoneNumber

string

Chỉ đặt nếu phương thức là PHONE_CALL hoặc SMS. Số điện thoại sẽ nhận mã PIN.
addressData

object (AddressVerificationData)

Chỉ đặt nếu phương thức là thư.
emailData

object (EmailVerificationData)

Chỉ đặt nếu phương thức là EMAIL.
announcement

string

Chỉ đặt nếu phương thức là VETTED_PARTNER.

AddressVerificationData

Hiển thị dữ liệu cho việc xác minh thông qua bưu thiếp.

Biểu diễn dưới dạng JSON 
{
  "business": string,
  "address": {
    object (PostalAddress)
  },
  "expectedDeliveryDaysRegion": integer
}
Trường
business

string

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

object (PostalAddress)

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

integer

Số ngày dự kiến cần thiết để giao một bưu thiếp đến khu vực của địa chỉ.

EmailVerificationData

Hiển thị dữ liệu để xác minh qua email.

Biểu diễn dưới dạng JSON 
{
  "domain": string,
  "user": string,
  "isUserNameEditable": boolean
}
Trường
domain

string

Tên miền trong địa chỉ email. ví dụ: "gmail.com" trong foo@gmail.com
user

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.