เซิร์ฟเวอร์การจองพร้อมแล้ว

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

ดูวิธีกำหนดค่าการเชื่อมต่อกับเซิร์ฟเวอร์การจองในแซนด์บ็อกซ์และเวอร์ชันที่ใช้งานจริงได้ที่กำหนดค่าข้อมูลเข้าสู่ระบบของเซิร์ฟเวอร์การจอง

โปรดทํางานต่อไปนี้ให้เสร็จสิ้นก่อนที่จะเปลี่ยนไปใช้การอัปเดตแบบเรียลไทม์

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

ใช้ REST API Interface

ใช้ส่วนติดต่อ API ตาม REST ซึ่งจะช่วยให้ Google ส่งคำขอไปยังเซิร์ฟเวอร์การจองผ่าน HTTPS ได้

หากต้องการใช้ส่วนติดต่อ API ให้ตั้งค่าเซิร์ฟเวอร์การจองสำหรับพัฒนาหรือ Sandbox ที่เชื่อมต่อกับสภาพแวดล้อม Sandbox ของศูนย์การดำเนินการ ย้ายไปยังสภาพแวดล้อมการใช้งานจริง หลังจากทดสอบเซิร์ฟเวอร์แซนด์บ็อกซ์อย่างเต็มรูปแบบแล้วเท่านั้น

คำขอทั้งหมดของเซิร์ฟเวอร์การจองของ Google จะเกี่ยวข้องกับ URL ของเซิร์ฟเวอร์การจองที่ตั้งค่าไว้ในหน้าเซิร์ฟเวอร์การจอง เช่น หากตั้งค่า URL เป็น api.example.com/google ระบบจะส่งคำขอทั้งหมด HealthCheck ไปยัง api.example.com/google/v3/HealthCheck

ตรวจสอบว่าได้กำหนดค่าปลายทางเซิร์ฟเวอร์การจองที่ถูกต้องสำหรับทั้ง สภาพแวดล้อมแซนด์บ็อกซ์และสภาพแวดล้อมที่ใช้งานจริงด้วยตัวสลับสภาพแวดล้อม

ความปลอดภัยและการตรวจสอบสิทธิ์

การสื่อสารทั้งหมดกับเซิร์ฟเวอร์การจองจะเกิดขึ้นผ่าน HTTPS โดยใช้การตรวจสอบสิทธิ์ขั้นพื้นฐาน เราขอแนะนำให้ใช้เครื่องมือตรวจสอบ SSL หรือ TLS ที่พร้อมให้บริการแก่สาธารณะ เช่น การทดสอบเซิร์ฟเวอร์ SSL ของ Qualys เพื่อช่วยตั้งค่าเซิร์ฟเวอร์

คำขอทั้งหมดที่ Google ส่งไปยังเซิร์ฟเวอร์การจองของคุณจะได้รับการตรวจสอบสิทธิ์ด้วย การตรวจสอบสิทธิ์พื้นฐานของ HTTPS คุณป้อนข้อมูลการตรวจสอบสิทธิ์พื้นฐาน รหัสผ่าน และชื่อผู้ใช้ของเซิร์ฟเวอร์การจองได้ในหน้าการกำหนดค่าเซิร์ฟเวอร์การจองของ Actions Center ต้องเปลี่ยนข้อมูลเข้าสู่ระบบทุก 6 เดือน

สร้างเซิร์ฟเวอร์การจอง

เซิร์ฟเวอร์การจองจะกำหนดวิธีที่การผสานรวมสื่อสารกับระบบของคุณ และทำการจองหรืออัปเดตการจอง หากต้องการกำหนดค่าการเชื่อมต่อกับ Sandbox และ เซิร์ฟเวอร์การจองที่ใช้งานจริง โปรดดู กำหนดค่าข้อมูลเข้าสู่ระบบของเซิร์ฟเวอร์การจอง

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

วิธีการ คำจำกัดความ การตอบกลับ คำขอ HTTP
BatchAvailabilityLookup การโหลดหน้าเว็บ

เมื่อผู้ใช้คลิกจองโต๊ะสำหรับผู้ขาย ระบบจะเรียกใช้ BatchAvailabilityLookup คำขอเมื่อโหลดหน้าเว็บ

เพย์โหลดมีช่องจำนวนมากซึ่งอิงตามการอัปโหลดฟีดล่าสุด ที่จองกับ Google พิจารณาว่าพร้อมให้บริการ

การตอบกลับต้องมีคำขอช่องโฆษณาทุกรายการและความพร้อมให้บริการปัจจุบันของช่องโฆษณา ซึ่งจะป้องกันไม่ให้แสดงช่องที่ไม่มี POST /v3/BatchAvailabilityLookup/
BatchAvailabilityLookup การคลิกช่อง เมื่อผู้ใช้เห็นช่วงเวลาที่ว่างสำหรับการจองและคลิกช่วงเวลา ระบบจะเรียกใช้คำขอ BatchAvailabilityLookup สำหรับการคลิกช่วงเวลา คำตอบต้องแสดงถึงความพร้อมใช้งานจริงในปัจจุบันของ ช่วงเวลา หากมีการจองเต็มก่อนที่ผู้ใช้จะคลิกช่อง ให้แสดงการตอบกลับว่า ไม่พร้อมให้บริการ POST /v3/BatchAvailabilityLookup/
CreateBooking เมื่อผู้ใช้ยืนยันว่าต้องการจองช่วงเวลาที่เลือกใน โมดอลการจอง ระบบจะส่งคำขอ CreateBooking

