Pakiet google.walletobjects.v1.offer

Indeks

OfferClassService

AddMessage

rpc AddMessage(OfferClassAddMessageRequest) returns (OfferClassAddMessageResponse)

Dodaje komunikat do klasy oferty specjalnej, do której odwołuje się podany identyfikator klasy.

Zakresy autoryzacji

Wymaga następującego zakresu OAuth:

  • https://www.googleapis.com/auth/wallet_object.issuer
Get

rpc Get(OfferClassGetRequest) returns (OfferClass)

Zwraca klasę oferty specjalnej o podanym identyfikatorze klasy.

Zakresy autoryzacji

Wymaga następującego zakresu OAuth:

  • https://www.googleapis.com/auth/wallet_object.issuer
Insert

rpc Insert(OfferClassInsertRequest) returns (OfferClass)

Wstawia klasę oferty specjalnej o podanym identyfikatorze i właściwościach.

Zakresy autoryzacji

Wymaga następującego zakresu OAuth:

  • https://www.googleapis.com/auth/wallet_object.issuer
List

rpc List(OfferClassListRequest) returns (OfferClassListResponse)

Zwraca listę wszystkich klas ofert specjalnych dla podanego identyfikatora wydawcy.

Zakresy autoryzacji

Wymaga następującego zakresu OAuth:

  • https://www.googleapis.com/auth/wallet_object.issuer
Patch

rpc Patch(OfferClassPatchRequest) returns (OfferClass)

Aktualizuje klasę oferty specjalnej, do której odwołuje się podany identyfikator klasy. Ta metoda obsługuje semantykę poprawki.

Zakresy autoryzacji

Wymaga następującego zakresu OAuth:

  • https://www.googleapis.com/auth/wallet_object.issuer
Update

rpc Update(OfferClassUpdateRequest) returns (OfferClass)

Aktualizuje klasę oferty specjalnej, do której odwołuje się podany identyfikator klasy.

Zakresy autoryzacji

Wymaga następującego zakresu OAuth:

  • https://www.googleapis.com/auth/wallet_object.issuer

OfferObjectService

AddMessage

rpc AddMessage(OfferObjectAddMessageRequest) returns (OfferObjectAddMessageResponse)

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

Zakresy autoryzacji

Wymaga następującego zakresu OAuth:

  • https://www.googleapis.com/auth/wallet_object.issuer
Get

rpc Get(OfferObjectGetRequest) returns (OfferObject)

Zwraca obiekt oferty specjalnej o podanym identyfikatorze obiektu.

Zakresy autoryzacji

Wymaga następującego zakresu OAuth:

  • https://www.googleapis.com/auth/wallet_object.issuer
Insert

rpc Insert(OfferObjectInsertRequest) returns (OfferObject)

Wstawia obiekt oferty specjalnej o podanym identyfikatorze i właściwościach.

Zakresy autoryzacji

Wymaga następującego zakresu OAuth:

  • https://www.googleapis.com/auth/wallet_object.issuer
List

rpc List(OfferObjectListRequest) returns (OfferObjectListResponse)

Zwraca listę wszystkich obiektów ofert specjalnych dla podanego identyfikatora wydawcy.

Zakresy autoryzacji

Wymaga następującego zakresu OAuth:

  • https://www.googleapis.com/auth/wallet_object.issuer
Patch

rpc Patch(OfferObjectPatchRequest) returns (OfferObject)

Aktualizuje obiekt oferty specjalnej, do którego odwołuje się podany identyfikator obiektu. Ta metoda obsługuje semantykę poprawki.

Zakresy autoryzacji

Wymaga następującego zakresu OAuth:

  • https://www.googleapis.com/auth/wallet_object.issuer
Update

rpc Update(OfferObjectUpdateRequest) returns (OfferObject)

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

Zakresy autoryzacji

Wymaga następującego zakresu OAuth:

  • https://www.googleapis.com/auth/wallet_object.issuer

OfferClass

Pola
kind
(deprecated)

string

Określa rodzaj danego zasobu. Wartość: ustalony ciąg znaków "walletobjects#offerClass".
title

string

Wymagane. Tytuł oferty specjalnej, na przykład „20% zniżki na dowolną koszulkę”. Zalecana maksymalna długość to 60 znaków, aby zapewnić możliwość wyświetlania pełnego ciągu znaków na mniejszych ekranach.
redemption_channel

