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

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.
}
Trường
method

enum (VerificationMethod)

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

languageCode

string

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)

Thông tin bổ sung liên quan đến việc xác minh doanh nghiệp cung cấp dịch vụ. 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 locations.fetchVerifyOptions. 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:
emailInput

object (EmailInput)

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

addressInput

object (AddressInput)

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

phoneInput

object (PhoneInput)

Phương thức nhập 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)
  }
}
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

Mục nhập để 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 địa chỉ đó là một trong những địa chỉ do locations.fetchVerifyOptions cung cấp. Nếu EmailVerificationData đã đặt isUserNameCó thể chỉnh sửa thành true, thì ứng dụng có thể chỉ định một tên người dùng khác (thành phần cục bộ) nhưng phải khớp với tên miền.

AddressInput

Mục nhập để 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

Mục nhập để 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 được gửi 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.