REST Resource: genericobject

Zasób: GeneralObject

Obiekt ogólny

Zapis JSON 
{
  "genericType": enum (GenericType),
  "cardTitle": {
    object (LocalizedString)
  },
  "subheader": {
    object (LocalizedString)
  },
  "header": {
    object (LocalizedString)
  },
  "logo": {
    object (Image)
  },
  "hexBackgroundColor": string,
  "notifications": {
    object (Notifications)
  },
  "id": string,
  "classId": string,
  "barcode": {
    object (Barcode)
  },
  "heroImage": {
    object (Image)
  },
  "validTimeInterval": {
    object (TimeInterval)
  },
  "imageModulesData": [
    {
      object (ImageModuleData)
    }
  ],
  "textModulesData": [
    {
      object (TextModuleData)
    }
  ],
  "linksModuleData": {
    object (LinksModuleData)
  },
  "appLinkData": {
    object (AppLinkData)
  },
  "groupingInfo": {
    object (GroupingInfo)
  },
  "smartTapRedemptionValue": string,
  "rotatingBarcode": {
    object (RotatingBarcode)
  },
  "state": enum (State),
  "hasUsers": boolean,
  "messages": [
    {
      object (Message)
    }
  ],
  "passConstraints": {
    object (PassConstraints)
  },
  "wideLogo": {
    object (Image)
  },
  "saveRestrictions": {
    object (SaveRestrictions)
  },
  "valueAddedModuleData": [
    {
      object (ValueAddedModuleData)
    }
  ],
  "linkedObjectIds": [
    string
  ]
}
Pola
genericType

enum (GenericType)

Określ, do której GenericType należy karta.
cardTitle

object (LocalizedString)

Wymagane. nagłówek dokumentu. Zwykle jest to nazwa firmy, np. „Siłownia XXX” lub „Ubezpieczenia AAA”. To pole jest wymagane i wyświetla się w wierszu nagłówka u samego szczytu dokumentu.
subheader

object (LocalizedString)

Etykieta tytułu karty, np. lokalizacja, w której można jej używać. Pojawia się tuż nad tytułem w wierszu tytułu w widoku szczegółów karty.
header

object (LocalizedString)

Wymagane. Tytuł karty, na przykład „Kupon ze zniżką 50%”, „Karta biblioteczna” lub „Kupon”. To pole jest wymagane i pojawia się w wierszu tytułu w widoku szczegółów biletu.
hexBackgroundColor

string

Kolor tła karty. Jeśli nie jest ustawiony, używany jest dominujący kolor obrazu banera powitalnego, a jeśli obraz banera powitalnego nie jest ustawiony, używany jest dominujący kolor logo. Jeśli logo nie jest ustawione, kolor zostanie wybrany przez Google.
notifications

object (Notifications)

Ustawienia powiadomień włączone dla tego obiektu.
id

string

Wymagane. Unikalny identyfikator obiektu. Ten identyfikator musi być unikalny wśród wszystkich obiektów wydawcy. Ta wartość powinna mieć format issuerID.identifier, gdzie issuerID jest wystawiany przez Google, a identifier jest wybierany przez Ciebie. Unikalny identyfikator może zawierać tylko znaki alfanumeryczne oraz znaki ., _ i -.
classId

string

Wymagane. Klasa powiązana z tym obiektem. Klasa musi być tego samego typu co ten obiekt, musi już istnieć i musi być zatwierdzona.

Identyfikatory klas powinny mieć format issuerID.identifier, gdzie issuerID jest wystawiany przez Google, a identifier jest wybierany przez Ciebie.
barcode

object (Barcode)

Typ i wartość kodu kreskowego. Jeśli karta nie ma kodu kreskowego, możemy zezwolić jej wydawcy na ustawienie wartości Barcode.alternate_text i wyświetlanie tylko tej wartości.
heroImage

object (Image)

Obraz banera wyświetlany z przodu karty (jeśli jest dostępny). Obraz wyświetla się w 100% szerokości.
validTimeInterval

object (TimeInterval)

Okres, przez jaki ten obiekt będzie uważany za ważny lub możliwy do użycia. Po upływie tego okresu obiekt zostanie uznany za wygasły, co wpłynie na renderowanie na urządzeniach użytkowników.
imageModulesData[]

object (ImageModuleData)

Dane modułu obrazu. Gdy oba są ustawione, renderowany będzie tylko jeden obraz z poziomu klasy i jeden z poziomu obiektu.
textModulesData[]

object (TextModuleData)

Dane modułu tekstowego. Jeśli textModulesData jest zdefiniowana również w klasie, będą wyświetlane obydwie wartości. Maksymalna liczba wyświetlanych pól wynosi 10 z klasy i 10 z obiektu.
groupingInfo

object (GroupingInfo)

Informacje określające sposób grupowania kart.
smartTapRedemptionValue

string

Wartość, która zostanie przesłana do terminala z certyfikatem Smart Tap przez NFC dla tego obiektu. Aby karty obsługiwały funkcję smart tap, pola poziomu klasy enableSmartTap i redemptionIssuers muszą być też prawidłowo skonfigurowane. Obsługiwane są tylko znaki ASCII.
rotatingBarcode

object (RotatingBarcode)

Ustawienia/szczegóły obracającego się kodu kreskowego.
state

enum (State)

Stan obiektu. To pole służy do określania sposobu wyświetlania obiektu w aplikacji. Na przykład obiekt inactive jest przenoszony do sekcji „Karty, które straciły ważność”. Jeśli nie podasz tej wartości, obiekt zostanie uznany za ACTIVE.
hasUsers

boolean

