Quản lý xác minh

Những nhà cung cấp trực tiếp cung cấp tính năng quản lý trang thông tin trên nền tảng của mình có thể xác minh doanh nghiệp của người bán trên trang web của họ. Việc này giúp bạn không cần phải chuyển hướng người bán đến giao diện người dùng của Trang doanh nghiệp.

Xem 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 hasVoiceOfMerchant là true thì vị trí đó đã ở trạng thái tốt và bạn không cần làm gì thêm. Ngược lại, nếu thao tác 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ùy chọn xác minh tìm nạp

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 các cách sau:

HTTP
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. Kết quả của 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ề.

HTTP
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

Lệnh gọi locations.verifications.list truy xuất nhật ký yêu cầu xác minh cùng trạng thái của các yêu cầu này đối với vị trí đã 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:

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

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

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

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

HTTP
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 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 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, hãy tìm kiếm vị trí có khả năng trùng khớ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 đúng vị trí.
  3. Nếu có requestAdminRightsUrl 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 có mã địa điểm trong phản hồi về vị trí.
  5. Xác minh vị trí mới.

Lưu ý: Nếu bạn không nhận được bất kỳ vị trí nào có thể trùng khớp từ truy vấn ban đầu của mình, hãy sử dụng ID địa điểm trống để tạo 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 GBP API, 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ả các vị trí cho một Tài khoản Google.
  2. Chọn một vị trí để xác minh.
  3. Hãy gọi phương thức API GetVoiceOfMerchant để xác nhận xem vị trí đó có yêu cầu xác minh hay không.
  4. Nếu phản hồi trả về quy trình xác minh, hãy gọi fetchVerificationOptions để nhận danh sách phương thức có thể dùng để xác minh vị trí đó.
  5. Hãy 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 cơ chế 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 bắt đầu đ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 HasVoiceOfMerchant = true, bạn đã xác minh thành công vị trí.

Lưu ý: Nếu quy trình xác minh bằng 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 bằng GBP, vui lòng tham khảo bài viết 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 đã xem xét