- 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 quy 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
| Tham số | |
|---|---|
name |
Bắt buộc. 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 với cấu trúc sau:
| Biểu diễn dưới dạng JSON |
|---|
{ "method": enum ( |
| 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 dịch vụ. Bạn chỉ cần cung cấp thông tin này cho những địa điểm có loại hình doanh nghiệp là CUSTOMER_LOCATION_ONLY. Để 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, mã này phải giống với mã được truyền đến GetVerificationOptions. Hệ thống sẽ gửi thông báo INVALID_ARGUMENT nếu bạn đặt giá trị này cho các loại địa điểm kinh doanh khác. |
| Dữ liệu do người dùng nhập 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. Sau đây là danh sách các trường loại trừ lẫn nhau. Tối đa một trong các trường sẽ được đặt trong phản hồi: | |
emailAddress |
Không bắt buộc. Thông tin đầu vào cho phương thức EMAIL. Địa chỉ email để nhận mã PIN. Địa chỉ email chỉ được chấp nhận nếu đó là một trong những địa chỉ do locations.fetchVerificationOptions cung cấp. Nếu [EmailVerificationData] [google.mybusiness-verifications.v1.VerificationOption.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. |
mailerContact |
Không bắt buộc. Giá trị đầu vào cho phương thức ADDRESS. Tên người liên hệ mà thư sẽ được gửi đến. |
phoneNumber |
Không bắt buộc. Thông tin đầu vào cho phương thức PHONE_CALL/SMS Số điện thoại cần gọi hoặc gửi tin nhắn SMS. Đó phải là một trong những số điện thoại trong các lựa 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ó sẵn để chọn đối tác. Bạn không cần nhập thông tin này cho tài khoản đã được xác minh. 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í. |
trustedPartnerToken |
Thông tin đầu vào cho phương thức TRUSTED_PARTNER Mã xác minh được liên kết với vị trí. |
| Kết thúc các trường loại trừ lẫn nhau. | |
Nội dung phản hồi
Thông báo phản hồi cho Verifications.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 ( |
| 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 OAuth 2.0 Overview.
VerificationToken
Mã thông báo do một đối tác đã được kiểm tra tạo ra.
| Biểu diễn dưới dạng JSON |
|---|
{ "tokenString": string } |
| Trường | |
|---|---|
tokenString |
Chuỗi mã thông báo. |