الخلفية
تتيح لك ميزة "البطاقات المرتبطة تلقائيًا" إرسال بطاقات إضافية إلى مستخدم يملك بطاقتك الحالية في "محفظة Google" يمكنك أيضًا ينقل المستخدم قبل الربط إلى بطاقة أساسية عندما يحفظ المستخدم البطاقة الأساسية (الرئيسية). يتم تجميع "البطاقة المرتبطة تلقائيًا" مع البطاقة الأساسية وسيلة شرح أعلى البطاقة الأساسية لإعلام المستخدم بأنّه تم استخدام بطاقة جديدة مرتبطة. يمكن استخدام أنواع البطاقات التالية كبطاقات أساسية أو مرتبطة:
- بطاقة الحدث
- جواز مرور على متن طائرة
- بطاقة نقل عام
- عرض
- بطاقة هدايا
- بطاقة ولاء
- بطاقة عامة
![]() |
![]() |
بطاقة أساسية مع وسيلة شرح تشير إلى إضافة بطاقة جديدة | بطاقة جديدة مرتبطة بالبطاقة الأساسية |
حالات الاستخدام
قد تكون لديك حالات استخدام مختلفة لربط البطاقات ببطاقة حالية. بعض الإشعارات ومن الأمثلة على ذلك:
- ربط عرض ترويجي ببطاقة ولاء حالية
- يمكنك ربط قسيمة وجبة ببطاقة صعود الطائرة أو تذكرة حضور الفعاليات.
- يمكنك ربط بطاقة ركن السيارات بتذكرة لحضور فعالية.
بعض الاعتبارات عند استخدام البطاقات المرتبطة تلقائيًا
- يجب أن يستخدم العنصر الأساسي والعنصر المرتبط رقم تعريف جهة الإصدار نفسه.
- الحد الأقصى المسموح به لعدد العناصر المرتبطة لكل عنصر أساسي هو 50 عنصرًا.
- لا يمكن ضمان إرسال البطاقات المرتبطة بشكل تلقائي، ولا يتم أخذها في الاعتبار بأفضل جهد. يمكن للمستخدمين إيقاف تلقّي البطاقات المرتبطة التلقائية. إذا كانت حالة الاستخدام ويجب أن يحصل المستخدم على البطاقة المرتبطة، فنحن نوصي التواصل من خلال قناة أخرى لضمان إضافة المستخدم للبطاقة.
- تعديلات على سياسة الاستخدام المقبول في "محفظة Google" تضمين إرشادات بشأن استخدام "البطاقات المرتبطة تلقائيًا" التي يجب الالتزام بها.
خطوات الدمج
إذا سبق لك إنشاء عنصر أساسي، يمكنك تخطّي الخطوة 1.
- إنشاء كائن من أي نوع بطاقة مُدرَجة مع المعلمات المطلوبة. هذا هو الكائن الأساسي.
- أنشِئ عنصرًا آخر من أي نوع بطاقة مُدرَجة. سيكون هذا linked.
- إما قبل حفظ العنصر الأساسي أو بعده، تحديث الكائن الأساسي الذي يحمل رقم تعريف العنصر المرتبط في linkedObjectIds .
هناك حد أدنى للحمولة المطلوبة لضبط linkedObjectId على البطاقة. وتشمل المعلمات الثلاث المطلوبة ما يلي:
- ISSUERID.PRIMARY_OBJECT_ID
- ISSUERID.PRIMARY_CLASS_ID
- ISSUERID.LINKED_OBJECT_ID
مثال على طلب JSON لإضافة عنصر مرتبط إلى عنصر بطاقة
… { "id": "ISSUERID.PASS_OBJECTID", "classId": "ISSUERID.PASS_CLASSID", "barcode": { "type": "qrCode", "value": "QR code" }, "linkedObjectIds": {"ISSUERID.LINKED_PASS_OBJECTID"} } …
مثال على استجابة JSON بعد ربط عنصر بعنصر بطاقة
… "state": "active", "linkedObjectIds": { "ISSUERID.LINKED_PASS_OBJECTID" } …
السلوك المتوقع
بعد تلقّي ردّ ناجح، إنّ الأجهزة التي حصلت على البطاقة التي عدّلتها أن يتلقّى البطاقة المرتبطة سيتم تجميع هذه البطاقة المرتبطة مع البطاقة الأساسية. يمكن للمستخدمين الاطّلاع على البطاقة المرتبطة من خلال التمرير سريعًا لليسار.
التعامل مع الاستثناءات
قد تحدث أخطاء محتملة عند الاستخدام غير الصحيح لواجهة برمجة التطبيقات والذي يمكن أن تتضمّن
رسالة | السبب |
---|---|
لا يتشارك العنصر الأساسي والعنصر المرتبط في جهة الإصدار نفسها رقم التعريف | لا يمكنك إرفاق عنصر مرتبط بعنصر جهة إصدار أخرى. |
يشير كل من الكائن الأساسي والكائن المرتبط إلى العنصر نفسه. | لا يمكنك إرفاق العنصر نفسه كعنصر linkedObject. |
الكائن المرتبط غير موجود. | يجب أن يكون العنصر المرتبط قد سبق إدراجه في "محفظة Google". واجهة برمجة التطبيقات. |
العنصر المرتبط يحتوي حاليًا على عنصر آخر مرتبط. لا يمكن إضافة التداخل الكائنات المرتبطة. | لا يمكن أن تحتوي الكائنات المرتبطة على عنصر مرتبط آخر. |
العنصر مرتبط سلفًا بكائن آخر. لا يمكن إضافة الروابط المرتبطة الأخرى. | لا يمكن أن يكون الكائن الأساسي عنصرًا مرتبطًا في حد ذاته. |
لا يمكن إضافة المزيد من العناصر المرتبطة. تم تجاوز الحد الأقصى المسموح به. | تم بلوغ الحدّ الأقصى المسموح به لعدد البطاقات المرتبطة في البطاقة الأساسية، وهو 50 بطاقة. البطاقة. |