เมธอด CreateWaitEntryEntry

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

คำขอ

CreateWaitlistEntryRequest

การแสดงผล

CreateWaitlistEntryResponse

// Request for a user to join the waitlist.
//
// Reserve with Google may retry REST HTTP requests if no response is
// received. If the exact same CreateWaitlistEntry is received a second time,
// then the same CreateWaitlistResponse must be returned. A second waitlist
// entry must not be created.
message CreateWaitlistEntryRequest {
  // Required. Partner-provided ID for the merchant.
  string merchant_id = 1;

  // Required. Partner-provided ID for the service.
  string service_id = 2;

  // Required. The party size requested for the waitlist entry.
  int32 party_size = 3;

  // Required. Personal information of the user joining the waitlist.
  UserInformation user_information = 4;

  // A string from the user which contains any special requests or additional
  // information that they would like to notify the merchant about.
  // This will be populated when the user submits an additional request to
  // Reserve with Google. The partner can disable this functionality at the
  // service level by setting supports_additional_request to false in the
  // service feed.
  string additional_request = 5;

  // Required. Used to differentiate retries from separate requests. If the
  // exact same CreateWaitlistEntry is received a second time, (including
  // idempotency_token) then the same CreateWaitlistResponse must be returned.
  string idempotency_token = 6;
}

// Response for the CreateWaitlistEntry RPC with the waitlist entry ID or any
// failing business logic information.
message CreateWaitlistEntryResponse {
  // Unique partner-provided ID for the newly created entry in the waitlist.
  // Required if the waitlist entry was created successfully. Unique for all
  // time.
  string waitlist_entry_id = 1;

  WaitlistBusinessLogicFailure waitlist_business_logic_failure = 2;
}

ตัวอย่าง CreateWaitEntry

สร้างคำขอ

{
  "idempotency_token": "14620365692592881354",
  "merchant_id": "dining-1",
  "party_size": 3,
  "service_id": "reservation",
  "user_information": {
    "family_name": "John",
    "given_name": "Smith",
    "telephone": "[phone]",
    "user_id": "123456789"
  }
}

สร้างคำตอบ

{ "waitlist_entry_id": "MYS-1668739060" }