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)
  },
  "linkedObjectIds": [
    string
  ],
  "notifyPreference": enum (NotificationSettingsForUpdates),
  "valueAddedModuleData": [
    {
      object (ValueAddedModuleData)
    }
  ]
}
الحقول
kind
(deprecated)

string

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

object (FlightClass)

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

string

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

على سبيل المثال: "Dave M Gahan" أو "Gahan/Dave" أو "GAHAN/DAVEM"
boardingAndSeatingInfo

object (BoardingAndSeatingInfo)

معلومات خاصة بالراكب حول الصعود إلى الطائرة والمقاعد
reservationInfo

object (ReservationInfo)

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

string

لون خلفية البطاقة. إذا لم يتم ضبطه، يتم استخدام اللون السائد لصورة العرض، وإذا لم يتم ضبط صورة عرض، يتم استخدام اللون السائد للشعار. يكون التنسيق على النحو التالي: #rrggbb حيث يكون rrggbb مجموعة RGB سداسية عشرية، مثل #ffcc00. يمكنك أيضًا استخدام النسخة المختصرة من مجموعة RGB الثلاثية وهي #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[]
(deprecated)

object (LatLongPoint)

ملاحظة: لا يمكن حاليًا استخدام هذا الحقل لتشغيل الإشعارات الجغرافية.
hasUsers

boolean

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

string

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

boolean

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

boolean

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

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

object (InfoModuleData)

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

object (ImageModuleData)

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

object (TextModuleData)

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

object (RotatingBarcode)

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

object (Image)

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

object (GroupingInfo)

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

object (PassConstraints)

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

object (SaveRestrictions)

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

string

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

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

يجب أن تتّبع معرّفات العناصر التنسيق issuer ID.identifier حيث تُصدر Google المعرّف الأول ويكون المعرّف الثاني من اختيارك.
notifyPreference

enum (NotificationSettingsForUpdates)

ما إذا كان يجب أن تؤدي تعديلات الحقل على هذا العنصر إلى تشغيل الإشعارات أم لا. عند ضبط القيمة على NOTIFY (إشعار)، سنحاول إرسال إشعار إلى المستخدمين بشأن تعديل الحقل. ولن يتم إرسال هذه الإشعارات إلى المستخدمين إلا إذا كان الحقل جزءًا من قائمة مسموح بها. في حال الضبط على DO_NOT_NOTIFY أو NOTIFICATION_SETTINGS_UNSPECIFIED، لن يتم تشغيل أي إشعار. هذا الإعداد مؤقت ويجب ضبطه مع كل طلب PATCH أو UPDATE، وإلا لن يتم تشغيل إشعار.
valueAddedModuleData[]

object (ValueAddedModuleData)

بيانات اختيارية لمكوّنات القيمة المضافة 10 إضافات كحد أقصى على الكائن.

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

قيمة فئة المقعد

على سبيل المثال: "درجة اقتصادية" أو "درجة اقتصادية مميّزة"
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 & More"
frequentFlyerNumber

string

رقم برنامج المسافر الدائم

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

الطُرق

addmessage

 تُضيف رسالة إلى عنصر الرحلة المُشار إليه بمعرّف العنصر المحدّد.

get

 لعرض عنصر الرحلة الجوية باستخدام معرّف العنصر المحدّد.

insert

 تُدرج عنصر رحلة جوية بالمعرّف والسمات المحدّدة.

list

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

patch

 تعديل عنصر الرحلة المُشار إليه بمعرّف العنصر المحدّد

update

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