Method: locations.verify

Bắt đầu quá 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

Các 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.
}
Các 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 đại diện cho ngôn ngữ sẽ được dùng trong quy trình xác minh.
context

object (ServiceBusinessContext)

Không bắt buộc. Thông tin bổ sung về bối cảnh để xác minh doanh nghiệp cung cấp dịch vụ. Mã số này chỉ bắt buộc cho các địa điểm có loại hình doanh nghiệp là CUSTOMER_LOCATION_ONLY. Để xác minh ADDRESS, địa chỉ này sẽ được sử dụng để gửi bưu thiếp. Đối với các phương thức khác, phương thức này phải giống với phương thức được chuyển đến GetVerifyOptions. INVALID_{8} sẽ được gửi nếu thông số này được đặt cho các loại địa điểm doanh nghiệp khác.
Trường nhóm RequestData. Dữ liệu đầu vào 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. Để 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. Phương thức 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.fetchConfirmOptions cung cấp. Nếu giá trị [EmailVerifyData] [google.mybusiness-verifications.v1.VerifyOption.EmailVerifyData] được đặt thành true, ứng dụng có thể chỉ định một tên người dùng khác (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 cho phương thức ADDRESS. Tên liên hệ nhận thư.
phoneNumber

string

Không bắt buộc. Số điện thoại cần được gọi hoặc gửi SMS đến. Số điện thoại này phải là một trong các số điện thoại ở các tuỳ chọn đủ điều kiện.
token

object (VerificationToken)

Không bắt buộc. Thông tin đầu vào cho phương thức VETTED_PARTNER được cung cấp cho một số partners.. Tài khoản đã được xét duyệt không cần thông tin nhập vào. 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)
  }
}
Các 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 Tổng quan về OAuth 2.0.

VerificationToken

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

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

string

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