Quản lý xác minh

Những nhà cung cấp cung cấp dịch vụ quản lý trang thông tin ngay trên nền tảng của họ có thể xác minh doanh nghiệp của người bán trong trang web của họ. Nhờ đó, người bán không cần phải chuyển hướng đến giao diện người dùng Trang doanh nghiệp.

Lấy trạng thái hiện tại

Người dùng có thể gọi locations.getVoiceOfMerchantState trên một vị trí để truy xuất trạng thái hiện tại của vị trí đó. Nếu giá trị boolean của hasVoiceOfMerchant là true, thì địa điểm đó đã ở trạng thái tốt và bạn không cần làm gì thêm. Nếu không, nếu hành động gain_voice_of_merchant trong phản hồi chứa verify, bạn phải hoàn tất quy trình xác minh. Hãy làm theo hướng dẫn bên dưới để biết thêm thông tin.

Tìm nạp các tuỳ chọn xác minh

Nhà cung cấp có thể sử dụng phương thức locations.fetchVerificationOptions để nhắc người bán chọn một phương thức liên hệ ưu tiên trong danh sách các phương thức xác minh hiện có.

Để tìm nạp các tuỳ chọn xác minh, hãy sử dụng mã sau:

POST
https://mybusinessverifications.googleapis.com/v1/{locationId}:fetchVerificationOptions

{
  "languageCode": "en"
}

Bắt đầu quy trình xác minh

Sau khi bạn chọn một phương thức xác minh, hãy bắt đầu quy trình xác minh bằng locations.verify. Do lệnh gọi này, vị trí sẽ chuyển sang trạng thái đã xác minh hoặc trạng thái lỗi sẽ được trả về.

POST
https://mybusinessverifications.googleapis.com/v1/locations/{locationId}
:verify

// Use only one of the below verification methods

// For postcard verification:
{
  "method": "ADDRESS",
  "languageCode": "en",
  "addressInput": {
    "mailerContactName": "Ann Droyd"
  }
}

// For phone verification:
{
  "method": "PHONE_CALL",
  "languageCode": "en",
  "phoneInput": {
    "phoneNumber": "800-555-0136"
  }
}

// For SMS verification:
{
  "method": "SMS",
  "languageCode": "en",
  "phoneInput": {
    "phoneNumber": "800-555-0136"
  }
}

// For email verification:
{
  "method": "EMAIL",
  "languageCode": "en",
  "emailInput": {
    "emailAddress": "ex@google.com"
  }
}

Truy xuất các yêu cầu xác minh hiện tại

Lệnh gọi locations.verifications.list truy xuất nhật ký yêu cầu xác minh cùng với trạng thái của các yêu cầu đó cho vị trí được chỉ định trong lệnh gọi.

Để truy xuất tất cả yêu cầu xác minh, hãy sử dụng mã sau:

GET
https://mybusinessverifications.googleapis.com/v1/locations/{locationId}
/verifications

Hoàn tất quy trình xác minh đang chờ xử lý

Bạn thường phải có mã PIN và phương thức locations.verifications.complete để hoàn tất quy trình xác minh doanh nghiệp.

Để hoàn tất quy trình xác minh đang chờ xử lý, hãy làm như sau:

POST
https://mybusinessverifications.googleapis.com/v1/locations/{locationId}
/verifications/{verificationId}:complete

{
  "pin": "123456"
}

Các phương pháp hay nhất để xác minh GBP bằng API

Tạo vị trí

Với API Thông tin doanh nghiệp trên GBP, bạn có thể nhúng nền tảng của mình để cung cấp chức năng tạo vị trí. Khi yêu cầu người bán thêm một vị trí mới, hãy nhớ làm theo các bước sau:

Thu thập thông tin vị trí như tên doanh nghiệp, địa chỉ, danh mục từ người bán.

1. Gọi điểm cuối googleLocations.search.
2. Cung cấp dữ liệu vị trí, chẳng hạn như tên doanh nghiệp, danh mục, địa chỉ, số điện thoại và trang web trong yêu cầu API.

Ngoài ra, bạn có thể tìm kiếm vị trí phù hợp tiềm năng bằng cách làm theo các bước sau:

1. Truy vấn các vị trí trùng khớp có thể có.
2. Yêu cầu người bán chọn đúng vị trí.
3. Nếu requestAdminRightsUrl tồn tại trong phản hồi về vị trí, hãy giúp người bán yêu cầu quyền truy cập và quyền sở hữu đối với vị trí đó trên Trang doanh nghiệp trên Google.
4. Nếu requestAdminRightsUrl không tồn tại, hãy tạo một vị trí mới bằng mã địa điểm trong phản hồi vị trí.
5. Xác minh vị trí mới.

Lưu ý: Nếu không có kết quả trùng khớp nào về vị trí từ truy vấn ban đầu, hãy sử dụng Mã địa điểm trống để tạo một vị trí mới. Sau đó, hãy xác minh vị trí mới đó.

Xác minh địa điểm

Để bắt đầu quy trình xác minh bằng API GBP, vui lòng làm theo các bước sau:

1. Gọi phương thức accounts.locations.list để liệt kê tất cả vị trí của một Tài khoản Google.
2. Chọn một vị trí để xác minh.
3. Gọi phương thức API GetVoiceOfMerchant để xác nhận xem vị trí đó có cần xác minh hay không.
4. Nếu phản hồi trả về xác minh, hãy gọi fetchVerificationOptions để nhận danh sách các phương thức có sẵn để xác minh vị trí đó.
5. Kiểm tra kỹ để đảm bảo dữ liệu verificationOption có địa chỉ, số điện thoại và địa chỉ email chính xác.
6. Sau khi người bán chọn phương thức xác minh phù hợp nhất, hãy gọi phương thức locations.verify để bắt đầu quy trình xác minh thích hợp. Để xác nhận rằng quá trình khởi chạy đang diễn ra, hãy gọi locations.verifications.list.
7. Gọi phương thức locations.verification.complete bằng mã PIN của người bán.
8. Gọi phương thức API GetVoiceOfMerchant. Nếu là HasVoiceOfMerchant = true, tức là bạn đã xác minh thành công vị trí.

Lưu ý: Nếu có thể xác minh AUTO cho vị trí, người bán không cần thực hiện bất kỳ bước xác minh nào

Để biết thêm thông tin về việc xác minh GBP, vui lòng tham khảo bài viết hỗ trợ trên trung tâm trợ giúp của chúng tôi.

Hướng dẫn về phương thức xác minh dành cho đối tác được kiểm tra