المرجع: GiftCardClass
تمثيل JSON |
---|
{ "kind": string, "merchantName": string, "programLogo": { object ( |
الحقول | |
---|---|
kind |
تحدد نوع هذا المورد. القيمة: السلسلة الثابتة |
merchantName |
اسم التاجر، مثل "آدم للملابس". قد يعرض التطبيق علامة حذف بعد أول 20 حرفًا لضمان عرض السلسلة الكاملة على الشاشات الأصغر حجمًا. |
programLogo |
شعار برنامج أو شركة بطاقات الهدايا. ويتم عرض هذا الشعار في كل من تفاصيل التطبيق وطريقة عرضه على شكل قائمة. |
pinLabel |
التصنيف الذي سيتم عرضه لرقم التعريف الشخصي، مثل "رقم التعريف الشخصي المكوَّن من 4 أرقام". |
eventNumberLabel |
التصنيف المطلوب عرضه لرقم الحدث، مثل "رقم الحدث المستهدف". |
allowBarcodeRedemption |
تحدّد هذه السمة ما إذا كان التاجر يتيح تحصيل قيمة بطاقات الهدايا باستخدام الرمز الشريطي. في حال ضبطها على "صحيح"، يعرض التطبيق رمزًا شريطيًا لبطاقة الهدايا على شاشة تفاصيل بطاقة الهدايا. وفي حال اختيار القيمة "false"، لن يتمّ عرض رمز شريطي. |
localizedMerchantName |
سلاسل النصوص المترجَمة للتاجر MerchantName قد يعرض التطبيق علامة حذف بعد أول 20 حرفًا لضمان عرض السلسلة الكاملة على الشاشات الأصغر حجمًا. |
localizedPinLabel |
سلاسل مترجمة لـpinLabel. |
localizedEventNumberLabel |
السلاسل المترجمة للحدث eventNumberLabel. |
cardNumberLabel |
التصنيف الذي سيتم عرضه لرقم البطاقة، مثل "رقم البطاقة" |
localizedCardNumberLabel |
السلاسل المترجمة للبطاقة CardNumberLabel. |
classTemplateInfo |
معلومات نموذجية حول طريقة عرض الصف وفي حال ترك هذه السياسة بدون ضبط، ستلجأ Google إلى استخدام مجموعة تلقائية من الحقول لعرضها. |
id |
مطلوبة. المعرّف الفريد لفئة معيّنة. ويجب أن يكون رقم التعريف هذا فريدًا في كل الفئات التي تسجّلها جهة الإصدار. يجب أن تتبع هذه القيمة التنسيق issuer ID.identifier حيث تُصدر Google القيمة الأولى وتختار أنت الرقم الثاني. يجب أن يتضمن المعرّف الفريد أحرفًا أبجدية رقمية أو "." أو "_" أو "-". |
version |
منهي العمل به |
issuerName |
مطلوبة. اسم جهة الإصدار الحد الأقصى المقترَح للطول هو 20 حرفًا لضمان عرض السلسلة الكاملة على الشاشات الأصغر حجمًا. |
messages[] |
مجموعة من الرسائل المعروضة في التطبيق. سيتلقّى جميع مستخدمي هذا العنصر الرسائل المرتبطة به. الحد الأقصى لعدد هذه الحقول هو 10. |
allowMultipleUsersPerObject |
تمّ الإيقاف. يمكنك استخدام |
homepageUri |
عنوان URI للصفحة الرئيسية للتطبيق. تؤدي تعبئة معرّف الموارد المنتظم (URI) في هذا الحقل إلى اتباع نفس طريقة تعبئة URI في linkModuleData (عند عرض كائن، يظهر رابط إلى الصفحة الرئيسية في ما يُعرَف عادةً باسم قسم linkModuleData في الكائن). |
locations[] |
ملاحظة: هذا الحقل غير متاح حاليًا لتشغيل إشعارات الموقع الجغرافي. |
reviewStatus |
مطلوبة. حالة الفئة. يمكن ضبط هذا الحقل على يجب الاحتفاظ بهذا الحقل في الحقل " عليك ضبط هذا الحقل على عند تعديل صف في " |
review |
تعليقات المراجعة التي تضبطها المنصّة عندما يتم وضع علامة |
infoModuleData |
تمّ الإيقاف. استخدِم textModulesData بدلاً من ذلك. |
imageModulesData[] |
بيانات وحدة الصورة الحد الأقصى لعدد هذه الحقول المعروضة هو 1 من مستوى العنصر و1 لمستوى عنصر الفئة. |
textModulesData[] |
بيانات وحدة النص وإذا تمّ تحديد بيانات الوحدة النصية أيضًا في الفئة، سيتمّ عرض المجموعتَين. الحد الأقصى لعدد هذه الحقول المعروضة هو 10 من العنصر و10 من الفئة. |
linksModuleData |
بيانات وحدة الروابط. إذا تم أيضًا تحديد بيانات وحدة الروابط على الكائن، سيظهر كلاهما. |
redemptionIssuers[] |
تحدّد جهات إصدار البطاقة التي يمكنها تحصيل قيمة البطاقة من خلال "الدفع الذكي". ويتم تحديد جهات إصدار البطاقات من خلال رقم تعريف جهة الإصدار. يجب أن يكون لدى جهات إصدار تحصيل القيمة مفتاح واحد على الأقل تم إعداده لميزة "الدفع الذكي". ويجب أيضًا إعداد الحقلين |
countryCode |
رمز البلد المستخدَم لعرض بلد البطاقة (عندما لا يكون المستخدم في ذلك البلد)، وكذلك لعرض محتوى مترجَم عندما لا يكون المحتوى متاحًا بلغة المستخدم. |
heroImage |
صورة بانر اختيارية يتم عرضها على الجزء الأمامي من البطاقة. وفي حال عدم توفّر أي منها، لن يتم عرض أي بيانات. سيتم عرض الصورة بنسبة 100%. |
wordMark |
تمّ الإيقاف. |
enableSmartTap |
تحدّد هذه العلامة ما إذا كانت هذه الفئة تتيح استخدام ميزة "الدفع الذكي". ويجب أيضًا إعداد الحقلين |
hexBackgroundColor |
لون خلفية البطاقة إذا لم يتم تعيين اللون السائد لصورة الجزء الرئيسي، وإذا لم يتم تعيين صورة الجزء الرئيسي، فسيتم استخدام اللون السائد للشعار. التنسيق هو #rrggbb حيث يكون rrggbb ثلاثي الأبعاد بنموذج أحمر أخضر أزرق، مثل |
localizedIssuerName |
سلاسل مُترجَمة لـ providerName الحد الأقصى المقترَح للطول هو 20 حرفًا لضمان عرض السلسلة الكاملة على الشاشات الأصغر حجمًا. |
multipleDevicesAndHoldersAllowedStatus |
تحدِّد ما إذا كان العديد من المستخدمين والأجهزة سيحفظون العنصر نفسه الذي يشير إلى هذه الفئة. |
callbackOptions |
خيارات معاودة الاتصال التي يمكن استخدامها لمعاودة الاتصال بجهة الإصدار لكل عملية حفظ/حذف لعنصر في هذه الفئة من قِبل المستخدم النهائي جميع عناصر هذه الفئة مؤهَّلة لمعاودة الاتصال. |
securityAnimation |
معلومات اختيارية حول الحركة الأمنية. في حال ضبط ذلك، سيتم عرض صورة متحركة للأمان على تفاصيل البطاقة. |
viewUnlockRequirement |
الاطّلاع على خيارات "متطلبات فتح القفل" لبطاقة الهدايا |
wideProgramLogo |
الشعار العريض لبرنامج أو شركة بطاقات الهدايا. عند توفير هذا الشعار، سيتم استخدامه بدلاً من شعار البرنامج في أعلى يمين عرض البطاقة. |
appLinkData |
رابط اختياري للتطبيق أو الموقع الإلكتروني سيتم عرضه كزر في الجهة الأمامية من البطاقة في حال تقديم AppLinkData للعنصر المقابل الذي سيتم استخدامه بدلاً من ذلك |
الطُرق |
|
---|---|
|
يؤدي هذا الإجراء إلى إضافة رسالة إلى فئة بطاقة الهدايا المُشار إليها من خلال رقم تعريف الفئة المحدّد. |
|
لعرض فئة بطاقة الهدايا باستخدام معرّف الفئة المحدّد. |
|
يتم إدخال فئة بطاقة هدايا مع المعرّف والخصائص المقدَّمة. |
|
لعرض قائمة بكل فئات بطاقات الهدايا لرقم تعريف جهة إصدار معيّن. |
|
لتعديل فئة بطاقة الهدايا المُشار إليها من خلال معرّف الصف المحدّد. |
|
لتعديل فئة بطاقة الهدايا المُشار إليها من خلال معرّف الصف المحدّد. |