Method: giftcardobject.list

تعرض قائمة بجميع عناصر بطاقة الهدايا لرقم تعريف جهة إصدار معيّن.

طلب HTTP

GET https://walletobjects.googleapis.com/walletobjects/v1/giftCardObject

يستخدِم عنوان URL بنية تحويل ترميز gRPC.

معامِلات طلب البحث

المعلمات
classId

string

معرّف الفئة التي سيتم إدراج عناصرها.
token

string

يتم استخدامه للحصول على المجموعة التالية من النتائج في حال تحديد maxResults، ولكن يتوفّر أكثر من maxResults عنصر في القائمة. على سبيل المثال، إذا كانت لديك قائمة تضم 200 عنصر وتم ضبط maxResults على 20 عنصرًا، ستعرض القائمة أول 20 عنصرًا ورمزًا مميزًا. قائمة المكالمات مرة أخرى مع ضبط maxResults على 20 والرمز المميّز للحصول على العناصر الـ 20 التالية.
maxResults

integer

تحدد الحد الأقصى لعدد النتائج التي تعرضها القائمة. ويتم عرض جميع النتائج إذا لم يتم تحديد السمة maxResults.

نص الطلب

يجب أن يكون نص الطلب فارغًا.

نص الاستجابة

إذا كانت الاستجابة ناجحة، سيحتوي نص الاستجابة على بيانات بالبنية التالية:

تمثيل JSON 
{
  "resources": [
    {
      object (GiftCardObject)
    }
  ],
  "pagination": {
    object (Pagination)
  }
}
الحقول
resources[]

object (GiftCardObject)

الموارد المقابلة لطلب القائمة.
pagination

object (Pagination)

التقسيم على صفحات للاستجابة.

نطاقات الأذونات

يجب توفير نطاق OAuth التالي:

  • https://www.googleapis.com/auth/wallet_object.issuer