Method: giftcardobject.list
使用集合让一切井井有条
根据您的偏好保存内容并对其进行分类。
HTTP 请求
GET https://walletobjects.googleapis.com/walletobjects/v1/giftCardObject
网址采用 gRPC 转码语法。
查询参数
参数 |
classId |
string
要列出其对象的类的 ID。
|
token |
string
如果已指定 maxResults ,但列表中的可用对象超过 maxResults 个,则用于获取下一组结果。例如,如果您的列表包含 200 个对象,并且 maxResults 设置为 20 来调用列表,则列表将返回前 20 个对象和一个令牌。使用设置为 20 的 maxResults 和令牌再次调用列表,将获取下一组的 20 个对象。
|
maxResults |
integer
确定列表返回的结果数上限。如果未定义 maxResults ,则返回所有结果。
|
响应正文
字段 |
resources[] |
object (GiftCardObject )
与列表请求对应的资源。
|
pagination |
object (Pagination )
响应的分页。
|
授权范围
需要以下 OAuth 范围:
https://www.googleapis.com/auth/wallet_object.issuer
如未另行说明,那么本页面中的内容已根据知识共享署名 4.0 许可获得了许可,并且代码示例已根据 Apache 2.0 许可获得了许可。有关详情,请参阅 Google 开发者网站政策。Java 是 Oracle 和/或其关联公司的注册商标。
最后更新时间 (UTC):2025-07-25。
[null,null,["最后更新时间 (UTC):2025-07-25。"],[[["\u003cp\u003eThis endpoint retrieves all gift card objects for a specified issuer ID using a GET request.\u003c/p\u003e\n"],["\u003cp\u003eYou can use query parameters like \u003ccode\u003eclassId\u003c/code\u003e, \u003ccode\u003etoken\u003c/code\u003e, and \u003ccode\u003emaxResults\u003c/code\u003e to filter and paginate the results.\u003c/p\u003e\n"],["\u003cp\u003eThe response includes a list of gift card objects and pagination details in JSON format.\u003c/p\u003e\n"],["\u003cp\u003eAuthorization requires the \u003ccode\u003ehttps://www.googleapis.com/auth/wallet_object.issuer\u003c/code\u003e OAuth scope.\u003c/p\u003e\n"]]],["This describes retrieving a list of gift card objects. A `GET` request is sent to a specific URL, requiring an empty request body. The request can include optional query parameters: `classId` to filter by class, `token` for pagination, and `maxResults` to limit results. Successful responses contain a list of gift card `resources` and `pagination` information in JSON format. The operation requires the `https://www.googleapis.com/auth/wallet_object.issuer` authorization scope.\n"],null,["# Method: giftcardobject.list\n\n- [HTTP request](#body.HTTP_TEMPLATE)\n- [Query parameters](#body.QUERY_PARAMETERS)\n- [Request body](#body.request_body)\n- [Response body](#body.response_body)\n - [JSON representation](#body.GiftCardObjectListResponse.SCHEMA_REPRESENTATION)\n- [Authorization scopes](#body.aspect)\n\nReturns a list of all gift card objects for a given issuer ID.\n\n### HTTP request\n\n`GET https://walletobjects.googleapis.com/walletobjects/v1/giftCardObject`\n\nThe URL uses [gRPC Transcoding](https://google.aip.dev/127) syntax.\n\n### Query parameters\n\n| Parameters ||\n|--------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `classId` | `string` The ID of the class whose objects will be listed. |\n| `token` | `string` Used to get the next set of results if `maxResults` is specified, but more than `maxResults` objects are available in a list. For example, if you have a list of 200 objects and you call list with `maxResults` set to 20, list will return the first 20 objects and a token. Call list again with `maxResults` set to 20 and the token to get the next 20 objects. |\n| `maxResults` | `integer` Identifies the max number of results returned by a list. All results are returned if `maxResults` isn't defined. |\n\n### Request body\n\nThe request body must be empty.\n\n### Response body\n\nIf successful, the response body contains data with the following structure:\n\n| JSON representation |\n|--------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| ``` { \"resources\": [ { object (/wallet/reference/rest/v1/giftcardobject#GiftCardObject) } ], \"pagination\": { object (/wallet/reference/rest/v1/Pagination) } } ``` |\n\n| Fields ||\n|---------------|-------------------------------------------------------------------------------------------------------------------------------------|\n| `resources[]` | `object (`[GiftCardObject](/wallet/reference/rest/v1/giftcardobject#GiftCardObject)`)` Resources corresponding to the list request. |\n| `pagination` | `object (`[Pagination](/wallet/reference/rest/v1/Pagination)`)` Pagination of the response. |\n\n### Authorization scopes\n\nRequires the following OAuth scope:\n\n- `https://www.googleapis.com/auth/wallet_object.issuer`"]]