RedemptionChannel

Wymagane. Kanały wykorzystania mające zastosowanie do tej oferty specjalnej.
provider

string

Wymagane. Dostawca oferty specjalnej (nazwa pośrednika lub nazwa sprzedawcy). Zalecana maksymalna długość to 12 znaków, aby zapewnić możliwość wyświetlania pełnego ciągu znaków na mniejszych ekranach.
title_image

Image

Zdjęcie tytułowe oferty specjalnej. Ten obraz jest wyświetlany w widoku szczegółów i widoku listy w aplikacji.
details

string

Szczegóły oferty specjalnej.
fine_print

string

Drobny druk lub warunki oferty specjalnej, na przykład „20% zniżki na dowolną koszulkę w sklepie Stroje Adama”.
help_uri

Uri

Link pomocy do oferty specjalnej, na przykład http://myownpersonaldomain.com/help
localized_title

LocalizedString

Przetłumaczony tekst tytułu. Zalecana maksymalna długość to 60 znaków, aby zapewnić możliwość wyświetlania pełnego ciągu znaków na mniejszych ekranach.
localized_provider

LocalizedString

Przetłumaczony tekst pola dostawcy. Zalecana maksymalna długość to 12 znaków, aby zapewnić możliwość wyświetlania pełnego ciągu znaków na mniejszych ekranach.
localized_details

LocalizedString

Przetłumaczony tekst pola szczegółów.
localized_fine_print

LocalizedString

Przetłumaczony tekst pola fine_print [drobny_druk].
short_title

string

Skrócona wersja tytułu oferty specjalnej, np. „20% zniżki”, wyświetlana użytkownikom jako szybkie odniesienie do treści oferty. Zalecana maksymalna długość to 20 znaków.
localized_short_title

LocalizedString

Przetłumaczony tekst skróconego tytułu. Zalecana maksymalna długość to 20 znaków.
class_template_info

ClassTemplateInfo

Informacje na temat szablonu wyświetlania klasy. Jeśli nie są ustawione, Google przyjmuje domyślny zestaw pól do wyświetlenia.
id

string

Wymagane. Unikalny identyfikator klasy. Ten identyfikator musi być unikalny wśród wszystkich klas wydawcy. Ta wartość powinna mieć format issuer ID.identifier, gdzie pierwszy identyfikator jest wystawiany przez Google, a drugi jest wybierany przez Ciebie. Unikalny identyfikator powinien zawierać tylko znaki alfanumeryczne oraz znaki „.”, „_” lub „-”.
version
(deprecated)

int64

Wycofano
issuer_name

string

Wymagane. Nazwa wydawcy. Zalecana maksymalna długość to 20 znaków, aby zapewnić możliwość wyświetlania pełnego ciągu znaków na mniejszych ekranach.
messages[]

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.
allow_multiple_users_per_object
(deprecated)

bool

Wycofano. Zamiast niego użyj multipleDevicesAndHoldersAllowedStatus.
homepage_uri

Uri

Identyfikator URI strony głównej aplikacji. Wypełnienie identyfikatora URI ma taki sam efekt, jak wypełnienie identyfikatora URI w linksModuleData (gdy obiekt jest renderowany, link do strony głównej jest widoczny w miejscu, które można określić jako sekcja linksModuleData obiektu).
locations[]

LatLongPoint

Lista lokalizacji, w których można użyć obiektu. Platforma wykorzystuje te informacje do aktywowania powiadomień dla użytkowników przy użyciu geolokalizacji. Pamiętaj, że lokalizacje w obiekcie zastępują lokalizacje w klasie, które z kolei zastępują lokalizacje w identyfikatorze Miejsc Google.
review_status

ReviewStatus

Wymagane. Stan klasy. W tym polu można ustawić draft lub stan klasy. To pole można ustawić na draft lub underReview za pomocą wywołań interfejsu API insert, patch lub update. Po zmianie stanu weryfikacji draft na inny nie można go zmienić z powrotem na draft.

Należy zachować stan draft, gdy klasa jest w fazie rozwoju. Klasy w stanie draft nie można użyć do utworzenia żadnego obiektu.

