Method: loyaltyclass.list
تنظيم صفحاتك في مجموعات
يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
تعرض قائمة بجميع فئات برنامج الولاء لرقم تعريف جهة إصدار معيّن.
طلب HTTP
GET https://walletobjects.googleapis.com/walletobjects/v1/loyaltyClass
يستخدِم عنوان URL بنية تحويل ترميز gRPC.
معامِلات طلب البحث
| المعلمات |
issuerId |
string (int64 format)
تشير هذه السمة إلى رقم تعريف جهة الإصدار المفوّضة لإدراج الفئات.
|
token |
string
يتم استخدامه للحصول على المجموعة التالية من النتائج في حال تحديد maxResults، ولكن يتوفّر أكثر من maxResults صف في القائمة. على سبيل المثال، إذا كانت لديك قائمة تضم 200 صف، وتم ضبط maxResults على 20 صفًا، ستعرض القائمة أول 20 صفًا ورمزًا مميزًا. قائمة المكالمات مجددًا مع ضبط maxResults على 20 والرمز المميّز للحصول على الصفوف العشرين التالية.
|
maxResults |
integer
تحدد الحد الأقصى لعدد النتائج التي تعرضها القائمة. ويتم عرض جميع النتائج إذا لم يتم تحديد السمة maxResults.
|
نص الطلب
يجب أن يكون نص الطلب فارغًا.
نص الاستجابة
إذا كانت الاستجابة ناجحة، سيحتوي نص الاستجابة على بيانات بالبنية التالية:
| الحقول |
resources[] |
object (LoyaltyClass)
الموارد المقابلة لطلب القائمة.
|
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\u003eRetrieves a paginated list of all loyalty classes for a specified issuer ID.\u003c/p\u003e\n"],["\u003cp\u003eAllows filtering the results by specifying the maximum number of results returned (\u003ccode\u003emaxResults\u003c/code\u003e) and using tokens for pagination.\u003c/p\u003e\n"],["\u003cp\u003eRequires an empty request body and returns a JSON response containing an array of loyalty classes and pagination information.\u003c/p\u003e\n"],["\u003cp\u003eNeeds authorization with 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 classes. Use a `GET` request to `https://walletobjects.googleapis.com/walletobjects/v1/loyaltyClass`. Required query parameters include `issuerId`. Optional query parameters `token` and `maxResults` are used for pagination. The request body must be empty. The successful response contains a JSON object with `resources` and `pagination` fields. Requires OAuth scope `https://www.googleapis.com/auth/wallet_object.issuer`.\n"],null,["# Method: loyaltyclass.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.LoyaltyClassListResponse.SCHEMA_REPRESENTATION)\n- [Authorization scopes](#body.aspect)\n\nReturns a list of all loyalty classes for a given issuer ID.\n\n### HTTP request\n\n`GET https://walletobjects.googleapis.com/walletobjects/v1/loyaltyClass`\n\nThe URL uses [gRPC Transcoding](https://google.aip.dev/127) syntax.\n\n### Query parameters\n\n| Parameters ||\n|--------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `issuerId` | `string (`[int64](https://developers.google.com/discovery/v1/type-format)` format)` The ID of the issuer authorized to list classes. |\n| `token` | `string` Used to get the next set of results if `maxResults` is specified, but more than `maxResults` classes are available in a list. For example, if you have a list of 200 classes and you call list with `maxResults` set to 20, list will return the first 20 classes and a token. Call list again with `maxResults` set to 20 and the token to get the next 20 classes. |\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/loyaltyclass#LoyaltyClass) } ], \"pagination\": { object (/wallet/reference/rest/v1/Pagination) } } ``` |\n\n| Fields ||\n|---------------|-------------------------------------------------------------------------------------------------------------------------------|\n| `resources[]` | `object (`[LoyaltyClass](/wallet/reference/rest/v1/loyaltyclass#LoyaltyClass)`)` 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`"]]
