เพิ่มการจองแบบไม่พร้อมกัน

การจองแบบซิงโครนัสคือการจองที่ได้รับการยืนยันหรือถูกปฏิเสธ แบบเรียลไทม์

การจองแบบอะซิงโครนัสหมายถึงการจองที่ผู้ขายยืนยันหรือปฏิเสธในภายหลัง

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

หากต้องการพิจารณาการติดตั้งใช้งานที่เหมาะสม ให้ระบุหมวดหมู่ที่พื้นที่โฆษณาของคุณอยู่ก่อน

เกณฑ์การจองแบบอะซิงโครนัส

  • ไม่รองรับการแก้ไขการจองแบบไม่พร้อมกันในศูนย์การดำเนินการ
  • ผู้ขายควรยอมรับหรือปฏิเสธการจองผ่านระบบออนไลน์ของพาร์ทเนอร์ (เช่น แผงควบคุมโฮสต์สำหรับร้านอาหาร) ได้ ไม่อนุญาตให้โทรหาร้านค้าในนามของผู้ใช้เพื่อตรวจสอบว่าร้านค้ารับหรือ ปฏิเสธการจอง
  • ระบบไม่รองรับข้อเสนอของผู้ขายเกี่ยวกับเวลาการจองใหม่ ต้องยอมรับหรือปฏิเสธคำขอจองในสถานะเดิม

เปิดใช้การจองพร้อมกันเท่านั้น

การติดตั้งใช้งานมาตรฐานจะใช้การจองแบบซิงโครนัสโดยค่าเริ่มต้น โปรดดูข้อมูลเพิ่มเติมในเอกสารประกอบการผสานรวมการจองแบบครบวงจร

การเปิดใช้การจองแบบไม่พร้อมกัน

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

  • โหมดการยืนยัน: การแสดงช่วงเวลาที่พร้อมให้บริการทั้งหมดจะมีฟิลด์ confirmation_mode ซึ่งอธิบายวิธี การยืนยันการจองช่วงเวลาที่พร้อมให้บริการนั้น ระบุ confirmation_mode ของช่วงเวลาที่ว่างแต่ละช่วงสำหรับ รายการต่อไปนี้

    • ในฟีดความพร้อมจำหน่ายสินค้า confirmation_mode จะระบุที่ ระดับความพร้อมจำหน่ายสินค้า
    • ในเมธอด Booking Server API จะมีการระบุ confirmation_mode ที่ ระดับช่วงเวลา
    • ในเมธอด API การอัปเดตแบบเรียลไทม์ confirmation_mode จะระบุ ที่ระดับความพร้อมจำหน่ายสินค้า
  • สถานะการจอง: การแสดงการจองทั้งหมดจะมีฟิลด์ status ที่แสดงสถานะของการจอง เราได้เพิ่มค่าสถานะแบบอะซิงโครนัสใหม่ 3 ค่า ได้แก่ PENDING_CONFIRMATION DECLINED_BY_MERCHANT และ FAILED ใช้ค่าสถานะใหม่เหล่านี้เมื่อ ประมวลผลการสร้าง การปฏิเสธ และความล้มเหลวของการจองแบบไม่พร้อมกัน
  • การอัปเดตการจอง: การอัปเดตสถานะการจองแบบไม่พร้อมกันทั้งหมดควรรายงานผ่านเมธอด bookings.patch ของ Booking Notification API

แผนภาพด้านล่างแสดงวิธีใช้โหมดการยืนยันและสถานะการจอง ในการโต้ตอบการจองแบบอะซิงโครนัสทั่วไป

รูปที่ 1: ขั้นตอนการจองแบบอะซิงโครนัส
รูปที่ 1: ขั้นตอนการจองแบบอะซิงโครนัส
  1. เราได้อัปเดตฟีดความพร้อมจำหน่ายสินค้าเพื่อให้ระบุโหมดการยืนยันของช่วงเวลาที่พร้อมให้บริการแต่ละช่วงได้ การมีข้อมูลนี้ในฟีดเป็นสิ่งสำคัญ เพื่อให้เราอธิบายลักษณะการจองแบบอะซิงโครนัสให้ผู้ใช้ทราบ ตั้งแต่เนิ่นๆ ในขั้นตอนการจอง
  2. เมื่อมีการเรียกใช้ BatchAvailabilityLookup หรือ CheckAvailability เราจะส่งต่อโหมดการยืนยันและโหมดการยืนยันเดียวกันเพื่อ ส่งคืน ซึ่งจะช่วยให้ผู้ใช้เห็นข้อความที่เหมาะสม
  3. เมื่อมีการเรียกใช้ CreateBooking เราจะส่งต่อโหมดการยืนยันไปยัง เพื่อระบุโหมดการยืนยันที่คาดไว้ เมื่อส่งคำขอการจองแบบไม่พร้อมกัน ระบบจะแสดงผลการจองพร้อมสถานะ PENDING_MERCHANT_CONFIRMATION
  4. เมื่อผู้ขายยอมรับหรือปฏิเสธคำขอจอง ระบบจะอัปเดตสถานะการจองผ่าน API การแจ้งเตือนการจองแบบเรียลไทม์ ด้วยเมธอด bookings.patch หากต้องการปฏิเสธการจองโดยอัตโนมัติเมื่อไม่ได้รับ การตอบกลับอย่างทันท่วงที ให้ดำเนินการผ่านวิธีการอัปเดตแบบเรียลไทม์ เดียวกัน

