- 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 cấp phép
- VerificationOption
- PhoneVerificationData
- 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://mybusiness.googleapis.com/v4/{name=accounts/*/locations/*}:fetchVerificationOptions
URL sử dụng cú pháp Chuyển mã gRPC.
Tham số đường dẫn
Tham số | |
---|---|
name |
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 | |
---|---|
{
"languageCode": string,
"context": {
object ( |
Trường | |
---|---|
languageCode |
Mã ngôn ngữ BCP 47 biểu thị ngôn ngữ được sử dụng trong quy trình xác minh. Các lựa chọn có sẵn sẽ khác nhau tuỳ theo ngôn ngữ. |
context |
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. INVALID_ARGUMENT sẽ được gửi nếu nó được đặt cho các loại vị trí doanh nghiệp khác. |
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.FetchVerifyOptions.
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 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.
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 thông tin xác minh sẽ được gửi đến (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í. |
|
Trường kết hợp DisplayData . Một trong các 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ị nào. DisplayData chỉ có thể là một trong những trạng thái sau đây: |
||
phoneData |
Chỉ đặt nếu phương thức là PHONE_CALL hoặc SMS. |
|
addressData |
Chỉ đặt nếu phương thức là thư. |
|
emailData |
Chỉ đặt nếu phương thức là EMAIL. |
PhoneVerificationData
Hiển thị dữ liệu để xác minh qua điện thoại, ví dụ: cuộc gọi điện thoại, sms.
Biểu diễn dưới dạng JSON | |
---|---|
{ "phoneNumber": string } |
Trường | |
---|---|
phoneNumber |
Số điện thoại sẽ nhận mã PIN. |
AddressVerificationData
Hiển thị dữ liệu cho việc xác minh thông qua bưu thiếp.
Biểu diễn dưới dạng JSON | |
---|---|
{
"businessName": string,
"address": {
object ( |
Trường | |
---|---|
businessName |
Tên doanh nghiệp của người bán. |
address |
Địa chỉ mà bưu thiếp có thể được gửi đến. |
EmailVerificationData
Hiển thị dữ liệu để xác minh qua email.
Biểu diễn dưới dạng JSON | |
---|---|
{ "domainName": string, "userName": string, "isUserNameEditable": boolean } |
Trường | |
---|---|
domainName |
Tên miền trong địa chỉ email. ví dụ: "gmail.com" trong foo@gmail.com |
userName |
Tên người dùng trong địa chỉ email. ví dụ: "foo" trong foo@gmail.com |
isUserNameEditable |
Liệu khách hàng có được phép cung cấp tên người dùng khác hay không. |