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

الخلفية

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

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

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

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

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

أفضل الممارسات

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

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

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

• يجب أن يستخدم العنصر الأساسي والعنصر المرتبط المعرّف issuerId نفسه.
• لا يمكن ضمان إرسال البطاقات المرتبطة تلقائيًا، ويُعدّ ذلك من أفضل الممارسات. يمكن للمستخدمين إيقاف تلقّي البطاقات المرتبطة تلقائيًا. إذا كانت حالة الاستخدام مهمة وكان على المستخدم تلقّي البطاقة المرتبطة، ننصح بالتواصل معه من خلال قناة أخرى لضمان إضافة البطاقة.
• تتضمّن التعديلات على سياسة الاستخدام المقبول في "محفظة 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"
  }
  …

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

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

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