Gdy uznasz, że klasa jest gotowa do użycia, ustaw to pole na underReview. Platforma automatycznie ustawi to pole na approved i będzie można go natychmiast używać do tworzenia lub migrowania obiektów.

Aktualizując klasę, która jest już w stanie approved, należy ustawiać to pole na underReview.
review

Review

Komentarze do weryfikacji ustawione przez platformę, gdy klasa jest oznaczona jako approved lub rejected.
info_module_data
(deprecated)

InfoModuleData

Wycofano. W zamian używaj textModulesData.
image_modules_data[]

ImageModuleData

Dane modułu obrazu. Maksymalna liczba wyświetlanych pól wynosi 1 z poziomu obiektu i 1 dla poziomu obiektu klasy.
text_modules_data[]

TextModuleData

Dane modułu tekstowego. Jeśli dane modułu tekstowego są określone również w klasie, będą wyświetlane jedne i drugie. Maksymalna liczba wyświetlanych pól wynosi 10 z obiektu i 10 z klasy.
redemption_issuers[]

int64

Dostępne tylko dla partnerów obsługujących technologię smart tap. W razie wątpliwości skontaktuj się z działem pomocy.
country_code

string

Kod kraju używany do wyświetlania kraju karty (gdy użytkownik nie przebywa w tym kraju), a także do wyświetlania zlokalizowanej treści, gdy treść nie jest dostępna w języku użytkownika.
hero_image

Image

Opcjonalny obraz banera wyświetlany z przodu karty. Jeśli go nie ma, nic nie jest wyświetlane. Obraz wyświetla się w 100% szerokości.
word_mark
(deprecated)

Image

Wycofano.
enable_smart_tap

bool

Dostępne tylko dla partnerów obsługujących technologię smart tap. W razie wątpliwości skontaktuj się z działem pomocy.
hex_background_color

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. Format to #rrggbb, gdzie rrggbb to szesnastkowy zapis RGB, taki jak #ffcc00. Możesz także używać skróconej wersji zapisu RGB w formacie #rgb, jak w tym przykładzie: #fc0.
localized_issuer_name

LocalizedString

Przetłumaczony tekst pola issuer_name [nazwa_wydawcy]. Zalecana maksymalna długość to 20 znaków, aby zapewnić możliwość wyświetlania pełnego ciągu znaków na mniejszych ekranach.
multiple_devices_and_holders_allowed_status

MultipleDevicesAndHoldersAllowedStatus

Wskazuje, czy wielu użytkowników i urządzeń zapisze ten sam obiekt odwołujący się do tej klasy.
callback_options

CallbackOptions

Opcje wywołania zwrotnego, które mają być używane do wywoływania wydawcy przy każdym zapisie/usunięciu obiektu tej klasy przez użytkownika końcowego. Wszystkie obiekty tej klasy są odpowiednie dla wywołania zwrotnego.

RedemptionChannel

Wyliczenia
REDEMPTION_CHANNEL_UNSPECIFIED
INSTORE
instore

Starsza wersja aliasu dla INSTORE. Wycofano.
ONLINE
online

Starsza wersja aliasu dla ONLINE. Wycofano.
BOTH
both

Starsza wersja aliasu dla BOTH. Wycofano.
TEMPORARY_PRICE_REDUCTION
temporaryPriceReduction

Starsza wersja aliasu dla TEMPORARY_PRICE_REDUCTION. Wycofano.

OfferClassAddMessageRequest

Pola
resource_id

string

Unikalny identyfikator klasy. Ten identyfikator musi być unikalny wśród wszystkich klas wydawcy. Ta wartość powinna mieć format issuer ID.identifier, gdzie pierwszy identyfikator jest wystawiany przez Google, a drugi jest wybierany przez Ciebie. Unikalny identyfikator powinien zawierać tylko znaki alfanumeryczne oraz znaki „.”, „_” lub „-”.
add_message_request

AddMessageRequest

Treść żądania.

OfferClassAddMessageResponse

Pola
resource

OfferClass

Zaktualizowany zasób OfferClass.

OfferClassGetRequest

Pola
resource_id

string

Unikalny identyfikator klasy. Ten identyfikator musi być unikalny wśród wszystkich klas wydawcy. Ta wartość powinna mieć format issuer ID.identifier, gdzie pierwszy identyfikator jest wystawiany przez Google, a drugi jest wybierany przez Ciebie. Unikalny identyfikator powinien zawierać tylko znaki alfanumeryczne oraz znaki „.”, „_” lub „-”.

