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.

Kiểm tra địa điểm trước
API trích xuất mã nhận dạng và tạo liên kết. API không xác nhận tên doanh nghiệp, địa chỉ hoặc khả năng nhận đánh giá.

Dữ liệu đầu vào được hỗ trợ
1. URL Google Maps đầy đủ cho một địa điểm cụ thể
2. Liên kết Chia sẻ maps.app.goo.gl
3. Liên kết goo.gl/maps cũ

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.

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

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

Bộ sưu tập Postman: https://productmate.com/developers/google-review-link/postman.json

OpenAPI: https://productmate.com/developers/google-review-link/openapi.json

Tài liệu API: https://productmate.com/vi/developers/google-review-link

Hướng dẫn dành cho tác nhân AI: https://productmate.com/vi/agents/google-review-link

Mở công cụ tạo liên kết: https://productmate.com/vi/tao-lien-ket-danh-gia-google