Hướng dẫn dành cho tác nhân AI

API liên kết đánh giá Google cho tác nhân AI

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

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.

Nếu chưa rõ chi nhánh, hãy hỏi người dùng địa điểm chính xác. Không đoán hoặc khẳng định rằng kết quả đã được xác minh.

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

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.

Tài liệu API →

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

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ờ.

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

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ờ.