Wskazuje, czy obiekt ma użytkowników. To pole jest ustawiane przez platformę.
messages[]

object (Message)

Tablica komunikatów wyświetlanych w aplikacji. Wszyscy użytkownicy tego obiektu będą otrzymywać powiązane z nim komunikaty. Maksymalna liczba tych pól to 10.
passConstraints

object (PassConstraints)

Przekazywanie ograniczeń dotyczących obiektu. Obejmuje to ograniczenie działania NFC i zrzutów ekranu.
saveRestrictions

object (SaveRestrictions)

Ograniczenia dotyczące obiektu, które musi zostać zweryfikowane, zanim użytkownik spróbuje zapisać kartę. Te ograniczenia będą stosowane tylko podczas zapisywania. Jeśli ograniczenia zmienią się po zapisaniu dokumentu, nowe ograniczenia nie zostaną zastosowane do już zapisanego dokumentu.
valueAddedModuleData[]

object (ValueAddedModuleData)

Opcjonalne dane modułu wartości dodanej. Maksymalnie 10 na obiekt.
linkedObjectIds[]

string

PowiązaneObjectId to lista innych obiektów, takich jak bilet na wydarzenie, program lojalnościowy, oferta, oferta ogólna, karta podarunkowa, karta transportu publicznego i karta pokładowa, które powinny być automatycznie dołączane do tego obiektu ogólnego. Jeśli użytkownik zapisze tę ogólną kartę, te identyfikatory połączonych obiektów zostaną automatycznie przesłane do portfela użytkownika (chyba że wyłączy ustawienie dotyczące otrzymywania takich połączonych kart).

Upewnij się, że obiekty obecne w LinkedObjectId są już wstawione. W przeciwnym razie wywołania zakończą się niepowodzeniem. Po połączeniu połączonych obiektów nie można ich odłączyć. Nie możesz łączyć obiektów należących do innego wystawcy. Liczba obiektów, które można połączyć z jednym obiektem, jest ograniczona. Gdy zostanie osiągnięty limit, nowe połączone obiekty w wywołaniu zostaną po cichu zignorowane.

Identyfikatory obiektów powinny mieć format issuer ID.identifier, gdzie pierwszy identyfikator jest wystawiany przez Google, a drugi jest wybierany przez Ciebie.

GenericType

Typ karty ogólnej.

Wartości w polu enum
GENERIC_TYPE_UNSPECIFIED Nieokreślony typ ogólny.
GENERIC_SEASON_PASS Karnet sezonowy
GENERIC_UTILITY_BILLS rachunki za media,
GENERIC_PARKING_PASS Karty parkingowe
GENERIC_VOUCHER Kupon
GENERIC_GYM_MEMBERSHIP Karty członkostwa na siłownię
GENERIC_LIBRARY_MEMBERSHIP karty biblioteczne,
GENERIC_RESERVATIONS Rezerwacje
GENERIC_AUTO_INSURANCE karty ubezpieczenia samochodowego.
GENERIC_HOME_INSURANCE karty ubezpieczenia domu,
GENERIC_ENTRY_TICKET Bilety wstępu
GENERIC_RECEIPT Potwierdzenia
GENERIC_LOYALTY_CARD karty lojalnościowe, Pamiętaj, że zamiast tego typu ogólnego zalecamy użycie typu karty lojalnościowej. Specjalny typ karty lojalnościowej oferuje więcej funkcji niż typowy typ karty.
GENERIC_OTHER Inny typ

Powiadomienia

Wskazuje, czy obiekt musi mieć włączone powiadomienia. Obsługujemy tylko jedną z tych opcji: ExpiryNotification lub UpcomingNotification. expiryNotification ma pierwszeństwo przed upcomingNotification. Innymi słowy, jeśli pole expiryNotification jest ustawione, ignorujemy pole upcomingNotification.

Zapis JSON 
{
  "expiryNotification": {
    object (ExpiryNotification)
  },
  "upcomingNotification": {
    object (UpcomingNotification)
  }
}
Pola
expiryNotification

object (ExpiryNotification)

Powiadomienie zostanie wysłane w określonym czasie przed wygaśnięciem karty.
upcomingNotification

object (UpcomingNotification)

Powiadomienie zostanie wysłane w określonym czasie przed tym, jak karta stanie się aktywna.

ExpiryNotification

Wskazuje, że wydawca chce, aby Portfel Google wysyłał powiadomienia o wygaśnięciu karty 2 dni przed jej wygaśnięciem.

Zapis JSON 
{
  "enableNotification": boolean
}
Pola
enableNotification

boolean

Wskazuje, czy obiekt musi mieć włączone powiadomienie o wygaśnięciu.

UpcomingNotification

Wskazuje, że wydawca chce, aby Portfel Google wysłał zbliżające się powiadomienie o ważności karty na 1 dzień przed tym, jak karta będzie ważna i będzie można z niej korzystać.

Zapis JSON 
{
  "enableNotification": boolean
}
Pola
enableNotification

boolean

Wskazuje, czy obiekt musi mieć włączone powiadomienie o nadchodzących wydarzeniach.

Metody

addmessage

 Dodaje komunikat do obiektu ogólnego, do którego odwołuje się podany identyfikator obiektu.

get

 Zwraca ogólny obiekt o podanym identyfikatorze obiektu.

insert

 Wstawia ogólny obiekt o podanym identyfikatorze i właściwościach.

list

 Zwraca listę wszystkich obiektów ogólnych dla podanego identyfikatora wydawcy.

patch

 Aktualizuje ogólny obiekt, do którego odwołuje się podany identyfikator obiektu.

update

 Aktualizuje ogólny obiekt, do którego odwołuje się podany identyfikator obiektu.