GetWaitlistEntry 方法
使用集合让一切井井有条
根据您的偏好保存内容并对其进行分类。
此方法会根据提供的候位名单条目 ID 返回用户的候位名单条目。
Action Center 会定期调用此接口,以获取用户的等候名单条目的最新动态。等候名单条目应在创建后的 30 天内可供检索。
请求
GetWaitlistEntryRequest
返回值
GetWaitlistEntryResponse
// Get the waitlist entry corresponding to the provided waitlist entry ID.
message GetWaitlistEntryRequest {
// 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 {
// Required. The partner-provided information about a user’s waitlist entry.
WaitlistEntry waitlist_entry = 1;
}
GetWaitlistEntry 示例
Get 请求
{ "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 }
}
}
如未另行说明,那么本页面中的内容已根据知识共享署名 4.0 许可获得了许可,并且代码示例已根据 Apache 2.0 许可获得了许可。有关详情,请参阅 Google 开发者网站政策。Java 是 Oracle 和/或其关联公司的注册商标。
最后更新时间 (UTC):2025-07-26。
[null,null,["最后更新时间 (UTC):2025-07-26。"],[[["\u003cp\u003eThis method retrieves a user's waitlist entry details based on the provided waitlist entry ID.\u003c/p\u003e\n"],["\u003cp\u003eIt's used by Actions Center for periodic updates on the waitlist entry status, which should be retrievable for 30 days.\u003c/p\u003e\n"],["\u003cp\u003eThe request requires a \u003ccode\u003ewaitlist_entry_id\u003c/code\u003e, and the response returns a \u003ccode\u003ewaitlist_entry\u003c/code\u003e object containing details like wait estimate, state, and state times.\u003c/p\u003e\n"],["\u003cp\u003eSample request and response structures are provided to illustrate the data exchange format.\u003c/p\u003e\n"]]],["The `GetWaitlistEntry` method retrieves a user's waitlist entry using a provided ID. The Actions Center periodically requests updates on entries, which should be accessible for 30 days post-creation. The request includes the `waitlist_entry_id`, and the response contains a `WaitlistEntry` with details like estimated wait, party size, and state. An example illustrates retrieving a specific entry using \"MYS-1668739060\" as the ID.\n"],null,["# GetWaitlistEntry method\n\nThis method returns a\n[waitlist entry](/actions-center/verticals/reservations/waitlists/reference/booking-server-api-rest/e2e-definitions/waitlistentry-definition) for a user based on the provided waitlist entry id.\nThe Actions Center will call this periodically to get updates on the user's\nwaitlist entry. Waitlist entries should be retrievable for 30 days from\ntheir creation time.\n\n**Request**\n\nGetWaitlistEntryRequest\n\n**Return value**\n\nGetWaitlistEntryResponse \n\n```scilab\n// Get the waitlist entry corresponding to the provided waitlist entry ID.\nmessage GetWaitlistEntryRequest {\n // Required. The partner-provided waitlist entry ID to request info for.\n string waitlist_entry_id = 1;\n}\n\n// Response with the waitlist entry corresponding to the provided\n// waitlist entry ID.\nmessage GetWaitlistEntryResponse {\n // Required. The partner-provided information about a user's waitlist entry.\n WaitlistEntry waitlist_entry = 1;\n}\n```\n\nGetWaitlistEntry samples\n------------------------\n\n### Get request\n\n```scdoc\n{ \"waitlist_entry_id\": \"MYS-1668739060\" }\n```\n\n### Get response\n\n```scdoc\n{\n \"waitlist_entry\": {\n \"wait_estimate\": {\n \"party_size\": 3,\n \"wait_length\": { \"parties_ahead_count\": 3 }\n },\n \"waitlist_entry_state\": \"WAITING\",\n \"waitlist_entry_state_times\": { \"created_time_seconds\": 1234567890 }\n }\n}\n```"]]