Method: locations.verify

Bắt đầu quy trình xác minh cho một vị trí.

Yêu cầu HTTP

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

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

Tham số đường dẫn

Tham số
name

string

Bắt buộc. 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 
{
  "method": enum (VerificationMethod),
  "languageCode": string,
  "context": {
    object (ServiceBusinessContext)
  },

  // Union field RequestData can be only one of the following:
  "emailAddress": string,
  "mailerContact": string,
  "phoneNumber": string,
  "token": {
    object (VerificationToken)
  }
  // End of list of possible types for union field RequestData.
}
Trường
method

enum (VerificationMethod)

Bắt buộc. Phương thức xác minh.
languageCode

string

Không 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.
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ụ. Thuộc tính này chỉ bắt buộc đối với các vị trí có loại hình doanh nghiệp là CUSTOMER_LOCATION_ONLY. Để xác minh ADDRESS, địa chỉ sẽ được dùng để gửi bưu thiếp. Đối với các phương thức khác, mã này phải giống với phương thức được chuyển đến GetVerifyOptions. INVALID_ARGUMENT sẽ được gửi nếu nó được đặt cho các loại vị trí doanh nghiệp khác.
Trường kết hợp RequestData. Dữ liệu nhập của người dùng cho phương thức cụ thể ngoài dữ liệu hiển thị. Dữ liệu phải khớp với phương thức được yêu cầu. Hãy để trống nếu không cần dữ liệu. RequestData chỉ có thể là một trong những trạng thái sau đây:
emailAddress

string

Không bắt buộc. Giá trị nhập cho phương thức EMAIL. Địa chỉ email sẽ nhận mã PIN.

Địa chỉ email chỉ được chấp nhận nếu địa chỉ đó là một trong những địa chỉ do locations.fetchVerifyOptions cung cấp. Nếu [EmailVerifyData] [google.soạn-verifications.v1.VerifyOption.EmailVerifyData] có isUserNameCó thể chỉnh sửa được đặt thành true, khách hàng có thể chỉ định một tên người dùng khác (bộ phận địa phương) nhưng phải khớp với tên miền.
mailerContact

string

Không bắt buộc. Giá trị nhập vào cho phương thức ADDRESS. Tên người liên hệ nhận thư.
phoneNumber

string

Không bắt buộc. Thông tin đầu vào cho phương thức PHONE_CALL/SMS Số điện thoại sẽ được gọi hoặc được gửi tin nhắn SMS. Đây phải là một trong các số điện thoại trong các lựa chọn đủ điều kiện.
token

object (VerificationToken)

Không bắt buộc. Giá trị đầu vào cho phương thức VETTED_PARTNER dành cho một số đối tác. Thông tin này không cần thiết đối với tài khoản đã được xem xét. Mã thông báo liên kết với vị trí. Mã thông báo liên kết với vị trí.

Nội dung phản hồi

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

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 
{
  "verification": {
    object (Verification)
  }
}
Trường
verification

object (Verification)

Yêu cầu xác minh đã tạo.

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.

VerificationToken

Mã thông báo do đối tác đã được xét duyệt tạo tạo.

Biểu diễn dưới dạng JSON 
{
  "tokenString": string
}
Trường
tokenString

string

Chuỗi mã thông báo.