คุณต้องมีเซิร์ฟเวอร์การจองเพื่อให้ศูนย์การดำเนินการเรียกกลับเพื่อสร้างและ อัปเดตการจองในนามของคุณ ซึ่งช่วยให้ Actions Center สร้าง การนัดหมาย การจอง และการสำรองที่พักกับคุณในนามของผู้ใช้ได้
ดูวิธีกำหนดค่าการเชื่อมต่อกับเซิร์ฟเวอร์การจองในแซนด์บ็อกซ์และเวอร์ชันที่ใช้งานจริงได้ที่กำหนดค่าข้อมูลเข้าสู่ระบบของเซิร์ฟเวอร์การจอง
โปรดทํางานต่อไปนี้ให้เสร็จสิ้นก่อนที่จะเปลี่ยนไปใช้การอัปเดตแบบเรียลไทม์
- หน้า BatchAvailabilityLookup โหลดพร้อมแล้ว
- BatchAvailabilityLookup slot click Ready
- CreateBooking Ready
- UpdateBooking Ready
- เปิดใช้เครื่องมือตรวจสอบความพร้อมในการกำหนดค่า 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 การโหลดหน้าเว็บ |
เมื่อผู้ใช้คลิกจองโต๊ะสำหรับผู้ขาย ระบบจะเรียกใช้
เพย์โหลดมีช่องจำนวนมากซึ่งอิงตามการอัปโหลดฟีดล่าสุด ที่จองกับ Google พิจารณาว่าพร้อมให้บริการ |
การตอบกลับต้องมีคำขอช่องโฆษณาทุกรายการและความพร้อมให้บริการปัจจุบันของช่องโฆษณา ซึ่งจะป้องกันไม่ให้แสดงช่องที่ไม่มี | POST /v3/BatchAvailabilityLookup/ |
BatchAvailabilityLookup การคลิกช่อง |
เมื่อผู้ใช้เห็นช่วงเวลาที่ว่างสำหรับการจองและคลิกช่วงเวลา ระบบจะเรียกใช้คำขอ BatchAvailabilityLookup สำหรับการคลิกช่วงเวลา
|
คำตอบต้องแสดงถึงความพร้อมใช้งานจริงในปัจจุบันของ ช่วงเวลา หากมีการจองเต็มก่อนที่ผู้ใช้จะคลิกช่อง ให้แสดงการตอบกลับว่า ไม่พร้อมให้บริการ | POST /v3/BatchAvailabilityLookup/ |
CreateBooking |
เมื่อผู้ใช้ยืนยันว่าต้องการจองช่วงเวลาที่เลือกใน
โมดอลการจอง ระบบจะส่งคำขอ CreateBooking |
การตอบกลับต้องแสดงถึงความสำเร็จหรือความล้มเหลวของ การจอง หากการจองไม่สำเร็จ คุณต้องระบุ
เหตุผลที่เฉพาะเจาะจงที่ทำให้การจองไม่สำเร็จ เช่น มีการจองช่วงเวลาดังกล่าวไปแล้วก่อนที่จะเรียกใช้การตอบกลับ หากสร้างการจองสำเร็จ การตอบกลับจะมี |
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