Method: loyaltyobject.list
تنظيم صفحاتك في مجموعات
يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
تعرض قائمة بجميع عناصر الولاء لرقم تعريف جهة إصدار معيّن.
طلب HTTP
GET https://walletobjects.googleapis.com/walletobjects/v1/loyaltyObject
يستخدِم عنوان URL بنية تحويل ترميز gRPC.
معامِلات طلب البحث
| المعلمات |
classId |
string
معرّف الفئة التي سيتم إدراج عناصرها.
|
token |
string
يتم استخدامه للحصول على المجموعة التالية من النتائج في حال تحديد maxResults، ولكن يتوفّر أكثر من maxResults عنصر في القائمة. على سبيل المثال، إذا كانت لديك قائمة تضم 200 عنصر وتم ضبط maxResults على 20 عنصرًا، ستعرض القائمة أول 20 عنصرًا ورمزًا مميزًا. قائمة المكالمات مرة أخرى مع ضبط maxResults على 20 والرمز المميّز للحصول على العناصر الـ 20 التالية.
|
maxResults |
integer
تحدد الحد الأقصى لعدد النتائج التي تعرضها القائمة. ويتم عرض جميع النتائج إذا لم يتم تحديد السمة maxResults.
|
نص الطلب
يجب أن يكون نص الطلب فارغًا.
نص الاستجابة
إذا كانت الاستجابة ناجحة، سيحتوي نص الاستجابة على بيانات بالبنية التالية:
| الحقول |
resources[] |
object (LoyaltyObject)
الموارد المقابلة لطلب القائمة.
|
pagination |
object (Pagination)
التقسيم على صفحات للاستجابة.
|
نطاقات الأذونات
يجب توفير نطاق OAuth التالي:
https://www.googleapis.com/auth/wallet_object.issuer
إنّ محتوى هذه الصفحة مرخّص بموجب ترخيص Creative Commons Attribution 4.0 ما لم يُنصّ على خلاف ذلك، ونماذج الرموز مرخّصة بموجب ترخيص Apache 2.0. للاطّلاع على التفاصيل، يُرجى مراجعة سياسات موقع Google Developers. إنّ Java هي علامة تجارية مسجَّلة لشركة Oracle و/أو شركائها التابعين.
تاريخ التعديل الأخير: 2025-07-25 (حسب التوقيت العالمي المتفَّق عليه)
[null,null,["تاريخ التعديل الأخير: 2025-07-25 (حسب التوقيت العالمي المتفَّق عليه)"],[[["\u003cp\u003eThis endpoint retrieves all loyalty objects for a specified issuer ID using a GET request.\u003c/p\u003e\n"],["\u003cp\u003eRequest parameters include \u003ccode\u003eclassId\u003c/code\u003e, \u003ccode\u003etoken\u003c/code\u003e, and \u003ccode\u003emaxResults\u003c/code\u003e to filter and paginate results.\u003c/p\u003e\n"],["\u003cp\u003eThe response includes an array of loyalty 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 scope.\u003c/p\u003e\n"]]],["This outlines retrieving a list of loyalty objects associated with a specific issuer ID via a `GET` HTTP request to a defined URL. The request uses query parameters like `classId`, `token` for pagination, and `maxResults` to limit the returned items. The request body is empty. The successful response includes an array of `LoyaltyObject` resources and pagination details, formatted in JSON. Access requires `https://www.googleapis.com/auth/wallet_object.issuer` authorization scope.\n"],null,["# Method: loyaltyobject.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.LoyaltyObjectListResponse.SCHEMA_REPRESENTATION)\n- [Authorization scopes](#body.aspect)\n\nReturns a list of all loyalty objects for a given issuer ID.\n\n### HTTP request\n\n`GET https://walletobjects.googleapis.com/walletobjects/v1/loyaltyObject`\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/loyaltyobject#LoyaltyObject) } ], \"pagination\": { object (/wallet/reference/rest/v1/Pagination) } } ``` |\n\n| Fields ||\n|---------------|----------------------------------------------------------------------------------------------------------------------------------|\n| `resources[]` | `object (`[LoyaltyObject](/wallet/reference/rest/v1/loyaltyobject#LoyaltyObject)`)` 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`"]]
