- Yêu cầu HTTP
- Tham số đường dẫn
- Nội dung yêu cầu
- Nội dung phản hồi
- Phạm vi uỷ quyền
- VerificationToken
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 |
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 ( |
Các trường | |
---|---|
method |
Bắt buộc. Phương thức xác minh. |
languageCode |
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 |
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 |
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 |
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 |
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 |
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 ( |
Các trường | |
---|---|
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 |
Chuỗi mã thông báo. |