GetWaitlistEntry 方法

此方法会基于提供的候位名单条目 ID 返回用户的候位名单条目。 操作中心会定期调用此方法,以获取用户在等候名单中的最新状态。等候名单条目应可在创建时间起 30 天内检索。

请求

GetWaitlistEntryRequest

返回值

GetWaitlistEntryResponse

// Get the waitlist entry corresponding to the provided waitlist entry ID.
message GetWaitlistEntryRequest {
  option features.(pb.java).nest_in_file_class = YES;

  // Required. The partner-provided waitlist entry ID to request info for.
  string waitlist_entry_id = 1;
}

// Response with the waitlist entry corresponding to the provided
// waitlist entry ID.
message GetWaitlistEntryResponse {
  option features.(pb.java).nest_in_file_class = YES;

  // Required. The partner-provided information about a user’s waitlist entry.
  WaitlistEntry waitlist_entry = 1;
}

GetWaitlistEntry 示例

获取请求

{ "waitlist_entry_id": "MYS-1668739060" }

获取回答

{
  "waitlist_entry": {
    "wait_estimate": {
      "party_size": 3,
      "wait_length": { "parties_ahead_count": 3 }
    },
    "waitlist_entry_state": "WAITING",
    "waitlist_entry_state_times": { "created_time_seconds": 1234567890 }
  }
}