Method: accounts.locations.verify

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

Yêu cầu HTTP

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

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

Tham số đường dẫn

Thông số
name

string

Tên tài nguyên của địa điểm 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:
  "emailInput": {
    object (EmailInput)
  },
  "addressInput": {
    object (AddressInput)
  },
  "phoneInput": {
    object (PhoneInput)
  }
  // End of list of possible types for union field RequestData.
}
Trường
method

enum (VerificationMethod)

Phương thức xác minh.
languageCode

string

Mã ngôn ngữ BCP 47 đại diện cho ngôn ngữ sẽ được dùng cho quy trình xác minh.
context

object (ServiceBusinessContext)

Thông tin bối cảnh bổ sung để xác minh doanh nghiệp dịch vụ. Bắt buộc đối với những vị trí có loại hình doanh nghiệp là CUSTOMER_LOCATION_ONLY. Đối với quy trình xác minh ĐỊA CHỈ, địa chỉ này sẽ được dùng để gửi bưu thiếp. Đối với các phương thức khác, giá trị này phải giống với giá trị được truyền đến locations.fetchVerificationOptions. Lỗi INVALID_ARGUMENT sẽ được gửi nếu bạn đặt giá trị này 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. Để 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:
emailInput

object (EmailInput)

Dữ liệu đầu vào cho phương thức EMAIL.
addressInput

object (AddressInput)

Dữ liệu đầu vào cho phương thức ADDRESS.
phoneInput

object (PhoneInput)

Dữ liệu đầu vào cho phương thức PHONE_CALL/SMS

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 Verifications.VerifyLocation.

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 cấp phép

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 bài viết Tổng quan về OAuth 2.0.

EmailInput

Dữ liệu đầu vào để xác minh EMAIL.

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

string

Địa chỉ email sẽ nhận mã PIN.

Địa chỉ email chỉ được chấp nhận nếu đó là một trong các địa chỉ do locations.fetchVerificationOptions cung cấp. Nếu EmailVerificationData có isUserNameEditable được đặt thành true, thì ứng dụng có thể chỉ định một tên người dùng khác (phần cục bộ) nhưng phải khớp với tên miền.

AddressInput

Dữ liệu đầu vào để xác minh ADDRESS.

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

string

Tên người liên hệ nhận thư.

PhoneInput

Dữ liệu đầu vào cho quy trình xác minh PHONE_CALL/SMS.

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

string

Số điện thoại sẽ được gọi hoặc gửi tin nhắn SMS. Đó phải là một trong các số điện thoại trong các lựa chọn đủ điều kiện.