ฟีดความพร้อมจำหน่ายสินค้า

ในฟีดความพร้อม ให้ระบุว่าแต่ละช่วงเวลาเป็นแบบซิงโครนัสหรือ แบบอะซิงโครนัส โดยให้ตั้งค่าฟิลด์ confirmation_mode ใหม่

// Mode by which bookings for an availability slot are confirmed.
enum ConfirmationMode {
  // The confirmation mode was not specified.
  // Synchronous confirmation will be assumed.
  CONFIRMATION_MODE_UNSPECIFIED = 0;

  // Bookings for this availability will be confirmed synchronously.
  CONFIRMATION_MODE_SYNCHRONOUS = 1;

  // Bookings for this availability will be confirmed asynchronously.
  CONFIRMATION_MODE_ASYNCHRONOUS = 2;
}

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

Async

{
  "availability": [
    {
      "merchant_id": "10001",
      "service_id": "1000",
      "spots_open": 3,
      "spots_total": 3,
      "duration_sec": 3600,
      "start_sec": 1535806800,
      "resources": {
        "party_size": 4
      },
      "confirmation_mode": "CONFIRMATION_MODE_ASYNCHRONOUS"
    }
  ]
}

ซิงค์

{
  "availability": [
    {
      "merchant_id": "10001",
      "service_id": "1000",
      "spots_open": 3,
      "spots_total": 3,
      "duration_sec": 3600,
      "start_sec": 1535806800,
      "resources": {
        "party_size": 4
      },
      "confirmation_mode": "CONFIRMATION_MODE_SYNCHRONOUS"
    }
  ]
}

ไม่พร้อมกันและพร้อมกัน

{
  "availability": [
    {
      "merchant_id": "10001",
      "service_id": "1000",
      "spots_open": 3,
      "spots_total": 3,
      "duration_sec": 3600,
      "start_sec": 1535806800,
      "resources": {
        "party_size": 4
      },
      "confirmation_mode": "CONFIRMATION_MODE_SYNCHRONOUS"
    },
    {
      "merchant_id": "10002",
      "service_id": "1000",
      "spots_open": 4,
      "spots_total": 4,
      "duration_sec": 3600,
      "start_sec": 1535806800,
      "resources": {
        "party_size": 2
      },
      "confirmation_mode": "CONFIRMATION_MODE_ASYNCHRONOUS"
    }

  ]
}

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

BatchAvailabilityLookup หรือ CheckAvailability

ในBatchAvailabilityLookupResponse (BAL) หรือ CheckAvailabilityResponse (CA) ให้ส่งคืน confirmation_mode เดียวกันกับที่ระบุไว้ใน ฟีดความพร้อมจำหน่ายสินค้าและส่งผ่านทาง BatchAvailabilityLookupRequest หรือ CheckAvailabilityRequest

BAL-Async

{
  "slot_time_availability": [
    {
      "slot_time": {
        "duration_sec": "3600",
        "resource_ids": {
          "party_size": 3
        },
        "service_id": "1000",
        "start_sec": "1546458300",
        "confirmation_mode": "CONFIRMATION_MODE_ASYNCHRONOUS"
      },
      "available": true
    }
  ]
}

BAL-Sync

{
  "slot_time_availability": [
    {
      "slot_time": {
        "duration_sec": "3600",
        "resource_ids": {
          "party_size": 3
        },
        "service_id": "1000",
        "start_sec": "1546458300",
        "confirmation_mode": "CONFIRMATION_MODE_SYNCHRONOUS"
      },
      "available": true
    }
  ]
}

CA-Async

