BatchGetWaitEstimates পদ্ধতি

অনুরোধকৃত বণিক, পরিষেবা এবং পার্টির আকারের জন্য অপেক্ষার অনুমান পান। অংশীদার ব্যাকএন্ড যাচাই করে যে অনুরোধ করা অপেক্ষার অনুমান উপলব্ধ রয়েছে এবং প্রতিক্রিয়াতে অপেক্ষার সাথে অপেক্ষা তালিকার স্থিতি প্রদান করে।

অনুরোধ

BatchGetWaitEstimatesRequest

রিটার্ন মান

BatchGetWaitEstimatesResponse

// Batch request for the wait estimates for the specified merchant, service and
// party sizes.
message BatchGetWaitEstimatesRequest {
  // Required. Partner-provided ID for the merchant.
  string merchant_id = 1;

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

  // Required. The different party sizes WaitEstimates are requested for.
  // WaitEstimates may differ with the number of people in the party. A single
  // request will not include duplicate party sizes.
  repeated int32 party_size = 3;
}

// Response for the BatchGetWaitEstimates RPC with the wait estimates of the
// specified merchant, service and party sizes.
message BatchGetWaitEstimatesResponse {
  // Required. A status for the waitlist that indicates whether new users can
  // join and what the reason is if they can’t join. If the waitlist is not
  // open, all other fields in the BatchGetWaitEstimatesResponse are expected to
  // be unset.
  WaitlistStatus waitlist_status = 1;

  // The wait estimates for each party size requested. The response should
  // contain exactly one wait estimate for each party size sent in the request.
  // If a party size is not available for some reason, prefer ommitting it
  // instead of returning an error so that the user will have some options to
  // choose from.
  repeated WaitEstimate wait_estimate = 2;
}

// A status for the waitlist that determines if new users can join and what
// the reason is if they can’t join.
enum WaitlistStatus {
  WAITLIST_STATUS_UNSPECIFIED = 0;

  // The waitlist is open and is accepting new users.
  OPEN = 1;

  // There is currently no wait and users should arrive at the merchant
  // without joining the waitlist.
  CLOSED_NO_WAIT = 2;

  // The waitlist is not currently accepting new users because it is full
  // or closed for other reasons.
  CLOSED_OTHER = 3;
}

BatchGetWaitEstimates নমুনা

এই উদাহরণটি এমন একটি ঘটনাকে চিত্রিত করে যেখানে একটি রেস্তোরাঁ সাধারণত 2 থেকে 10 পর্যন্ত party_size মানকে অনুমতি দেয় কিন্তু অনুরোধের সময়, 7-এর চেয়ে বেশি party_size মানগুলিকে আর স্থান দেওয়া যায় না (উদাহরণস্বরূপ, বন্ধ হওয়ার সময় কাছাকাছি) এবং 2-এর party_size আসলে নেই অপেক্ষা করুন

অপেক্ষার অনুরোধ পান

{
  "merchant_id": "dining-1",
  "party_size": [2, 3, 4, 5, 6, 7, 8, 9, 10],
  "service_id": "reservation"
}

অপেক্ষার উত্তর পান

{
  "waitlist_status": "OPEN",
  "wait_estimate": [
    { "party_size": 2, "wait_length": {} },
    { "party_size": 3, "wait_length": { "parties_ahead_count": 3 } },
    { "party_size": 4, "wait_length": { "parties_ahead_count": 3 } },
    { "party_size": 5, "wait_length": { "parties_ahead_count": 3 } },
    { "party_size": 6, "wait_length": { "parties_ahead_count": 3 } },
    { "party_size": 7, "wait_length": { "parties_ahead_count": 3 } }
  ]
}