REST Resource: flightobject

المورد: FlightObject

تمثيل JSON
{
  "kind": string,
  "classReference": {
    object (FlightClass)
  },
  "passengerName": string,
  "boardingAndSeatingInfo": {
    object (BoardingAndSeatingInfo)
  },
  "reservationInfo": {
    object (ReservationInfo)
  },
  "securityProgramLogo": {
    object (Image)
  },
  "hexBackgroundColor": string,
  "id": string,
  "classId": string,
  "version": string,
  "state": enum (State),
  "barcode": {
    object (Barcode)
  },
  "messages": [
    {
      object (Message)
    }
  ],
  "validTimeInterval": {
    object (TimeInterval)
  },
  "locations": [
    {
      object (LatLongPoint)
    }
  ],
  "hasUsers": boolean,
  "smartTapRedemptionValue": string,
  "hasLinkedDevice": boolean,
  "disableExpirationNotification": boolean,
  "infoModuleData": {
    object (InfoModuleData)
  },
  "imageModulesData": [
    {
      object (ImageModuleData)
    }
  ],
  "textModulesData": [
    {
      object (TextModuleData)
    }
  ],
  "linksModuleData": {
    object (LinksModuleData)
  },
  "appLinkData": {
    object (AppLinkData)
  },
  "rotatingBarcode": {
    object (RotatingBarcode)
  },
  "heroImage": {
    object (Image)
  },
  "groupingInfo": {
    object (GroupingInfo)
  },
  "passConstraints": {
    object (PassConstraints)
  },
  "saveRestrictions": {
    object (SaveRestrictions)
  }
}
الحقول
kind
(deprecated)

string

يحدد نوع هذا المورد. القيمة: السلسلة الثابتة "walletobjects#flightObject"

classReference

object (FlightClass)

نسخة من الحقول المكتسَبة للفئة الرئيسية يتم استرداد هذه الحقول أثناء عملية GET.

passengerName

string

مطلوب. اسم الراكب كما يظهر على بطاقة صعود الطائرة.

على سبيل المثال: "سامي محمود" أو "غاهان/ديف" أو "GAHAN/DAVEM"

boardingAndSeatingInfo

object (BoardingAndSeatingInfo)

معلومات محدّدة للركّاب بشأن أماكن صعود الطائرة والمقاعد

reservationInfo

object (ReservationInfo)

مطلوب. معلومات عن حجز رحلات الطيران.

hexBackgroundColor

string

لون خلفية البطاقة إذا لم يتم تعيين اللون السائد لصورة الجزء الرئيسي، وإذا لم يتم تعيين صورة الجزء الرئيسي، فسيتم استخدام اللون السائد في الشعار. التنسيق هو رقم rrggbb، حيث يكون rrggbb عبارة عن ثلاثي بنموذج أحمر أخضر أزرق سداسي، مثل #ffcc00. يمكنك أيضًا استخدام النسخة المختصرة للنموذج الثلاثي أحمر أخضر أزرق، وهو رقم rgb، مثل #fc0.

id

string

مطلوب. تمثّل هذه السمة المعرّف الفريد للعنصر. ويجب أن يكون هذا المعرّف فريدًا في كل العناصر من جهة الإصدار. يجب أن تتبع هذه القيمة التنسيق issuer ID.identifier حيث يتم إصدار الطريقة السابقة من قِبل Google واختيار الطريقة الثانية من قِبلك. يجب أن يحتوي المعرّف الفريد فقط على أحرف أبجدية رقمية أو "." أو "_" أو "-".

classId

string

مطلوب. الفئة المرتبطة بهذا العنصر. يجب أن تكون الفئة من نوع هذا العنصر نفسه، ويجب أن تكون متوفّرة من قبل، ويجب أن تتم الموافقة عليها.

يجب أن تتبع أرقام تعريف الصفوف التنسيق issuer ID.identifier حيث يتم إصدار الطريقة السابقة من قِبل Google واختيار الطريقة الثانية من قِبلك.