การตอบกลับต้องแสดงถึงความสำเร็จหรือความล้มเหลวของ การจอง

หากการจองไม่สำเร็จ คุณต้องระบุ เหตุผลที่เฉพาะเจาะจงที่ทำให้การจองไม่สำเร็จ เช่น มีการจองช่วงเวลาดังกล่าวไปแล้วก่อนที่จะเรียกใช้การตอบกลับ CreateBooking

หากสร้างการจองสำเร็จ การตอบกลับจะมี booking_id ที่ไม่ซ้ำกันเพื่อใช้อ้างอิงการจองในคำขอหรือการอัปเดตในอนาคต

POST /v3/CreateBooking/
UpdateBooking หลังจากจองผ่านจองกับ Google แล้ว ผู้ใช้จะเลือก แก้ไขการจองได้ เมื่อผู้ใช้อัปเดตการจองหรือยกเลิก การจอง ระบบจะส่งคำขอ UpdateBooking เช่นเดียวกับการตอบกลับ CreateBooking การตอบกลับ UpdateBooking ต้องแสดงถึงความสำเร็จของการจองหรือระบุเหตุผลที่เฉพาะเจาะจงสำหรับความล้มเหลว POST /v3/UpdateBooking/
HealthCheck ศูนย์การดำเนินการจะโทรหาเซิร์ฟเวอร์การจองเป็นประจำเพื่อ ยืนยันว่าโครงสร้างพื้นฐานของคุณใช้งานได้และทำงานอยู่

ใช้รหัสสถานะ HTTP เพื่อระบุสถานะการแสดงผลของเซิร์ฟเวอร์ แสดงรหัสสถานะ HTTP 200 หากเซิร์ฟเวอร์ทำงานและทำงาน สำเร็จ

หากต้องการระบุข้อผิดพลาดหรือนำการผสานรวมของคุณออกจากระบบชั่วคราว ให้แสดงรหัสสถานะ HTTP ที่ไม่ใช่ 2xx ที่เหมาะสม

GET /v3/HealthCheck/

ขั้นตอนการจองในแซนด์บ็อกซ์

หากต้องการดูขั้นตอนการจองใน Sandbox ให้ไปที่ศูนย์การดำเนินการ มุมมองสินค้าคงคลัง คอลัมน์ RwG - E2E ของมุมมองพื้นที่โฆษณาจะแสดงลิงก์ใช้งานจริง (ใน Sandbox) ไปยัง ขั้นตอนการจองใน Sandbox สำหรับผู้ขายใน Sandbox ที่ตรงกัน และมีห้องว่างในอนาคต

การดำเนินการในขั้นตอนการจองมีดังนี้

  • เมื่อคลิกลิงก์ RwG - E2E ระบบจะทริกเกอร์BatchAvailabilityLookup คำขอเมื่อโหลดหน้าเว็บและแสดงความพร้อมจำหน่ายผลิตภัณฑ์ที่ทราบของผู้ขาย
  • เมื่อคลิกเวลาการจอง ระบบจะทริกเกอร์BatchAvailabilityLookup คำขอเมื่อคลิกช่วงเวลาและแสดงโมดอลการจอง
  • ทําการจองให้เสร็จสมบูรณ์ด้วยโมดัลการจองเพื่อส่งCreateBookingคําขอ
  • หลังจากจองในสภาพแวดล้อม Sandbox เสร็จแล้ว บัญชีที่ใช้ สร้างการจองจะได้รับอีเมลยืนยันพร้อมรายละเอียดการจอง
  • หากต้องการเรียกใช้UpdateBooking ให้เปลี่ยนหรือยกเลิกการจองจากอีเมล

HealthCheck

อย่าลืมใช้เมธอด HealthCheck ในแซนด์บ็อกซ์และเวอร์ชันที่ใช้งานจริง เมธอดนี้ จะแสดงสถานะความสมบูรณ์ของเซิร์ฟเวอร์การจอง ซึ่งจะช่วยให้ Google ตรวจสอบสถานะการแสดงผลของเซิร์ฟเวอร์การจองได้อย่างต่อเนื่อง

คำขอ: ไม่มี

ค่าที่ส่งคืน: ไม่มี

ใช้รหัสสถานะ HTTP เพื่อระบุสถานะการแสดงผลของเซิร์ฟเวอร์

หากเซิร์ฟเวอร์ทำงานอยู่และทำงานสำเร็จ ให้แสดงรหัสสถานะ HTTP 200 หรือหากต้องการระบุข้อผิดพลาด ให้แสดงรหัสสถานะ HTTP