Method: accounts.lfpStores.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ê các cửa hàng của người bán mục tiêu, được chỉ định bằng bộ lọc trong ListLfpStoresRequest
.
Yêu cầu HTTP
GET https://merchantapi.googleapis.com/lfp/v1beta/{parent=accounts/*}/lfpStores
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. Đối tác LFP. Định dạng accounts/{account}
|
Tham số truy vấn
Thông số |
targetAccount |
string (int64 format)
Bắt buộc. Mã truy cập Merchant Center của người bán mà bạn muốn thêm cửa hàng.
|
pageSize |
integer
Không bắt buộc. Số lượng tài nguyên LfpStore tối đa mà tài khoản nhất định trả về. Dịch vụ sẽ trả về ít hơn giá trị này nếu số lượng cửa hàng của tài khoản nhất định ít hơn pageSize . Giá trị mặc định là 250. Giá trị tối đa là 1000; Nếu bạn chỉ định một giá trị cao hơn giá trị tối đa, thì pageSize sẽ mặc định là giá trị tối đa.
|
pageToken |
string
Không bắt buộc. Mã thông báo trang, nhận được từ lệnh gọi ListLfpStoresRequest trước đó. Cung cấp mã thông báo trang để truy xuất trang tiếp theo. Khi phân trang, tất cả các tham số khác được cung cấp cho ListLfpStoresRequest phải khớp với lệnh gọi đã cung cấp mã thông báo trang. Mã thông báo được trả về dưới dạng nextPageToken trong phản hồi cho yêu cầu trước đó.
|
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
Thông báo phản hồi cho phương thức lfpStores.list.
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 |
{
"lfpStores": [
{
object (LfpStore )
}
],
"nextPageToken": string
} |
Trường |
lfpStores[] |
object (LfpStore )
Các cửa hàng của người bán đã chỉ định.
|
nextPageToken |
string
Mã thông báo có thể được gửi dưới dạng pageToken để truy xuất trang tiếp theo. Nếu bạn bỏ qua trường này, thì sẽ không có trang tiếp theo.
|
Phạm vi uỷ quyền
Yêu cầu phạm vi OAuth sau:
https://www.googleapis.com/auth/content
Để biết thêm thông tin, hãy xem OAuth 2.0 Overview.
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-01-23 UTC.
[null,null,["Cập nhật lần gần đây nhất: 2025-01-23 UTC."],[[["\u003cp\u003eLists stores for a target merchant using the \u003ccode\u003eListLfpStoresRequest\u003c/code\u003e filter.\u003c/p\u003e\n"],["\u003cp\u003eRequires specifying the LFP partner and Merchant Center ID in the request.\u003c/p\u003e\n"],["\u003cp\u003eSupports pagination to retrieve large lists of stores.\u003c/p\u003e\n"],["\u003cp\u003eReturns an array of \u003ccode\u003eLfpStore\u003c/code\u003e objects containing store information.\u003c/p\u003e\n"],["\u003cp\u003eRequires the \u003ccode\u003ehttps://www.googleapis.com/auth/content\u003c/code\u003e OAuth scope for authorization.\u003c/p\u003e\n"]]],["This describes how to list a merchant's stores using an HTTP GET request to `https://merchantapi.googleapis.com/lfp/v1beta/{parent=accounts/*}/lfpStores`. The `parent` path parameter specifies the account. Required query parameters include `targetAccount` for the merchant ID. Optional query parameters `pageSize` and `pageToken` control pagination. The empty request returns a JSON response with an array of `lfpStores` and an optional `nextPageToken` for pagination, all requiring OAuth scope `https://www.googleapis.com/auth/content`.\n"],null,["# Method: accounts.lfpStores.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.ListLfpStoresResponse.SCHEMA_REPRESENTATION)\n- [Authorization scopes](#body.aspect)\n- [Try it!](#try-it)\n\nLists the stores of the target merchant, specified by the filter in `ListLfpStoresRequest`.\n\n### HTTP request\n\n`GET https://merchantapi.googleapis.com/lfp/v1beta/{parent=accounts/*}/lfpStores`\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 LFP partner. Format: `accounts/{account}` |\n\n### Query parameters\n\n| Parameters ||\n|-----------------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `targetAccount` | `string (`[int64](https://developers.google.com/discovery/v1/type-format)` format)` Required. The Merchant Center id of the merchant to list stores for. |\n| `pageSize` | `integer` Optional. The maximum number of `LfpStore` resources for the given account to return. The service returns fewer than this value if the number of stores for the given account is less than the `pageSize`. The default value is 250. The maximum value is 1000; If a value higher than the maximum is specified, then the `pageSize` will default to the maximum. |\n| `pageToken` | `string` Optional. A page token, received from a previous `ListLfpStoresRequest` call. Provide the page token to retrieve the subsequent page. When paginating, all other parameters provided to `ListLfpStoresRequest` must match the call that provided the page token. The token returned as [nextPageToken](/merchant/api/reference/rest/lfp_v1beta/accounts.lfpStores/list#body.ListLfpStoresResponse.FIELDS.next_page_token) in the response to the previous request. |\n\n### Request body\n\nThe request body must be empty.\n\n### Response body\n\nResponse message for the lfpStores.list method.\n\nIf successful, the response body contains data with the following structure:\n\n| JSON representation |\n|----------------------------------------------------------------------------------------------------------------------------------------|\n| ``` { \"lfpStores\": [ { object (/merchant/api/reference/rest/lfp_v1beta/accounts.lfpStores#LfpStore) } ], \"nextPageToken\": string } ``` |\n\n| Fields ||\n|-----------------|----------------------------------------------------------------------------------------------------------------------------------------|\n| `lfpStores[]` | `object (`[LfpStore](/merchant/api/reference/rest/lfp_v1beta/accounts.lfpStores#LfpStore)`)` The stores from the specified merchant. |\n| `nextPageToken` | `string` A token, which can be sent as `pageToken` to retrieve the next page. If this field is omitted, there are no subsequent pages. |\n\n### Authorization scopes\n\nRequires the following OAuth scope:\n\n- `https://www.googleapis.com/auth/content`\n\nFor more information, see the [OAuth 2.0 Overview](/identity/protocols/OAuth2)."]]