version
(deprecated)

string (int64 format)

منهي العمل به

state

enum (State)

مطلوب. حالة العنصر يُستخدَم هذا الحقل لتحديد كيفية عرض عنصر في التطبيق. على سبيل المثال، يتم نقل عنصر inactive إلى قسم "البطاقات المنتهية الصلاحية". .

barcode

object (Barcode)

نوع الرمز الشريطي وقيمته

messages[]

object (Message)

مصفوفة من الرسائل المعروضة في التطبيق سيتلقّى جميع مستخدمي هذا العنصر الرسائل المرتبطة به. الحد الأقصى لعدد هذه الحقول هو 10.

validTimeInterval

object (TimeInterval)

الفترة الزمنية التي سيكون هذا الكائن فيها active ويمكن استخدام الكائن. سيتم تغيير حالة العنصر إلى expired عند انقضاء هذه الفترة الزمنية.

locations[]

object (LatLongPoint)

ملاحظة: هذا الحقل غير متاح حاليًا لتشغيل الإشعارات الجغرافية.

hasUsers

boolean

يشير إلى ما إذا كان العنصر يحتوي على مستخدمين. تضبط المنصة هذا الحقل.

smartTapRedemptionValue

string

القيمة التي سيتم إرسالها إلى محطة دفع معتمَدة من خلال تكنولوجيا "الدفع الذكي" عبر NFC لهذا الجهاز يجب أيضًا إعداد حقلَي مستوى الصف enableSmartTap وredemptionIssuers بشكل صحيح لكي تتمكّن البطاقة من استخدام "الدفع الذكي". يُسمح باستخدام أحرف ASCII فقط.

hasLinkedDevice

boolean

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

disableExpirationNotification

boolean

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

في الوقت الحالي، يمكن ضبط هذا الإعداد للرحلات الجوية فقط.

infoModuleData

object (InfoModuleData)

تمّ الإيقاف. يمكنك استخدام textModulesData بدلاً من ذلك.

imageModulesData[]

object (ImageModuleData)

بيانات وحدة الصورة الحدّ الأقصى لعدد هذه الحقول المعروضة هو 1 من مستوى العنصر و1 لمستوى عنصر الفئة.

textModulesData[]

object (TextModuleData)

بيانات الوحدة النصية. وإذا تم تحديد بيانات الوحدة النصية أيضًا في الفئة، سيتم عرض كلتيهما. الحد الأقصى لعدد هذه الحقول المعروضة هو 10 حقول من الكائن و10 من الفئة.

rotatingBarcode

object (RotatingBarcode)

نوع الرمز الشريطي الدوار وقيمته

heroImage

object (Image)

صورة بانر اختيارية معروضة في الجهة الأمامية من البطاقة. وفي حالة عدم وجودها، سيتم عرض صورة الجزء الرئيسي للفئة، إن وجدت. وفي حال عدم توفّر الصورة الرئيسية للفئة أيضًا، لن يتم عرض أي شيء.

groupingInfo

object (GroupingInfo)

المعلومات التي تتحكّم في كيفية تجميع البطاقات معًا

passConstraints

object (PassConstraints)

قيود التمرير للكائن. ويشمل ذلك الحدّ من سلوكيات تقنية NFC ولقطات الشاشة.

saveRestrictions

object (SaveRestrictions)

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

BoardingAndSeatingInfo

تمثيل JSON
{
  "kind": string,
  "boardingGroup": string,
  "seatNumber": string,
  "seatClass": string,
  "boardingPrivilegeImage": {
    object (Image)
  },
  "boardingPosition": string,
  "sequenceNumber": string,
  "boardingDoor": enum (BoardingDoor),
  "seatAssignment": {
    object (LocalizedString)
  }
}
الحقول
kind
(deprecated)

string

يحدد نوع هذا المورد. القيمة: السلسلة الثابتة "walletobjects#boardingAndSeatingInfo"

boardingGroup

string

