إضافة بطاقات صعود الطائرة تلقائيًا

الخلفية

تتيح هذه الميزة لشركات الطيران إرسال بطاقات الصعود إلى الطائرة تلقائيًا إلى "محفظة Google" الخاصة بالمستخدم. سيفيد ذلك بشكل خاص المسافرين المتكرّرين الذين سيستفيدون من طريقة أبسط وأسهل لإضافة بطاقات الصعود إلى الطائرة إلى "محفظة Google" بسبب كثرة سفرهم.

يحدث ذلك تلقائيًا بغض النظر عن قناة تسجيل الوصول (مثل الويب أو التطبيق أو كشك المطار). تستخدم شركة الطيران رقم حساب برنامج الولاء الخاص بالمستخدم لربط البطاقة وإرسالها.

ملاحظة: هذه الميزة هي تنفيذ محدّد لإمكانية "ربط البطاقات تلقائيًا". تستخدم بقية المستند المصطلحات الأوسع نطاقًا "البطاقات المرتبطة تلقائيًا" بالإضافة إلى "البطاقة الأساسية" و "البطاقة المرتبطة" لوصف هذه الوظيفة.

طريقة عمل هذه الميزة

الخطوة 1: السماح للمسافر الدائم بإضافة بطاقة الولاء إلى "محفظة Google"

الخطوة 2: إضافة بطاقات صعود الطائرة الجديدة تلقائيًا للمسافر الدائم من خلال ربطها ببطاقة الولاء في "محفظة Google"

بعض الاعتبارات عند استخدام ميزة "البطاقات المرتبطة تلقائيًا"

• يجب أن يستخدم العنصر الأساسي والعنصر المرتبط المعرّف issuerId نفسه.
• هناك حدّ أقصى يبلغ 50 عنصرًا مرتبطًا لكل عنصر أساسي.
• لا يمكن ضمان إرسال البطاقات المرتبطة تلقائيًا، ويُعدّ ذلك من أفضل الممارسات. يمكن للمستخدمين إيقاف تلقّي البطاقات المرتبطة تلقائيًا. إذا كانت حالة الاستخدام مهمة وكان على المستخدم تلقّي البطاقة المرتبطة، ننصح بالتواصل معه من خلال قناة أخرى لضمان إضافة البطاقة.
• تشمل التعديلات على سياسة الاستخدام المقبول في "محفظة Google" إرشادات حول استخدام البطاقات المرتبطة تلقائيًا التي يجب الالتزام بها.

خطوات الدمج

إذا سبق لك إنشاء عنصر أساسي، يمكنك تخطّي الخطوة 1.

1. أنشئ عنصرًا من أي نوع بطاقة مدرَج مع المَعلمات المطلوبة. هذا هو الكائن الأساسي.
2. أنشئ عنصرًا آخر من أي نوع بطاقة مُدرَج. سيكون هذا هو العنصر المرتبط.
3. قبل حفظ العنصر الأساسي أو بعده، عدِّل العنصر الأساسي باستخدام رقم تعريف العنصر المرتبط في المَعلمة linkedObjectIds.

يجب توفّر حمولة دنيا لضبط linkedObjectIds على بطاقة أساسية. تشمل المَعلمات الثلاث المطلوبة ما يلي:

1. ISSUERID.PRIMARY_OBJECT_ID
2. ISSUERID.PRIMARY_CLASS_ID
3. 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"
  }
  …

السلوك المتوقع

بعد تلقّي ردّ ناجح، من المفترض أن تتلقّى الأجهزة التي تم تعديل البطاقة عليها البطاقة المرتبطة. سيتم تجميع هذه البطاقة المرتبطة مع البطاقة الأساسية. يمكن للمستخدمين الاطّلاع على البطاقة المرتبطة من خلال التمرير سريعًا لليسار.

التعامل مع الاستثناءات

قد تحدث أخطاء محتملة عند استخدام واجهة برمجة التطبيقات بشكل غير صحيح، ويمكن أن تشمل ما يلي: