Method: accounts.locations.verify

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

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 
{
  "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.
}
Các 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 trong quy trình xác minh.
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. Để 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 locations.fetchVerifierOptions. 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:
emailInput

object (EmailInput)

Phương thức nhập cho phương thức EMAIL.
addressInput

object (AddressInput)

Giá trị nhập cho phương thức ADDRESS.
phoneInput

object (PhoneInput)

Đầ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 Verifys.VerifyLocation.

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

EmailInput

Thông tin đầu vào để xác minh EMAIL.

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

string

Đị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 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 (local-part) 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
}
Các trường
mailerContactName

string

Tên liên hệ nhận thư.

PhoneInput

Đầu vào để xác minh PHONE_CALL/SMS.

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

string

Số điện thoại sẽ được gọi hoặc nhận SMS. 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.