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)
  }
}
الحقول
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 ثلاثي الأبعاد بنموذج أحمر أخضر أزرق، مثل #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[]

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 ولقطات الشاشة.

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

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

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

سيتم تحديد تصنيف هذه القيمة من خلال الحقل 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)

اسم برنامج المسافر الدائم. مثال: "لوفتهانزا ميلز وغيرها"
frequentFlyerNumber

string

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

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

الطُرق

addmessage

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

get

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

insert

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

list

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

patch

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

update

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