พร้อมรับข้อมูลอัปเดตแบบเรียลไทม์

พื้นที่โฆษณาในระบบของคุณเปลี่ยนแปลงเนื่องจากการจองใหม่ การยกเลิก และ การเปลี่ยนแปลงกำหนดการจากผู้ขาย API การอัปเดตแบบเรียลไทม์ (RTU) เป็นกลไกในการแจ้งให้ Google ทราบเกี่ยวกับการเปลี่ยนแปลงเหล่านี้ รวมถึงการเปลี่ยนแปลงที่เกิดขึ้นกับการจองที่มีอยู่

คุณต้องใช้ RTU ในกรณีต่อไปนี้

• เมื่อผู้ใช้ยกเลิกการจองในระบบของคุณและช่วงเวลาดังกล่าวพร้อมให้บริการ
• เมื่อผู้ใช้จองผ่าน Actions Center และช่วงเวลาดังกล่าวไม่ว่างแล้ว
• เมื่อคุณยกเลิกการจองที่ดำเนินการผ่าน Actions Center ตัวอย่างสถานการณ์รวมถึงการยกเลิกโดยผู้ขายโดยตรง คุณต้องอัปเดตการจองและความพร้อมจำหน่ายสินค้า เนื่องจากตอนนี้ช่วงเวลาเดิมพร้อมให้บริการแล้ว

โปรดทํางานสำคัญ RTU ต่อไปนี้ให้เสร็จสมบูรณ์ก่อนที่จะย้ายไปตรวจสอบใน Sandbox

• พร้อมรับการแจ้งเตือนการจอง

ระบบจะทำเครื่องหมายแต่ละงานว่าเสร็จสมบูรณ์และเปลี่ยนเป็นสีเขียวเมื่อคำขอ 20 รายการล่าสุดไม่มีข้อผิดพลาดเป็นระยะเวลา 14 วัน ส่งคำขอที่สำเร็จต่อไปเพื่อให้ หลักเกณฑ์ยังคงเป็นสีเขียว

RTU และฟีด API

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

ดูข้อมูลเพิ่มเติมได้ที่แหล่งข้อมูลต่อไปนี้

• จัดโครงสร้าง RTU

• ตัวอย่างไคลเอ็นต์ Java สำหรับ RTU โดยใช้การเรียก RESTful

• Inventory Update API

เข้าถึง API

โปรเจ็กต์ Google Cloud คือวิธีที่คุณเข้าถึง Maps Booking API ของศูนย์การดำเนินการ ซึ่งเป็นวิธีที่คุณส่ง RTU คุณต้องใช้บัญชี Google ภายใน Google Developers Console และระบุ หมายเลขโปรเจ็กต์ Cloud ในเหตุการณ์สำคัญในการตั้งค่าของแผนการเริ่มต้นใช้งาน ดูข้อมูลเพิ่มเติมเกี่ยวกับวิธีเปิดใช้ Cloud API ได้ที่เปิดใช้ Cloud API

ใช้การเรียก RESTful หรือดาวน์โหลดไลบรารีของไคลเอ็นต์

เราขอแนะนำให้คุณเรียกใช้ RESTful ไปยัง Maps Booking API โดยตรงด้วย เพย์โหลด JSON ดูข้อมูลเพิ่มเติมได้ที่เอกสารประกอบเกี่ยวกับ REST API

นอกจากนี้ คุณยังใช้ไลบรารีของไคลเอ็นต์เพื่อเชื่อมต่อกับ API ได้ด้วย

คุณสามารถดาวน์โหลดไลบรารีการสนับสนุนเพิ่มเติม ที่จัดการการให้สิทธิ์และด้านอื่นๆ ของการเรียก Google APIs ได้ ดูข้อมูลเพิ่มเติมได้ที่ตัวอย่างโค้ด

ดึงข้อมูลเอกสารการค้นพบ

สำหรับไลบรารีของไคลเอ็นต์บางรายการ เช่น Ruby คุณจะต้องดึงข้อมูลเอกสาร Discovery สำหรับ API ที่อธิบายเมธอดและพารามิเตอร์ของ API นั้น

หากต้องการดึงข้อมูลเอกสารการค้นหา ให้ใช้คำสั่งต่อไปนี้

curl -s -o mapsbooking_rest

https://mapsbooking.googleapis.com/$discovery/rest?version=v1alpha

ดูข้อมูลเพิ่มเติมเกี่ยวกับวิธีเข้าถึง API จาก Ruby ได้ที่ ไคลเอ็นต์ Ruby API และ ไลบรารีการให้สิทธิ์ Ruby

โทรหา API ที่ได้รับอนุญาต

เมื่อเรียกใช้ API โปรดดูการเตรียมพร้อมสำหรับการเรียก API ที่ได้รับมอบสิทธิ์ เพื่อให้สิทธิ์บัญชีบริการด้วยคีย์ส่วนตัวและขอบเขต OAuth ต่อไปนี้

https://www.googleapis.com/auth/mapsbooking

ปลายทางของแซนด์บ็อกซ์และสภาพแวดล้อมจริง

คุณโทรไปยังทั้งสภาพแวดล้อมแซนด์บ็อกซ์และสภาพแวดล้อมการใช้งานจริงได้ผ่าน API ตรวจสอบว่าคุณได้เปิดใช้ทั้ง 2 API ในโปรเจ็กต์ Google Cloud API ทั้ง 2 รายการ ใช้ขอบเขตเดียวกัน แต่มีปลายทางที่แตกต่างกัน

ปลายทางเวอร์ชันที่ใช้งานจริง: https://mapsbooking.googleapis.com/

ปลายทางแซนด์บ็อกซ์: https://partnerdev-mapsbooking.googleapis.com/

ต่อไปนี้เป็นตัวอย่างใน Java เกี่ยวกับวิธีเปลี่ยนปลายทาง

 // This block of code is for OAuth and is the same for prod and sandbox.
    GoogleCredential
      .fromStream(new FileInputStream(...))
      .createScoped(Collections.singleton("https://www.googleapis.com/auth/mapsbooking"))

    // This block of code sets the endpoint. This is what you'd change to connect to the sandbox.
    new GoogleMapsBookingAPI.Builder(...)
      .setApplicationName(...)
      .setRootUrl("https://partnerdev-mapsbooking.googleapis.com/") // you add this to change the endpoint to use partnerdev.
      .build()