Method: accounts.dataSources.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ấu hình cho nguồn dữ liệu của tài khoản đã cho.
Yêu cầu HTTP
GET https://merchantapi.googleapis.com/datasources/v1beta/{parent=accounts/*}/dataSources
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. Tài khoản cần liệt kê nguồn dữ liệu. Định dạng accounts/{account}
|
Tham số truy vấn
Thông số |
pageSize |
integer
Không bắt buộc. Số lượng nguồn dữ liệu tối đa cần trả về. Dịch vụ có thể trả về ít hơn giá trị này. Giá trị tối đa là 1000; các giá trị trên 1000 sẽ được chuyển đổi thành 1000. Nếu không chỉ định, hệ thống sẽ trả về số lượng nguồn dữ liệu 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 dataSources.list trước đó. Cung cấp giá trị này để 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 dataSources.list phải khớp với lệnh gọi đã cung cấp mã thông báo trang.
|
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 dataSources.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 |
{
"dataSources": [
{
object (DataSource )
}
],
"nextPageToken": string
} |
Trường |
dataSources[] |
object (DataSource )
Các nguồn dữ liệu từ tài khoản được 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 data source configurations for a given Merchant Center account.\u003c/p\u003e\n"],["\u003cp\u003eUses the \u003ccode\u003eGET\u003c/code\u003e method and requires \u003ccode\u003eparent\u003c/code\u003e as a path parameter to specify the account.\u003c/p\u003e\n"],["\u003cp\u003eAccepts optional query parameters for pagination: \u003ccode\u003epageSize\u003c/code\u003e and \u003ccode\u003epageToken\u003c/code\u003e.\u003c/p\u003e\n"],["\u003cp\u003eReturns a list of \u003ccode\u003eDataSource\u003c/code\u003e objects and a \u003ccode\u003enextPageToken\u003c/code\u003e for subsequent pages, if available.\u003c/p\u003e\n"],["\u003cp\u003eRequires authorization with the \u003ccode\u003ehttps://www.googleapis.com/auth/content\u003c/code\u003e scope.\u003c/p\u003e\n"]]],["This document details how to list data sources for a given account using an HTTP GET request. The request URL follows a specific format: `https://merchantapi.googleapis.com/datasources/v1beta/{parent=accounts/*}/dataSources`, where `parent` is the required account identifier. Optional query parameters, `pageSize` (maximum 1000) and `pageToken`, control the number of results and pagination. The request body should be empty. The successful response includes an array of `dataSources` and an optional `nextPageToken` for subsequent pages. The `https://www.googleapis.com/auth/content` OAuth scope is required.\n"],null,["# Method: accounts.dataSources.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.ListDataSourcesResponse.SCHEMA_REPRESENTATION)\n- [Authorization scopes](#body.aspect)\n- [Try it!](#try-it)\n\nLists the configurations for data sources for the given account.\n\n### HTTP request\n\n`GET https://merchantapi.googleapis.com/datasources/v1beta/{parent=accounts/*}/dataSources`\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 account to list data sources for. Format: `accounts/{account}` |\n\n### Query parameters\n\n| Parameters ||\n|-------------|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `pageSize` | `integer` Optional. The maximum number of data sources to return. The service may return fewer than this value. The maximum value is 1000; values above 1000 will be coerced to 1000. If unspecified, the maximum number of data sources will be returned. |\n| `pageToken` | `string` Optional. A page token, received from a previous `dataSources.list` call. Provide this to retrieve the subsequent page. When paginating, all other parameters provided to `dataSources.list` must match the call that provided the page token. |\n\n### Request body\n\nThe request body must be empty.\n\n### Response body\n\nResponse message for the dataSources.list method.\n\nIf successful, the response body contains data with the following structure:\n\n| JSON representation |\n|------------------------------------------------------------------------------------------------------------------------------------------------------|\n| ``` { \"dataSources\": [ { object (/merchant/api/reference/rest/datasources_v1beta/accounts.dataSources#DataSource) } ], \"nextPageToken\": string } ``` |\n\n| Fields ||\n|-----------------|---------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `dataSources[]` | `object (`[DataSource](/merchant/api/reference/rest/datasources_v1beta/accounts.dataSources#DataSource)`)` The data sources from the specified account. |\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)."]]