REST Resource: eventticketobject

منبع: EventTicketObject

نمایندگی JSON
{
  "kind": string,
  "classReference": {
    object (EventTicketClass)
  },
  "seatInfo": {
    object (EventSeat)
  },
  "reservationInfo": {
    object (EventReservationInfo)
  },
  "ticketHolderName": string,
  "ticketNumber": string,
  "ticketType": {
    object (LocalizedString)
  },
  "faceValue": {
    object (Money)
  },
  "groupingInfo": {
    object (GroupingInfo)
  },
  "linkedOfferIds": [
    string
  ],
  "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)
  },
  "passConstraints": {
    object (PassConstraints)
  }
}
زمینه های
kind
(deprecated)

string

مشخص می کند که این چه نوع منبعی است. مقدار: رشته ثابت "walletobjects#eventTicketObject" .

classReference

object ( EventTicketClass )

یک کپی از فیلدهای ارثی کلاس والد. این فیلدها در طول GET بازیابی می شوند.

seatInfo

object ( EventSeat )

جزئیات صندلی برای این بلیط.

reservationInfo

object ( EventReservationInfo )

جزئیات رزرو این بلیط انتظار می رود که این مورد در بین تمام بلیط هایی که به همان ترتیب خریداری شده اند به اشتراک گذاشته شود.

ticketHolderName

string

نام دارنده بلیط، در صورتی که بلیط به شخصی اختصاص داده شده باشد. به عنوان مثال "جان دو" یا "جین دو".

ticketNumber

string

شماره بلیط این می‌تواند یک شناسه منحصربه‌فرد برای همه بلیت‌ها در سیستم صادرکننده، همه بلیت‌های رویداد (مانند XYZ1234512345)، یا همه بلیط‌ها به ترتیب (1، 2، 3، و غیره) باشد.

ticketType

object ( LocalizedString )

نوع بلیط، مانند «بزرگسال» یا «کودک»، یا «VIP» یا «استاندارد».

faceValue

object ( Money )

ارزش اسمی بلیط، مطابق با آنچه در نسخه فیزیکی بلیط چاپ می شود.

groupingInfo

object ( GroupingInfo )

اطلاعاتی که نحوه گروه بندی پاس ها را کنترل می کند.

linkedOfferIds[]

string

فهرستی از اشیاء پیشنهادی مرتبط با این بلیط رویداد. اشیاء پیشنهاد باید از قبل وجود داشته باشد.

شناسه‌های شی پیشنهاد باید از issuer ID قالب پیروی کنند. identifier جایی که اولی توسط Google صادر می شود و دومی توسط شما انتخاب می شود.

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[]

object ( LatLongPoint )

توجه: این فیلد در حال حاضر برای فعال کردن اعلان‌های جغرافیایی پشتیبانی نمی‌شود.

hasUsers

boolean

نشان می دهد که آیا شیء کاربر دارد یا خیر. این فیلد توسط پلتفرم تنظیم شده است.

smartTapRedemptionValue

string

مقداری که برای این شیء از طریق NFC به پایانه تأیید شده Smart Tap منتقل می شود. فیلدهای سطح کلاس enableSmartTap و redemptionIssuers نیز باید به درستی تنظیم شوند تا پاس از Smart Tap پشتیبانی کند. فقط کاراکترهای ASCII پشتیبانی می شوند.

hasLinkedDevice

boolean

آیا این شی در حال حاضر به یک دستگاه مرتبط است یا خیر. این فیلد زمانی توسط پلتفرم تنظیم می شود که کاربر شی را ذخیره می کند و آن را به دستگاه خود پیوند می دهد. برای استفاده توسط شرکای منتخب در نظر گرفته شده است. برای اطلاعات بیشتر با پشتیبانی تماس بگیرید.

disableExpirationNotification

boolean

نشان می دهد که آیا اعلان ها باید صریحاً سرکوب شوند یا خیر. اگر این فیلد روی درست تنظیم شود، صرف نظر از فیلد messages ، اعلان‌های انقضا به کاربر سرکوب می‌شوند. به طور پیش فرض، این فیلد روی false تنظیم شده است.

در حال حاضر، این فقط برای پیشنهادات قابل تنظیم است.

infoModuleData