{
  "slot": {
    "duration_sec": "3600",
    "merchant_id": "317652",
    "resources": {
      "party_size": 3
    },
    "service_id": "1000",
    "start_sec": "1546458300",
    "confirmation_mode": "CONFIRMATION_MODE_ASYNCHRONOUS"
  },
  "count_available": 1,
  "duration_requirement": "DO_NOT_SHOW_DURATION"
}

CA-Sync

{
  "slot": {
    "duration_sec": "3600",
    "merchant_id": "317652",
    "resources": {
      "party_size": 3
    },
    "service_id": "1000",
    "start_sec": "1546458300",
    "confirmation_mode": "CONFIRMATION_MODE_SYNCHRONOUS"
  },
  "count_available": 1,
  "duration_requirement": "DO_NOT_SHOW_DURATION"
}

CreateBooking

โปรดตรวจสอบว่าได้ส่งคืนสถานะที่ถูกต้องสำหรับการจองโดยใช้ตัวเลือกที่มีอยู่ ด้านล่าง

// Status of a booking.
//
// Updating booking status does not change the status of the associated payment.
// Prepayment status updates should be done using the PrepaymentStatus enum.
enum BookingStatus {
  // Not specified.
  BOOKING_STATUS_UNSPECIFIED = 0;

  // Booking has been confirmed
  CONFIRMED = 1;

  // Booking is awaiting confirmation by the merchant before it can transition
  // into CONFIRMED status. Only applicable to non-payments Dining or
  // Beauty verticals.
  PENDING_MERCHANT_CONFIRMATION = 2;

  // Booking has been canceled on behalf of the user.
  // The merchant can still trigger a manual refund.
  CANCELED = 3;

  // User did not show for the appointment
  NO_SHOW = 4;

  // User did not show for the appointment in violation of the cancellation
  // policy.
  NO_SHOW_PENALIZED = 5;

  // Booking could not be completed by the async backend due to a failure.
  FAILED = 6;

  // Booking was asynchronously declined by the merchant. Only applicable to
  // non-payments Dining or Beauty verticals.
  DECLINED_BY_MERCHANT = 7;
}

ใน CreateBookingResponse ให้แสดง confirmation_mode ปัจจุบันสำหรับช่วงเวลาที่รวบรวมของการจองที่ระบุ ใน CreateBookingRequest นอกจากนี้ เมื่อการจองเป็นแบบไม่พร้อมกัน ให้ตั้งค่า status เป็น PENDING_MERCHANT_CONFIRMATION โปรดตรวจสอบว่า confirmation_mode ตรงกับที่ผู้ใช้และ Reserve with Google คาดหวังเพื่อไม่ให้ผู้ใช้สับสน

Async

{
  "booking": {
    "slot": {
      "duration_sec": "3600",
      "merchant_id": "100001",
      "resources": {
        "party_size": 2
      },
      "service_id": "1000",
      "start_sec": "1546647234",
      "confirmation_mode": "CONFIRMATION_MODE_ASYNCHRONOUS"
    },
    "user_information": {
      "email": "johnsmith@gmail.com",
      "family_name": "John",
      "given_name": "Smith",
      "telephone": "+1 800-123-4567",
      "user_id": "2017492857928759285"
    },
    "payment_information": {
      "prepayment_status": "PREPAYMENT_NOT_PROVIDED"
    },
    "status": "PENDING_MERCHANT_CONFIRMATION"
  }
}

ซิงค์

{
  "booking": {
    "slot": {
      "duration_sec": "3600",
      "merchant_id": "100001",
      "resources": {
        "party_size": 2
      },
      "service_id": "1000",
      "start_sec": "1546647234",
      "confirmation_mode": "CONFIRMATION_MODE_SYNCHRONOUS"
    },
    "user_information": {
      "email": "johnsmith@gmail.com",
      "family_name": "John",
      "given_name": "Smith",
      "telephone": "+1 800-123-4567",
      "user_id": "2017492857928759285"
    },
    "payment_information": {
      "prepayment_status": "PREPAYMENT_NOT_PROVIDED"
    },
    "status": "CONFIRMED"
  }
}

UpdateBooking

ในการเปิดตัวแบบไม่พร้อมกันครั้งแรก ระบบจะไม่รองรับการแก้ไขการจองที่มีอยู่โดยผู้ใช้ แต่ผู้ใช้ควรยกเลิกการจองและสร้างการจองใหม่แทน

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

หากต้องการอัปเดตความพร้อมแบบเรียลไทม์ ให้ระบุ confirmation_mode โดยมีผลกับวิธีการต่อไปนี้

