API ลิงก์รีวิว Google

ข้อมูลที่รองรับ

• URL Google Maps แบบเต็มของสถานที่เฉพาะ
• ลิงก์แชร์ maps.app.goo.gl
• ลิงก์ goo.gl/maps แบบเดิม

คำขอ

ส่งออบเจ็กต์ JSON หนึ่งรายการไปยังปลายทาง ไม่รองรับชื่อธุรกิจหรือ Place ID เพียงอย่างเดียว

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"}'

การตอบกลับ

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

verification จะเป็น not_verified เสมอ ตรวจสอบสถานที่ก่อนมอบลิงก์ให้ผู้ใช้

ข้อผิดพลาดและการแก้ไข

• invalid_request (400)
  ส่ง JSON ที่ถูกต้องพร้อม maps_url ที่ไม่ว่าง
• unsupported_url (422)
  ใช้ลิงก์แชร์ของธุรกิจที่ระบุใน Google Maps
• unsafe_redirect (422)
  ใช้ลิงก์ที่เปลี่ยนเส้นทางไปยัง Google Maps เท่านั้น
• upstream_unresolved (502)
  เปิดลิงก์สั้นและส่ง URL Maps แบบเต็มปลายทาง
• upstream_timeout (504)
  รอ ลองใหม่หนึ่งครั้ง หรือส่ง URL Maps แบบเต็มปลายทาง

ขีดจำกัดการใช้งาน

ขีดจำกัดแบบไม่ระบุตัวตนอยู่ที่ประมาณ 20 คำขอต่อนาทีต่อ IP เอเจนต์ที่ใช้ IP ร่วมกันจะแชร์ขีดจำกัดนี้

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

การตอบกลับ 429 จากขอบเครือข่ายอาจไม่มี JSON หรือ Retry-After ให้รออย่างน้อย 60 วินาที แล้วเพิ่มช่วงเวลารอ

ค้นหา URL Maps ที่ถูกต้อง

1. เปิดตำแหน่งธุรกิจที่ถูกต้องใน Google Maps
2. ตรวจสอบสาขาและที่อยู่ แล้วเลือกแชร์
3. คัดลอกลิงก์และส่งเป็น maps_url

การใช้ข้อมูล

คำขอที่สำเร็จจะบันทึกรหัสสถานที่ ภาษา เวลา และตำแหน่งโดยประมาณของธุรกิจเมื่อมีข้อมูล URL แบบสั้นที่แปลงแล้วจะถูกเก็บในแคชเป็นเวลา 24 ชั่วโมง