- 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
- VerificationOption
- AddressVerificationData
- EmailVerificationData
Báo cáo tất cả các phương thức xác minh đủ điều kiện cho một vị trí bằng một ngôn ngữ cụ thể.
Yêu cầu HTTP
POST https://mybusinessverifications.googleapis.com/v1/{location=locations/*}:fetchVerificationOptions
URL sử dụng cú pháp Chuyển mã gRPC.
Tham số đường dẫn
| Tham số | |
|---|---|
location |
Bắt buộc. 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 với cấu trúc sau:
| Biểu diễn dưới dạng JSON |
|---|
{
"languageCode": string,
"context": {
object ( |
| Trường | |
|---|---|
languageCode |
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. Các lựa chọn hiện có sẽ khác nhau tuỳ theo ngôn ngữ. |
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ụ. Chỉ có thể áp dụng cho những địa điểm có loại hình doanh nghiệp là CUSTOMER_LOCATION_ONLY. Việc chỉ định địa chỉ chính xác có thể giúp bạn có thêm lựa chọn. 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 hình doanh nghiệp khác của địa điểm. |
Nội dung phản hồi
Thông báo phản hồi cho Verifications.FetchVerificationOptions.
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 |
|---|
{
"options": [
{
object ( |
| Trường | |
|---|---|
options[] |
Các phương thức xác minh hiện có. |
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.
VerificationOption
Phương thức xác minh cho biết cách xác minh vị trí (được biểu thị bằng phương thức xác minh) và nơi gửi thông tin xác minh (được biểu thị bằng dữ liệu hiển thị).
| Biểu diễn dưới dạng JSON |
|---|
{ "verificationMethod": enum ( |
| Trường | |
|---|---|
verificationMethod |
Phương thức xác minh vị trí. |
| Một trong những dữ liệu hiển thị. Dữ liệu phải khớp với phương thức. Để trống nếu phương thức tương ứng không có dữ liệu hiển thị. 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: | |
phoneNumber |
Chỉ đặt nếu phương thức là PHONE_CALL hoặc SMS. Số điện thoại sẽ nhận mã PIN. |
addressData |
Chỉ đặt nếu phương thức là MAIL. |
emailData |
Chỉ đặt nếu phương thức là EMAIL. |
announcement |
Chỉ đặt nếu phương thức là VETTED_PARTNER. |
| Kết thúc các trường loại trừ lẫn nhau. | |
AddressVerificationData
Hiển thị dữ liệu cho các lượt xác minh qua bưu thiếp.
| Biểu diễn dưới dạng JSON |
|---|
{
"business": string,
"address": {
object ( |
| Trường | |
|---|---|
business |
Tên doanh nghiệp của người bán. |
address |
Địa chỉ mà chúng tôi có thể gửi bưu thiếp đến. |
expectedDeliveryDaysRegion |
Số ngày dự kiến để gửi bưu thiếp đến khu vực của địa chỉ. |
EmailVerificationData
Hiển thị dữ liệu cho các quy trình xác minh qua email.
| Biểu diễn dưới dạng JSON |
|---|
{ "domain": string, "user": string, "isUserNameEditable": boolean } |
| Trường | |
|---|---|
domain |
Tên miền trong địa chỉ email. Ví dụ: "gmail.com" trong foo@gmail.com |
user |
Tên người dùng trong địa chỉ email. Ví dụ: "foo" trong foo@gmail.com |
isUserNameEditable |
Liệu ứng dụng có được phép cung cấp tên người dùng khác hay không. |