قيمة مجموعة الصعود إلى الطائرة (أو المنطقة) التي سيسافر إليها هذا الراكب على متن الطائرة

على سبيل المثال: "B"

سيتم تحديد تصنيف هذه القيمة من خلال الحقل boardingPolicy في flightClass الذي يشير إليه هذا العنصر.

seatNumber

string

قيمة مقعد الراكب. في حال عدم توفُّر معرّف محدد، استخدِم السمة seatAssignment بدلاً منها.

على سبيل المثال: "25A"

seatClass

string

تمثّل هذه السمة قيمة فئة المقاعد.

على سبيل المثال: "اقتصادية" أو "Economy Plus"

boardingPrivilegeImage

object (Image)

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

boardingPosition

string

قيمة موضع الصعود إلى الطائرة

على سبيل المثال: "76"

sequenceNumber

string

رقم التسلسل على بطاقة صعود الطائرة. يتطابق هذا عادةً مع التسلسل الذي قام فيه الركاب بتسجيل الوصول. قد تستخدم شركة الخطوط الجوية هذا الرقم لوضع علامات على الحقائب وبطاقات صعود الطائرة يدويًا.

على سبيل المثال: "49"

boardingDoor

enum (BoardingDoor)

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

seatAssignment

object (LocalizedString)

تخصيص مقعد الراكب. تُستخدَم في حال عدم توفّر معرّف محدد لاستخدامه في seatNumber.

على سبيل المثال: "تم التعيين عند البوابة"

BoardingDoor

عمليات التعداد
BOARDING_DOOR_UNSPECIFIED
FRONT
front

الاسم المستعار القديم لـ FRONT. تمّ الإيقاف.

BACK
back

الاسم المستعار القديم لـ BACK. تمّ الإيقاف.

ReservationInfo

تمثيل JSON
{
  "kind": string,
  "confirmationCode": string,
  "eticketNumber": string,
  "frequentFlyerInfo": {
    object (FrequentFlyerInfo)
  }
}
الحقول
kind
(deprecated)

string

يحدد نوع هذا المورد. القيمة: السلسلة الثابتة "walletobjects#reservationInfo"

confirmationCode

string

يجب إدخال رمز تأكيد البيانات لتسجيل الوصول إلى هذه الرحلة الجوية.

هو الرقم الذي يدخله المسافر إلى كشك في المطار للبحث عن الرحلة وطباعة بطاقة صعود الطائرة.

eticketNumber

string

رقم التذكرة الإلكترونية

frequentFlyerInfo

object (FrequentFlyerInfo)

معلومات الاشتراك في برنامج المسافر الدائم

FrequentFlyerInfo

تمثيل JSON
{
  "kind": string,
  "frequentFlyerProgramName": {
    object (LocalizedString)
  },
  "frequentFlyerNumber": string
}
الحقول
kind
(deprecated)

string

يحدد نوع هذا المورد. القيمة: السلسلة الثابتة "walletobjects#frequentFlyerInfo"

frequentFlyerProgramName

object (LocalizedString)

اسم برنامج المسافر الدائم على سبيل المثال: "Lufthansa Miles & المزيد"

frequentFlyerNumber

string

رقم المسافر الدائم:

مطلوبة لكل عنصر مدمَج من نوع walletobjects#frequentFlyerInfo.

الطُرق

addmessage

يضيف هذا الخيار رسالة إلى عنصر الرحلة الجوية المُشار إليه من خلال رقم تعريف العنصر المحدّد.

get

تعرض كائن الرحلة الذي يحمل معرّف الكائن المحدد.

insert

يتم إدراج كائن رحلة جوية برقم التعريف والخصائص المحدّدَين.

list

تعرض قائمة بجميع عناصر رحلات الطيران لرقم تعريف جهة إصدار معيّن.

patch

لتعديل عنصر الرحلة الجوية المُشار إليه باستخدام رقم تعريف العنصر المحدّد

update

لتعديل عنصر الرحلة الجوية المُشار إليه باستخدام رقم تعريف العنصر المحدّد