RTU ของพื้นที่โฆษณา (ReplaceServiceAvailability หรือ BatchReplaceServiceAvailability)

เมื่อใช้availability.replace (กลุ่ม) หรือservices.availability.replace ให้ตั้งค่า confirmation_mode เป็น CONFIRMATION_MODE_ASYNCHRONOUS ใน Availability

Async

{
  "extendedServiceAvailability": [
    {
      "merchantId": "1001",
      "serviceId": "12310",
      "startTimeRestrict": "2014-10-02T15:01:23.045123456Z",
      "endTimeRestrict": "2014-10-02T19:01:23.045123456Z",
      "availability": [
        {
          "startTime": "2014-10-02T15:30:00.00Z",
          "duration": "3600s",
          "spotsOpen": "0",
          "spotsTotal": "2",
          "availabilityTag": "1000001",
          "confirmation_mode": "CONFIRMATION_MODE_ASYNCHRONOUS"
        }
      ]
    }
  ]
}

ซิงค์

{
  "extendedServiceAvailability": [
    {
      "merchantId": "1001",
      "serviceId": "12310",
      "startTimeRestrict": "2014-10-02T15:01:23.045123456Z",
      "endTimeRestrict": "2014-10-02T19:01:23.045123456Z",
      "availability": [
        {
          "startTime": "2014-10-02T15:30:00.00Z",
          "duration": "3600s",
          "spotsOpen": "0",
          "spotsTotal": "2",
          "availabilityTag": "1000001",
          "confirmation_mode": "CONFIRMATION_MODE_SYNCHRONOUS"
        }
      ]
    }
  ]
}

ไม่พร้อมกันและพร้อมกัน

{
  "extendedServiceAvailability": [
    {
      "merchantId": "1001",
      "serviceId": "12310",
      "startTimeRestrict": "2014-10-02T15:01:23.045123456Z",
      "endTimeRestrict": "2014-10-02T19:01:23.045123456Z",
      "availability": [
        {
          "startTime": "2014-10-02T15:30:00.00Z",
          "duration": "3600s",
          "spotsOpen": "0",
          "spotsTotal": "2",
          "availabilityTag": "1000001",
          "confirmation_mode": "CONFIRMATION_MODE_ASYNCHRONOUS"
        },
        {
          "startTime": "2014-10-03T11:00:00.00Z",
          "duration": "5400s",
          "spotsOpen": "1",
          "spotsTotal": "1",
          "availabilityTag": "1000002",
          "confirmation_mode": "CONFIRMATION_MODE_SYNCHRONOUS"
        }
      ]
    }
  ]
}

Booking Notification API

การอัปเดตสถานะการจองแบบไม่พร้อมกันควรทำผ่านเมธอด Booking Notification API bookings.patch

เมื่ออัปเดตสถานะ อย่าลืมใส่ชื่อฟิลด์ status ใน updateMask

สถานะ คำอธิบาย
ยืนยันแล้ว ผู้ขายยืนยันการจองแล้ว
ล้มเหลว พาร์ทเนอร์ยืนยันหรือปฏิเสธการจองกับผู้ขายไม่ได้
DECLINED_BY_MERCHANT ผู้ขายปฏิเสธการจอง 
Request:
PATCH https://mapsbooking.googleapis.com/v1alpha/notification/partners/<PARTNER_ID>/bookings/<BOOKING_ID>?updateMask=status

Body:
{"name":"partners/<PARTNER_ID>/bookings/<BOOKING_ID>", "status":"DECLINED_BY_MERCHANT"}

ในกรณีที่การจองไม่สำเร็จ ให้ตั้งค่าสถานะการจองเป็น FAILED และ ระบุ booking_failure หากตั้งค่าสถานะเป็นอย่างอื่น ระบบจะไม่สนใจ booking_failure

Request:
PATCH https://mapsbooking.googleapis.com/v1alpha/notification/partners/<PARTNER_ID>/bookings/<BOOKING_ID>?updateMask=status&booking_failure.cause="SLOT_UNAVAILABLE"

Body:
{"name":"partners/<PARTNER_ID>/bookings/<BOOKING_ID>", "status":"FAILED"}

การแจ้งเตือนทางอีเมล

สำหรับการจองแบบไม่พร้อมกัน จะมีอีเมล 5 ฉบับที่อาจเกี่ยวข้องกับ สถานะของการจองซึ่งจะส่งถึงผู้ใช้

  • PENDING_MERCHANT_CONFIRMATION
  • CONFIRMED
  • DECLINED_BY_MERCHANT
  • FAILED
  • CANCELED