تمت ترجمة هذه الصفحة بواسطة Cloud Translation API‏.

REST Resource: giftcardclass

المرجع: GiftCardClass

تمثيل JSON

تمثيل JSON
{ "kind": string, "merchantName": string, "programLogo": { object (`Image`) }, "pinLabel": string, "eventNumberLabel": string, "allowBarcodeRedemption": boolean, "localizedMerchantName": { object (`LocalizedString`) }, "localizedPinLabel": { object (`LocalizedString`) }, "localizedEventNumberLabel": { object (`LocalizedString`) }, "cardNumberLabel": string, "localizedCardNumberLabel": { object (`LocalizedString`) }, "classTemplateInfo": { object (`ClassTemplateInfo`) }, "id": string, "version": string, "issuerName": string, "messages": [ { object (`Message`) } ], "allowMultipleUsersPerObject": boolean, "homepageUri": { object (`Uri`) }, "locations": [ { object (`LatLongPoint`) } ], "reviewStatus": enum (`ReviewStatus`), "review": { object (`Review`) }, "infoModuleData": { object (`InfoModuleData`) }, "imageModulesData": [ { object (`ImageModuleData`) } ], "textModulesData": [ { object (`TextModuleData`) } ], "linksModuleData": { object (`LinksModuleData`) }, "redemptionIssuers": [ string ], "countryCode": string, "heroImage": { object (`Image`) }, "wordMark": { object (`Image`) }, "enableSmartTap": boolean, "hexBackgroundColor": string, "localizedIssuerName": { object (`LocalizedString`) }, "multipleDevicesAndHoldersAllowedStatus": enum (`MultipleDevicesAndHoldersAllowedStatus`), "callbackOptions": { object (`CallbackOptions`) }, "securityAnimation": { object (`SecurityAnimation`) }, "viewUnlockRequirement": enum (`ViewUnlockRequirement`), "wideProgramLogo": { object (`Image`) }, "notifyPreference": enum (`NotificationSettingsForUpdates`), "appLinkData": { object (`AppLinkData`) }, "valueAddedModuleData": [ { object (`ValueAddedModuleData`) } ] }

{
  "kind": string,
  "merchantName": string,
  "programLogo": {
    object (Image)
  },
  "pinLabel": string,
  "eventNumberLabel": string,
  "allowBarcodeRedemption": boolean,
  "localizedMerchantName": {
    object (LocalizedString)
  },
  "localizedPinLabel": {
    object (LocalizedString)
  },
  "localizedEventNumberLabel": {
    object (LocalizedString)
  },
  "cardNumberLabel": string,
  "localizedCardNumberLabel": {
    object (LocalizedString)
  },
  "classTemplateInfo": {
    object (ClassTemplateInfo)
  },
  "id": string,
  "version": string,
  "issuerName": string,
  "messages": [
    {
      object (Message)
    }
  ],
  "allowMultipleUsersPerObject": boolean,
  "homepageUri": {
    object (Uri)
  },
  "locations": [
    {
      object (LatLongPoint)
    }
  ],
  "reviewStatus": enum (ReviewStatus),
  "review": {
    object (Review)
  },
  "infoModuleData": {
    object (InfoModuleData)
  },
  "imageModulesData": [
    {
      object (ImageModuleData)
    }
  ],
  "textModulesData": [
    {
      object (TextModuleData)
    }
  ],
  "linksModuleData": {
    object (LinksModuleData)
  },
  "redemptionIssuers": [
    string
  ],
  "countryCode": string,
  "heroImage": {
    object (Image)
  },
  "wordMark": {
    object (Image)
  },
  "enableSmartTap": boolean,
  "hexBackgroundColor": string,
  "localizedIssuerName": {
    object (LocalizedString)
  },
  "multipleDevicesAndHoldersAllowedStatus": enum (MultipleDevicesAndHoldersAllowedStatus),
  "callbackOptions": {
    object (CallbackOptions)
  },
  "securityAnimation": {
    object (SecurityAnimation)
  },
  "viewUnlockRequirement": enum (ViewUnlockRequirement),
  "wideProgramLogo": {
    object (Image)
  },
  "notifyPreference": enum (NotificationSettingsForUpdates),
  "appLinkData": {
    object (AppLinkData)
  },
  "valueAddedModuleData": [
    {
      object (ValueAddedModuleData)
    }
  ]
}