object ( InfoModuleData )

منسوخ. به جای آن از textModulesData استفاده کنید.

imageModulesData[]

object ( ImageModuleData )

داده های ماژول تصویر حداکثر تعداد این فیلدهای نمایش داده شده 1 از سطح شی و 1 برای سطح شیء کلاس است.

textModulesData[]

object ( TextModuleData )

داده های ماژول متنی اگر داده های ماژول متنی نیز روی کلاس تعریف شده باشد، هر دو نمایش داده می شوند. حداکثر تعداد این فیلدهای نمایش داده شده 10 از شی و 10 از کلاس است.

rotatingBarcode

object ( RotatingBarcode )

نوع و مقدار بارکد چرخشی

heroImage

object ( Image )

تصویر بنر اختیاری در جلوی کارت نمایش داده می شود. اگر هیچ کدام وجود نداشته باشد، تصویر قهرمان کلاس، در صورت وجود، نمایش داده می شود. اگر تصویر قهرمان کلاس نیز وجود نداشته باشد، چیزی نمایش داده نخواهد شد.

passConstraints

object ( PassConstraints )

تصویب محدودیت برای شی. شامل محدود کردن NFC و رفتارهای اسکرین شات است.

صندلی رویداد

نمایندگی JSON
{
  "kind": string,
  "seat": {
    object (LocalizedString)
  },
  "row": {
    object (LocalizedString)
  },
  "section": {
    object (LocalizedString)
  },
  "gate": {
    object (LocalizedString)
  }
}
زمینه های
kind
(deprecated)

string

مشخص می کند که این چه نوع منبعی است. مقدار: رشته ثابت "walletobjects#eventSeat" .

seat

object ( LocalizedString )

شماره صندلی، مانند «1»، «2»، «3» یا هر شناسه صندلی دیگری.

این فیلد قابل بومی سازی است، بنابراین می توانید کلمات را ترجمه کنید یا از الفبای مختلف برای کاراکترهای یک شناسه استفاده کنید.

row

object ( LocalizedString )

ردیف صندلی، مانند «1»، «E»، «BB» یا «A5».

این فیلد قابل بومی سازی است، بنابراین می توانید کلمات را ترجمه کنید یا از الفبای مختلف برای کاراکترهای یک شناسه استفاده کنید.

section

object ( LocalizedString )

بخش صندلی، مانند "121".

این فیلد قابل بومی سازی است، بنابراین می توانید کلمات را ترجمه کنید یا از الفبای مختلف برای کاراکترهای یک شناسه استفاده کنید.

gate

object ( LocalizedString )

دروازه ای که دارنده بلیط برای رسیدن به صندلی خود باید وارد شود، مانند "A" یا "West".

این فیلد قابل بومی سازی است، بنابراین می توانید کلمات را ترجمه کنید یا از الفبای مختلف برای کاراکترهای یک شناسه استفاده کنید.

EventReservationInfo

نمایندگی JSON
{
  "kind": string,
  "confirmationCode": string
}
زمینه های
kind
(deprecated)

string

مشخص می کند که این چه نوع منبعی است. مقدار: رشته ثابت "walletobjects#eventReservationInfo" .

confirmationCode

string

کد تاییدیه رزرو رویداد. این ممکن است به شکل «شماره سفارش»، «شماره تأیید»، «شماره رزرو» یا سایر موارد مشابه باشد.

مواد و روش ها

addmessage

یک پیام به شی بلیط رویداد که توسط شناسه شی داده شده ارجاع شده است اضافه می کند.

get

شی بلیط رویداد را با شناسه شی داده شده برمی گرداند.

insert

یک شی بلیط رویداد را با شناسه و ویژگی های داده شده درج می کند.

list

فهرستی از تمام اشیاء بلیط رویداد برای شناسه صادرکننده معین را برمی‌گرداند.

modifylinkedofferobjects

اشیاء پیشنهاد پیوند شده را برای شی بلیط رویداد با شناسه داده شده اصلاح می کند.

patch

شی بلیط رویداد را که توسط شناسه شی داده شده ارجاع داده شده است به روز می کند.

update

شی بلیط رویداد را که توسط شناسه شی داده شده ارجاع داده شده است به روز می کند.