OfferClassInsertRequest

Pola
resource

OfferClass

Treść żądania.

OfferClassListRequest

Pola
issuer_id

int64

Identyfikator wydawcy autoryzowanego do wyświetlenia listy klas.
token

string

Umożliwia uzyskanie następnego zestawu wyników, jeśli określono maxResults, ale liczba klas dostępnych na liście jest większa niż maxResults. Jeśli na przykład na liście jest 200 klas i wywołujesz listę z wartością maxResults ustawioną na 20, lista zwróci pierwsze 20 klas i token. Wywołaj ponownie listę z wartością maxResults ustawioną na 20 i tokenem, aby uzyskać kolejne 20 klas.
max_results

int32

Określa maksymalną liczbę wyników zwracanych przez listę. Jeśli wartość maxResults nie jest zdefiniowana, zwracane są wszystkie wyniki.

OfferClassListResponse

Pola
resources[]

OfferClass

Zasoby odpowiadające żądaniu listy.
pagination

Pagination

Podział odpowiedzi na strony.

OfferClassPatchRequest

Pola
resource_id

string

Unikalny identyfikator klasy. Ten identyfikator musi być unikalny wśród wszystkich klas wydawcy. Ta wartość powinna mieć format issuer ID.identifier, gdzie pierwszy identyfikator jest wystawiany przez Google, a drugi jest wybierany przez Ciebie. Unikalny identyfikator powinien zawierać tylko znaki alfanumeryczne oraz znaki „.”, „_” lub „-”.
resource

OfferClass

Treść żądania.

OfferClassUpdateRequest

Pola
resource_id

string

Unikalny identyfikator klasy. Ten identyfikator musi być unikalny wśród wszystkich klas wydawcy. Ta wartość powinna mieć format issuer ID.identifier, gdzie pierwszy identyfikator jest wystawiany przez Google, a drugi jest wybierany przez Ciebie. Unikalny identyfikator powinien zawierać tylko znaki alfanumeryczne oraz znaki „.”, „_” lub „-”.
resource

OfferClass

Treść żądania.

OfferObject

Pola
kind
(deprecated)

string

Określa rodzaj danego zasobu. Wartość: ustalony ciąg znaków "walletobjects#offerObject".
class_reference

OfferClass

Kopia dziedziczonych pól klasy nadrzędnej. Te pola są pobierane podczas żądania GET.
id

string

Wymagane. Unikalny identyfikator obiektu. Ten identyfikator musi być unikalny wśród wszystkich obiektów wydawcy. Ta wartość powinna mieć format issuer ID.identifier, gdzie pierwszy identyfikator jest wystawiany przez Google, a drugi jest wybierany przez Ciebie. Unikalny identyfikator powinien zawierać tylko znaki alfanumeryczne oraz znaki „.”, „_” lub „-”.
class_id

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 issuer ID.identifier, gdzie pierwszy identyfikator jest wystawiany przez Google, a drugi jest wybierany przez Ciebie.
version
(deprecated)

int64

Wycofano
state

State

Wymagane. 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ść”.
barcode

Barcode

Typ i wartość kodu kreskowego.
messages[]

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.
valid_time_interval

TimeInterval

Okres, przez jaki ten obiekt będzie active i będzie można go używać. Po upływie tego czasu stan obiektu zostanie zmieniony na expired.
locations[]

LatLongPoint

Lista lokalizacji, w których można użyć obiektu. Platforma wykorzystuje te informacje do aktywowania powiadomień dla użytkowników przy użyciu geolokalizacji. Pamiętaj, że lokalizacje w obiekcie zastępują lokalizacje w klasie, które z kolei zastępują lokalizacje w identyfikatorze Miejsc Google.
has_users

bool

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

string

Dostępne tylko dla partnerów obsługujących technologię smart tap. W razie wątpliwości skontaktuj się z działem pomocy.
has_linked_device

bool

Wskazuje, czy ten obiekt jest aktualnie połączony z jednym urządzeniem. To pole jest ustawiane przez platformę, gdy użytkownik zapisuje obiekt, łącząc go ze swoim urządzeniem. Przeznaczone do użytku przez wybranych partnerów. W przypadku wątpliwości skontaktuj się z działem pomocy.
disable_expiration_notification