الحقول
`kind (deprecated)`	`string` تم إيقاف هذا العنصر نهائيًا. لتحديد نوع المورد. القيمة: السلسلة الثابتة `"walletobjects#giftCardClass"`.
`merchantName`	`string` اسم التاجر، مثل "ملابس آدم" قد يعرض التطبيق علامة شرطة منقطة بعد أول 20 حرفًا لضمان عرض السلسلة الكاملة على الشاشات الأصغر حجمًا.
`programLogo`	`object (Image)` شعار برنامج بطاقات الهدايا أو الشركة ويتم عرض هذا الشعار في كلّ من تفاصيل التطبيق وطريقة عرض القائمة.
`pinLabel`	`string` التصنيف الذي سيتم عرضه لرقم التعريف الشخصي، مثل "رقم تعريف شخصي مكوّن من 4 أرقام".
`eventNumberLabel`	`string` التصنيف المطلوب عرضه لرقم الحدث، مثل "رقم الحدث المستهدف"
`allowBarcodeRedemption`	`boolean` يحدِّد ما إذا كان التاجر يتيح تحصيل قيمة بطاقة الهدايا باستخدام الرمز الشريطي. إذا كانت القيمة هي true، يعرض التطبيق رمزًا شريطيًا لبطاقة الهدايا على شاشة "تفاصيل بطاقة الهدايا". إذا كان القيمة خطأ، لن يتم عرض رمز شريطي.
`localizedMerchantName`	`object (LocalizedString)` سلاسل مترجمة لـ MerchantName قد يعرض التطبيق علامة شرطة منقطة بعد أول 20 حرفًا لضمان عرض السلسلة الكاملة على الشاشات الأصغر حجمًا.
`localizedPinLabel`	`object (LocalizedString)` السلاسل النصية المترجَمة لسمة pinLabel
`localizedEventNumberLabel`	`object (LocalizedString)` سلاسل مُترجَمة لعنصر eventNumberLabel
`cardNumberLabel`	`string` التصنيف الذي سيتم عرضه لرقم البطاقة، مثل "رقم البطاقة"
`localizedCardNumberLabel`	`object (LocalizedString)` سلاسل النصوص المترجَمة لبطاقة الرقم التعريفي
`classTemplateInfo`	`object (ClassTemplateInfo)` معلومات النموذج حول كيفية عرض الصف وفي حال عدم ضبطها، ستستعين Google بمجموعة تلقائية من الحقول لعرضها.
`id`	`string` مطلوب. تمثّل هذه السمة المعرّف الفريد لفئة معيّنة. يجب أن يكون هذا المعرّف فريدًا في جميع الفئات الصادرة عن جهة إصدار. يجب أن تكون هذه القيمة بالتنسيق `issuer ID`.`identifier` حيث تُصدر Google المعرّف الأول ويمكنك اختيار المعرّف الثاني. يجب أن يتضمّن المعرّف الفريد أحرفًا أبجدية رقمية فقط أو النقطة أو الشرطة السفلية أو الشرطة المائلة.
`version (deprecated)`	`string (int64 format)` تم إيقاف هذا العنصر نهائيًا. منهي العمل به
`issuerName`	`string` مطلوب. اسم جهة إصدار البطاقة الحد الأقصى المقترَح هو 20 حرفًا لضمان عرض السلسلة الكاملة على الشاشات الأصغر حجمًا.
`messages[]`	`object (Message)` صفيف من الرسائل المعروضة في التطبيق. سيتلقّى جميع مستخدمي هذا العنصر الرسائل المرتبطة به. الحد الأقصى لعدد هذه الحقول هو 10.
`allowMultipleUsersPerObject (deprecated)`	`boolean` تم إيقاف هذا العنصر نهائيًا. تمّ الإيقاف. يمكنك استخدام `multipleDevicesAndHoldersAllowedStatus` كبديل.
`homepageUri`	`object (Uri)` معرّف الموارد المنتظم للصفحة الرئيسية لتطبيقك. يؤدي ملء معرّف الموارد المنتظم في هذا الحقل إلى السلوك نفسه تمامًا الذي يؤدي إليه ملء معرّف الموارد المنتظم في linksModuleData (عند عرض عنصر، يظهر رابط إلى الصفحة الرئيسية في ما يُعتقد عادةً أنّه قسم linksModuleData من العنصر).
`locations[] (deprecated)`	`object (LatLongPoint)` تم إيقاف هذا العنصر نهائيًا. ملاحظة: لا يمكن حاليًا استخدام هذا الحقل لتشغيل الإشعارات الجغرافية.
`reviewStatus`	`enum (ReviewStatus)` مطلوب. حالة الفئة. يمكن ضبط هذا الحقل على `draft` أو `underReview` باستخدام طلبات بيانات الإدراج أو التعديل أو التحديث من واجهة برمجة التطبيقات. بعد تغيير حالة المراجعة من `draft`، قد لا تتمكّن من تغييرها مرة أخرى إلى `draft`. يجب ضبط هذا الحقل على `draft` عندما يكون الصف قيد التطوير. لا يمكن استخدام فئة `draft` لإنشاء أي عنصر. يجب ضبط هذا الحقل على `underReview` عندما تعتقد أنّ الفئة جاهزة للاستخدام. ستضبط المنصة هذا الحقل تلقائيًا على "`approved`"، ويمكن استخدامه على الفور لإنشاء عناصر أو نقل بياناتها. عند تعديل فئة `approved`، يجب مواصلة ضبط هذا الحقل على `underReview`.
`review`	`object (Review)` تعليقات المراجعة التي تحدّدها المنصة عند وضع علامة `approved` أو `rejected` على الصف
`infoModuleData (deprecated)`	`object (InfoModuleData)` تم إيقاف هذا العنصر نهائيًا. تمّ الإيقاف. استخدِم textModulesData بدلاً من ذلك.
`imageModulesData[]`	`object (ImageModuleData)` بيانات وحدة الصور الحد الأقصى لعدد هذه الحقول المعروضة هو حقل واحد من مستوى الكائن وحقل واحد من مستوى كائن الفئة.
`textModulesData[]`	`object (TextModuleData)` بيانات وحدة النصوص إذا تمّ أيضًا تحديد بيانات وحدة النص في الفئة، سيتم عرض كليهما. الحد الأقصى لعدد هذه الحقول المعروضة هو 10 حقول من العنصر و10 حقول من الفئة.
`linksModuleData`	`object (LinksModuleData)` ربط بيانات الوحدة إذا تم أيضًا تحديد بيانات وحدة الروابط على الكائن، سيتم عرض كلتيهما.
`redemptionIssuers[]`	`string (int64 format)` لتحديد الجهات المُصدِرة التي يمكنها تحصيل قيمة البطاقة من خلال تكنولوجيا الدفع الذكي يتم تحديد جهات إصدار عمليات تحصيل القيمة من خلال رقم تعريف جهة الإصدار. يجب أن يكون لدى جهات إصدار رموز الدفع مفتاح "الدفع الذكي" واحد على الأقل مضبوط. يجب أيضًا إعداد الحقلَين `enableSmartTap` و`smartTapRedemptionLevel` على مستوى العنصر بشكل صحيح لكي تتيح البطاقة ميزة "النقرة الذكية".
`countryCode`	`string` رمز البلد المستخدم لعرض بلد البطاقة (عندما لا يكون المستخدم مقيمًا في ذلك البلد)، بالإضافة إلى عرض محتوى مترجَم عندما لا يكون المحتوى متاحًا بلغة المستخدم.
`heroImage`	`object (Image)` صورة بانر اختيارية تظهر على الجهة الأمامية من البطاقة وفي حال عدم توفّر أي منها، لن يتم عرض أي شيء. سيتم عرض الصورة بعرض ‎100%.
`wordMark (deprecated)`	`object (Image)` تم إيقاف هذا العنصر نهائيًا. تمّ الإيقاف.
`enableSmartTap`	`boolean` لتحديد ما إذا كانت هذه الفئة تتيح ميزة "النقرة الذكية". يجب أيضًا إعداد الحقلَين `redemptionIssuers` و`smartTapRedemptionLevel` على مستوى العنصر بشكل صحيح لكي تتيح البطاقة ميزة "النقرة الذكية".
`hexBackgroundColor`	`string` لون خلفية البطاقة إذا لم يتم تعيين اللون السائد لصورة الجزء الرئيسي، وإذا لم يتم تعيين صورة الجزء الرئيسي، فسيتم استخدام اللون السائد في الشعار. يكون التنسيق على النحو التالي: #`rrggbb` حيث يكون `rrggbb` مجموعة RGB س��اسية عشرية، مثل `#ffcc00`. يمكنك أيضًا استخدام النسخة المختصرة من مجموعة RGB الثلاثية وهي #`rgb`، مثل `#fc0`.
`localizedIssuerName`	`object (LocalizedString)` سلاسل مُترجَمة لسمة issuerName الحد الأقصى المقترَح هو 20 حرفًا لضمان عرض السلسلة الكاملة على الشاشات الأصغر حجمًا.
`multipleDevicesAndHoldersAllowedStatus`	`enum (MultipleDevicesAndHoldersAllowedStatus)` لتحديد ما إذا كان سيتم حفظ العنصر نفسه الذي يشير إلى هذه الفئة من قِبل مستخدمين وأجهزة متعددة.
`callbackOptions`	`object (CallbackOptions)` خيارات طلب معاودة الاتصال التي سيتم استخدامها للاتصال بالمُصدِر عند كل حفظ أو حذف عنصر من هذا النوع من قِبل المستخدم النهائي. جميع عناصر هذا الفئة مؤهَّلة لمعاودة الاتصال.
`securityAnimation`	`object (SecurityAnimation)` معلومات اختيارية عن الإعداد المستند إلى الحركة لتأمين الجهاز في حال ضبط هذا الإعداد، ستظهر صورة متحركة أمنية على تفاصيل البطاقة.
`viewUnlockRequirement`	`enum (ViewUnlockRequirement)` اطّلِع على خيارات متطلبات فتح بطاقة الهدايا.
`wideProgramLogo`	`object (Image)` الشعار العريض لبرنامج أو شركة بطاقات الهدايا. عند توفير هذه المعلومات، سيتم استخدامها بدلاً من شعار البرنامج في أعلى يمين عرض البطاقة.
`notifyPreference`	`enum (NotificationSettingsForUpdates)` ما إذا كان من المفترض أن تؤدي تعديلات الحقول على هذه الفئة إلى إرسال إشعارات أم لا عند ضبط هذه السياسة على NOTIFY، سنحاول إرسال إشعار تعديل الحقل للمستخدمين. ولن يتم إرسال هذه الإشعارات إلى المستخدمين إلا إذا كان الحقل جزءًا من قائمة مسموح بها. في حال عدم تحديده، لن يتم تشغيل أي إشعار. هذا الإعداد مؤقت ويجب ضبطه مع كل طلب تصحيح أو تحديث، وإلا لن يتم تشغيل إشعار.
`appLinkData`	`object (AppLinkData)` رابط اختياري للتطبيق أو الموقع الإلكتروني يتم عرضه كزر على الجهة الأمامية من البطاقة إذا تم توفير AppLinkData للكائن المقابل الذي سيتم استخدامه بدلاً من ذلك.
`valueAddedModuleData[]`	`object (ValueAddedModuleData)` بيانات وحدة القيمة المضافة الاختيارية. عشرة فنانين كحد أقصى في الصف بالنسبة إلى البطاقة رقم 10 فقط، يتم عرض رقم البطاقة مع إعطاء الأولوية للبطاقة الواردة في العنصر.

الطُرق
`addmessage`	تُضيف رسالة إلى فئة بطاقة الهدايا التي يشير إليها معرّف الفئة المحدّد.
`get`	لعرض فئة بطاقة الهدايا باستخدام معرّف الفئة المحدّد.
`insert`	تُدرج فئة بطاقة هدايا باستخدام المعرّف والخصائص المحدّدة.
`list`	تعرِض هذه الدالة قائمة بجميع فئات بطاقات الهدايا لمعرّف جهة إصدار معيّن.
`patch`	تعديل فئة بطاقة الهدايا المُشار إليها بمعرّف الفئة المحدّد
`update`	تعديل فئة بطاقة الهدايا المُشار إليها بمعرّف الفئة المحدّد

REST Resource: giftcardclass

المرجع: GiftCardClass

الطُرق

`addmessage`

`get`

`insert`

`list`

`patch`

`update`