Tài liệu API

API liên kết đánh giá Google

Chuyển một URL Google Maps thành liên kết đánh giá trực tiếp. Không cần đăng ký hoặc khóa Google API.

  1. Yêu cầu

    application/json { "maps_url": "https://www.google.com/maps/place/PRODUCTMATE/data=!1s0x47b18f1cae867bab:0xb6f8b3a3753ba1a2!8m2" }
  2. POST /api/v1/google-review-link productmate.com

  3. Phản hồi 200

    application/json { "place_id": "ChIJq3uGrhyPsUcRoqE7daOz-LY", "review_url": "https://search.google.com/local/writereview?placeid=ChIJq3uGrhyPsUcRoqE7daOz-LY", "verification": "not_verified" }
POST/api/v1/google-review-link

Dữ liệu đầu vào được hỗ trợ

  • URL Google Maps đầy đủ cho một địa điểm cụ thể
  • Liên kết Chia sẻ maps.app.goo.gl
  • Liên kết goo.gl/maps cũ

Yêu cầu

Gửi một đối tượng JSON đến điểm cuối. Không chấp nhận tên doanh nghiệp hoặc Place ID riêng lẻ.

curl -X POST https://productmate.com/api/v1/google-review-link \
  -H "Content-Type: application/json" \
  -d '{"maps_url":"https://www.google.com/maps/place/PRODUCTMATE/data=!1s0x47b18f1cae867bab:0xb6f8b3a3753ba1a2!8m2"}'

Phản hồi

{
  "place_id": "ChIJq3uGrhyPsUcRoqE7daOz-LY",
  "review_url": "https://search.google.com/local/writereview?placeid=ChIJq3uGrhyPsUcRoqE7daOz-LY",
  "verification": "not_verified"
}

verification luôn là not_verified. Kiểm tra địa điểm trước khi đưa liên kết cho người dùng.

Lỗi và cách khắc phục

  • invalid_request (400)
    Gửi JSON hợp lệ với maps_url không trống.
  • unsupported_url (422)
    Dùng liên kết Chia sẻ của một doanh nghiệp cụ thể trên Google Maps.
  • unsafe_redirect (422)
    Dùng liên kết chỉ chuyển hướng đến Google Maps.
  • upstream_unresolved (502)
    Mở liên kết ngắn và gửi URL Maps đầy đủ cuối cùng.
  • upstream_timeout (504)
    Chờ, thử lại một lần hoặc gửi URL Maps đầy đủ cuối cùng.

Giới hạn sử dụng

Giới hạn ẩn danh khoảng 20 yêu cầu mỗi phút cho mỗi IP máy khách. Các tác nhân dùng chung IP sẽ dùng chung hạn mức.

Content-Length: 16 KiB
maps_url: 8 KiB
short_url_resolution_deadline: 10 s

Phản hồi 429 do biên mạng tạo có thể không có JSON hoặc Retry-After. Chờ ít nhất 60 giây rồi tăng dần thời gian chờ.

Tìm đúng URL Maps

  1. Mở đúng địa điểm doanh nghiệp trong Google Maps.
  2. Kiểm tra chi nhánh và địa chỉ, rồi chọn Chia sẻ.
  3. Sao chép liên kết và gửi dưới dạng maps_url.

Sử dụng dữ liệu

Các lệnh gọi thành công ghi lại mã địa điểm, ngôn ngữ, thời gian và vị trí gần đúng của doanh nghiệp nếu có. URL rút gọn đã được giải quyết được lưu trong bộ nhớ đệm trong 24 giờ.