Method: inventory.partners.merchants.status.list
Sử dụng bộ sưu tập để sắp xếp ngăn nắp các trang
Lưu và phân loại nội dung dựa trên lựa chọn ưu tiên của bạn.
Liệt kê tất cả MerchantStatus
của một đối tác đáp ứng các điều kiện lọc.
Yêu cầu HTTP
GET https://mapsbooking.googleapis.com/v1alpha/inventory/{parent=partners/*/merchants}/status
URL sử dụng cú pháp Chuyển mã gRPC.
Tham số đường dẫn
Thông số |
parent |
string
Bắt buộc. Nhà xuất bản mẹ sở hữu tập hợp trạng thái người bán này. Định dạng partners/{partner_id}/merchants
|
Tham số truy vấn
Thông số |
pageSize |
integer
Bắt buộc. Số lượng mục tối đa cần trả về. Lưu ý rằng máy chủ có thể giảm kích thước trang.
|
pageToken |
string
Không bắt buộc. Giá trị nextPageToken được trả về từ một ListMerchantStatusResponse trước đó, nếu có.
|
bookingInventoryStatusRestrict |
enum (BookingInventoryStatus )
Không bắt buộc. Giới hạn (không bắt buộc) để lọc kết quả theo trạng thái của kho hàng đặt trước.
|
waitlistInventoryStatusRestrict |
enum (WaitlistInventoryStatus )
Không bắt buộc. Quy định hạn chế không bắt buộc để lọc kết quả theo trạng thái khoảng không quảng cáo trong danh sách chờ.
|
geoMatchRestrict |
enum (GeoMatchingStatus )
Không bắt buộc. Quy định hạn chế không bắt buộc đối với việc lọc kết quả theo trạng thái so khớp địa lý.
|
Nội dung yêu cầu
Nội dung yêu cầu phải trống.
Nội dung phản hồi
Phản hồi cho danh sách MerchantStatus
.
Nếu thành công, phần nội dung phản hồi sẽ chứa dữ liệu có cấu trúc sau:
Biểu diễn dưới dạng JSON |
{
"merchantStatuses": [
{
object (MerchantStatus )
}
],
"nextPageToken": string
} |
Trường |
merchantStatuses[] |
object (MerchantStatus )
Danh sách trạng thái người bán đáp ứng các điều kiện lọc.
|
nextPageToken |
string
Mã để truy xuất trang kết quả tiếp theo. Không có kết quả nào khác trong danh sách nếu trống.
|
Phạm vi uỷ quyền
Yêu cầu phạm vi OAuth sau:
https://www.googleapis.com/auth/mapsbooking
BookingInventoryStatus
Trạng thái khoảng không quảng cáo đặt phòng toàn diện.
Enum |
BOOKING_INVENTORY_STATUS_UNSPECIFIED |
Chưa chỉ định. |
NO_VALID_FUTURE_INVENTORY |
Người bán không có khoảng không quảng cáo đặt trước trong 30 ngày tới. |
HAS_VALID_FUTURE_INVENTORY |
Người bán có khoảng không quảng cáo đặt trước trong 30 ngày tới. |
WaitlistInventoryStatus
Trạng thái còn hàng trong danh sách chờ từ đầu đến cuối.
Enum |
WAITLIST_INVENTORY_STATUS_UNSPECIFIED |
Chưa chỉ định. |
NO_VALID_WAITLIST_SERVICE |
Người bán không có dịch vụ hỗ trợ danh sách chờ. |
HAS_VALID_WAITLIST_SERVICE |
Người bán có danh sách chờ hỗ trợ dịch vụ. |
GeoMatchingStatus
Trạng thái so khớp theo khu vực địa lý của người bán.
Enum |
GEO_MATCHING_STATUS_UNSPECIFIED |
Chưa chỉ định. |
GEO_UNMATCHED |
Người bán không được so khớp theo vị trí địa lý. |
GEO_MATCHED |
Người bán được so khớp theo vị trí địa lý. |
Trừ phi có lưu ý khác, nội dung của trang này được cấp phép theo Giấy phép ghi nhận tác giả 4.0 của Creative Commons và các mẫu mã lập trình được cấp phép theo Giấy phép Apache 2.0. Để biết thông tin chi tiết, vui lòng tham khảo Chính sách trang web của Google Developers. Java là nhãn hiệu đã đăng ký của Oracle và/hoặc các đơn vị liên kết với Oracle.
Cập nhật lần gần đây nhất: 2025-07-24 UTC.
[null,null,["Cập nhật lần gần đây nhất: 2025-07-24 UTC."],[[["\u003cp\u003eLists all MerchantStatus of a partner that satisfy filter conditions such as booking inventory status, waitlist inventory status, or geo matching status.\u003c/p\u003e\n"],["\u003cp\u003eUses a \u003ccode\u003eGET\u003c/code\u003e request to the endpoint \u003ccode\u003ehttps://mapsbooking.googleapis.com/v1alpha/inventory/{parent=partners/*/merchants}/status\u003c/code\u003e, with required path parameter \u003ccode\u003eparent\u003c/code\u003e and optional query parameters for filtering and pagination.\u003c/p\u003e\n"],["\u003cp\u003eRequires authorization with the \u003ccode\u003ehttps://www.googleapis.com/auth/mapsbooking\u003c/code\u003e scope.\u003c/p\u003e\n"],["\u003cp\u003eThe response body contains a list of MerchantStatus objects and a token for pagination if there are more results.\u003c/p\u003e\n"],["\u003cp\u003eProvides enums for BookingInventoryStatus, WaitlistInventoryStatus, and GeoMatchingStatus for filtering purposes.\u003c/p\u003e\n"]]],[],null,["# Method: inventory.partners.merchants.status.list\n\n- [HTTP request](#body.HTTP_TEMPLATE)\n- [Path parameters](#body.PATH_PARAMETERS)\n- [Query parameters](#body.QUERY_PARAMETERS)\n- [Request body](#body.request_body)\n- [Response body](#body.response_body)\n - [JSON representation](#body.ListMerchantStatusesResponse.SCHEMA_REPRESENTATION)\n- [Authorization scopes](#body.aspect)\n- [BookingInventoryStatus](#BookingInventoryStatus)\n- [WaitlistInventoryStatus](#WaitlistInventoryStatus)\n- [GeoMatchingStatus](#GeoMatchingStatus)\n\nList all [MerchantStatus](/maps-booking/reference/maps-booking-api/rest/v1alpha/MerchantStatus) of a partner that satisfy the filter conditions.\n\n### HTTP request\n\n`GET https://mapsbooking.googleapis.com/v1alpha/inventory/{parent=partners/*/merchants}/status`\n\nThe URL uses [gRPC Transcoding](https://google.aip.dev/127) syntax.\n\n### Path parameters\n\n| Parameters ||\n|----------|-------------------------------------------------------------------------------------------------------------------------|\n| `parent` | `string` Required. The parent, which owns this collection of merchant status. Format: `partners/{partner_id}/merchants` |\n\n### Query parameters\n\n| Parameters ||\n|-----------------------------------------|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `page``Size` | `integer` Required. The maximum number of items to return. Note that the server may reduce the page size. |\n| `page``Token` | `string` Optional. The nextPageToken value returned from a previous ListMerchantStatusResponse, if any. |\n| `booking``Inventory``Status``Restrict` | `enum (`[BookingInventoryStatus](/maps-booking/reference/maps-booking-api/rest/v1alpha/inventory.partners.merchants.status/list#BookingInventoryStatus)`)` Optional. Optional restriction to filter results by booking inventory status. |\n| `waitlist``Inventory``Status``Restrict` | `enum (`[WaitlistInventoryStatus](/maps-booking/reference/maps-booking-api/rest/v1alpha/inventory.partners.merchants.status/list#WaitlistInventoryStatus)`)` Optional. Optional restriction to filter results by waitlist inventory status. |\n| `geo``Match``Restrict` | `enum (`[GeoMatchingStatus](/maps-booking/reference/maps-booking-api/rest/v1alpha/inventory.partners.merchants.status/list#GeoMatchingStatus)`)` Optional. Optional restriction to filter results by Geo matching status. |\n\n### Request body\n\nThe request body must be empty.\n\n### Response body\n\nThe response to list [MerchantStatus](/maps-booking/reference/maps-booking-api/rest/v1alpha/MerchantStatus).\n\nIf successful, the response body contains data with the following structure:\n\n| JSON representation |\n|------------------------------------------------------------------------------------------------------------------------------------------------|\n| ``` { \"merchantStatuses\": [ { object (/maps-booking/reference/maps-booking-api/rest/v1alpha/MerchantStatus) } ], \"nextPageToken\": string } ``` |\n\n| Fields ||\n|------------------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `merchant``Statuses[]` | `object (`[MerchantStatus](/maps-booking/reference/maps-booking-api/rest/v1alpha/MerchantStatus)`)` List of merchant statuses that satisfy the filter conditions. |\n| `next``Page``Token` | `string` Token to retrieve the next page of results. There are no more results in the list if empty. |\n\n### Authorization scopes\n\nRequires the following OAuth scope:\n\n- `https://www.googleapis.com/auth/mapsbooking`\n\nBookingInventoryStatus\n----------------------\n\nEnd-to-end booking inventory status.\n\n| Enums ||\n|----------------------------------------|-------------------------------------------------------------|\n| `BOOKING_INVENTORY_STATUS_UNSPECIFIED` | Not specified. |\n| `NO_VALID_FUTURE_INVENTORY` | Merchant doesn't have booking inventory in the next 30 day. |\n| `HAS_VALID_FUTURE_INVENTORY` | Merchant has booking inventory in the next 30 day. |\n\nWaitlistInventoryStatus\n-----------------------\n\nEnd-to-end waitlist inventory status.\n\n| Enums ||\n|-----------------------------------------|----------------------------------------------------|\n| `WAITLIST_INVENTORY_STATUS_UNSPECIFIED` | Not specified. |\n| `NO_VALID_WAITLIST_SERVICE` | Merchant doesn't have service supporting waitlist. |\n| `HAS_VALID_WAITLIST_SERVICE` | Merchant has service supporting waitlist. |\n\nGeoMatchingStatus\n-----------------\n\nMerchant geo matching status.\n\n| Enums ||\n|-----------------------------------|------------------------------|\n| `GEO_MATCHING_STATUS_UNSPECIFIED` | Not specified. |\n| `GEO_UNMATCHED` | Merchant is not geo matched. |\n| `GEO_MATCHED` | Merchant is geo matched. |"]]