Quản lý xác minh

Những nhà cung cấp cung cấp tính năng quản lý trang thông tin trực tiếp trên nền tảng của họ có thể xác minh thông tin của người bán doanh nghiệp 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 của Trang doanh nghiệp.

Nhận 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 hasVoiceOfMerchant boolean là true, thì vị trí đã ở trạng thái tốt và bạn không cần thực hiện thêm hành động nào. Ngược lại, 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.

Tuỳ chọn xác minh tìm nạp

Nhà cung cấp có thể sử dụng locations.fetchVerificationOptions phương thức để 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 liên hệ hiện có phương thức xác minh.

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

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 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í chuyển sang trạng thái đã xác minh hoặc trạng thái lỗi đượ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 thông tin xác minh hiện tại

Chiến lược phát hành đĩa đơn locations.verifications.list cuộc gọi truy xuất nhật ký yêu cầu xác minh cùng với trạng thái của chúng đối với vị trí được chỉ định trong cuộc gọi.

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

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

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

Mã PIN và locations.verifications.complete thường là yêu cầu bắt buộc để 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 sử dụng các thành phần 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 Trang doanh nghiệp trên Google (GBP) bằng API

Tạo vị trí

Với API Thông tin doanh nghiệp của 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 bạn yêu cầu người bán thêm một vị trí mới, hãy đảm bảo làm theo các bước sau:

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

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

Ngoài ra, hãy thực hiện tìm kiếm vị trí có khả năng phù hợp bằng cách làm theo các bước sau:

1. Truy vấn vị trí có thể trùng khớp.
2. Hãy yêu cầu người bán chọn vị trí chính xác.
3. Nếu requestAdminRightsUrl tồn tại trong nội dung 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 nội dung phản hồi về vị trí.
5. Xác minh vị trí mới.

Lưu ý: Nếu bạn không tìm thấy vị trí nào phù hợp từ truy vấn ban đầu của mình, hãy sử dụng Mã địa điểm trống để tạo một vị trí mới. Sau đó, 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í cho 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ó thể sử dụng để xác minh vị trí đó.
5. Hãy kiểm tra kỹ để đảm bảo dữ liệu của verificationOption có đúng địa chỉ, số điện thoại và địa chỉ email.
6. Sau khi cơ chế xác minh chọn phương thức xác minh hiện có phù hợp nhất, hãy gọi phương thức locations.verify để bắt đầu quy trình xác minh phù hợp. Để xác nhận rằng quá trình khởi tạo đ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 giá trị là HasVoiceOfMerchant = true, tức là bạn đã xác minh thành công vị trí.

Lưu ý: Nếu vị trí có phương thức xác minh AUTO, thì 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 Trang doanh nghiệp trên Google, vui lòng tham khảo bài viết hỗ trợ trong 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 xác minh