Method: giftcardobject.list
Tetap teratur dengan koleksi
Simpan dan kategorikan konten berdasarkan preferensi Anda.
Menampilkan daftar semua objek kartu voucher untuk ID penerbit yang diberikan.
Permintaan HTTP
GET https://walletobjects.googleapis.com/walletobjects/v1/giftCardObject
URL menggunakan sintaksis gRPC Transcoding.
Parameter kueri
| Parameter |
classId |
string
ID class yang objeknya akan dicantumkan.
|
token |
string
Digunakan untuk mendapatkan kumpulan hasil berikutnya jika maxResults ditentukan, tetapi tersedia lebih dari maxResults objek dalam daftar. Misalnya, jika Anda memiliki daftar 200 objek dan Anda memanggil daftar dengan maxResults ditetapkan ke 20, daftar akan menampilkan 20 objek pertama dan satu token. Daftar panggilan lagi dengan maxResults ditetapkan ke 20 dan token untuk mendapatkan 20 objek berikutnya.
|
maxResults |
integer
Mengidentifikasi jumlah maksimum hasil yang ditampilkan oleh daftar. Semua hasil akan ditampilkan jika maxResults tidak ditentukan.
|
Isi permintaan
Isi permintaan harus kosong.
Isi respons
Jika berhasil, isi respons memuat data dengan struktur berikut:
| Kolom |
resources[] |
object (GiftCardObject)
Resource yang sesuai dengan permintaan daftar.
|
pagination |
object (Pagination)
Penomoran halaman respons
|
Cakupan otorisasi
Memerlukan cakupan OAuth berikut:
https://www.googleapis.com/auth/wallet_object.issuer
Kecuali dinyatakan lain, konten di halaman ini dilisensikan berdasarkan Lisensi Creative Commons Attribution 4.0, sedangkan contoh kode dilisensikan berdasarkan Lisensi Apache 2.0. Untuk mengetahui informasi selengkapnya, lihat Kebijakan Situs Google Developers. Java adalah merek dagang terdaftar dari Oracle dan/atau afiliasinya.
Terakhir diperbarui pada 2025-07-25 UTC.
[null,null,["Terakhir diperbarui pada 2025-07-25 UTC."],[[["\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`"]]