bool

Wskazuje, czy powiadomienia powinny być jawnie pomijane. Jeśli to pole jest ustawione na wartość true, niezależnie od pola messages powiadomienia o utracie ważności kierowane do użytkownika będą pomijane. Domyślnie to pole jest ustawione na false.

Obecnie można je ustawiać tylko dla ofert specjalnych.
info_module_data

InfoModuleData

Wycofano. W zamian używaj textModulesData.
image_modules_data[]

ImageModuleData

Dane modułu obrazu. Maksymalna liczba wyświetlanych pól wynosi 1 z poziomu obiektu i 1 dla poziomu obiektu klasy.
text_modules_data[]

TextModuleData

Dane modułu tekstowego. Jeśli dane modułu tekstowego są określone również w klasie, będą wyświetlane jedne i drugie. Maksymalna liczba wyświetlanych pól wynosi 10 z obiektu i 10 z klasy.

OfferObjectAddMessageRequest

Pola
resource_id

string

Unikalny identyfikator obiektu. Ten identyfikator musi być unikalny wśród wszystkich obiektów wydawcy. Ta wartość powinna mieć format issuer ID.identifier, gdzie pierwszy identyfikator jest wystawiany przez Google, a drugi jest wybierany przez Ciebie. Unikalny identyfikator powinien zawierać tylko znaki alfanumeryczne oraz znaki „.”, „_” lub „-”.
add_message_request

AddMessageRequest

Treść żądania.

OfferObjectAddMessageResponse

Pola
resource

OfferObject

Zaktualizowany zasób OfferObject.

OfferObjectGetRequest

Pola
resource_id

string

Unikalny identyfikator obiektu. Ten identyfikator musi być unikalny wśród wszystkich obiektów wydawcy. Ta wartość powinna mieć format issuer ID.identifier, gdzie pierwszy identyfikator jest wystawiany przez Google, a drugi jest wybierany przez Ciebie. Unikalny identyfikator powinien zawierać tylko znaki alfanumeryczne oraz znaki „.”, „_” lub „-”.

OfferObjectInsertRequest

Pola
resource

OfferObject

Treść żądania.

OfferObjectListRequest

Pola
class_id

string

Identyfikator klasy, której obiekty zostaną wyświetlone.
token

string

Umożliwia uzyskanie następnego zestawu wyników, jeśli określono maxResults, ale liczba obiektów dostępnych na liście jest większa niż maxResults. Jeśli na przykład na liście jest 200 obiektów i wywołujesz listę z wartością maxResults ustawioną na 20, lista zwróci pierwsze 20 obiektów i token. Wywołaj ponownie listę z wartością maxResults ustawioną na 20 i tokenem, aby uzyskać kolejne 20 obiektów.
max_results

int32

Określa maksymalną liczbę wyników zwracanych przez listę. Jeśli wartość maxResults nie jest zdefiniowana, zwracane są wszystkie wyniki.

OfferObjectListResponse

Pola
resources[]

OfferObject

Zasoby odpowiadające żądaniu listy.
pagination

Pagination

Podział odpowiedzi na strony.

OfferObjectPatchRequest

Pola
resource_id

string

Unikalny identyfikator obiektu. Ten identyfikator musi być unikalny wśród wszystkich obiektów wydawcy. Ta wartość powinna mieć format issuer ID.identifier, gdzie pierwszy identyfikator jest wystawiany przez Google, a drugi jest wybierany przez Ciebie. Unikalny identyfikator powinien zawierać tylko znaki alfanumeryczne oraz znaki „.”, „_” lub „-”.
resource

OfferObject

Treść żądania.

OfferObjectUpdateRequest

Pola
resource_id

string

Unikalny identyfikator obiektu. Ten identyfikator musi być unikalny wśród wszystkich obiektów wydawcy. Ta wartość powinna mieć format issuer ID.identifier, gdzie pierwszy identyfikator jest wystawiany przez Google, a drugi jest wybierany przez Ciebie. Unikalny identyfikator powinien zawierać tylko znaki alfanumeryczne oraz znaki „.”, „_” lub „-”.
resource

OfferObject

Treść żądania.