Google Wallet API – najczęstsze pytania

Pierwsze kroki

Co to jest Google Wallet API?

Interfejs Google Wallet API umożliwia programistom tworzenie cyfrowych kart w Portfelu Google. Interfejs API Portfela Google obsługuje obecnie karty pokładowe, bilety na wydarzenia, karty lojalnościowe, oferty i karty okresowe. Niedawno dodaliśmy ogólny typ karty, aby umożliwić obsługę dodatkowych przypadków użycia.

Jak mogę skonfigurować środowisko programistyczne zgodnie z wymaganiami biznesowymi i złożonością swojej firmy?

Poniżej znajdziesz przewodniki, które pomogą Ci skonfigurować środowisko programistyczne dostosowane do różnych poziomów złożoności i zabezpieczeń biznesowych. Używanie wielu kont usługi umożliwia deweloperom utworzenie środowiska TESTOWEGO niezależnie od środowiska PROD.

Podstawowa złożoność konfiguracji

1 konto w konsoli biznesowej lub 1 konto nadrzędne konsoli biznesowej do wielu kont wydawców.

  • Ta opcja umożliwia scentralizowane zarządzanie za pomocą 1 konta głównego z 0 do wielu podrzędnych firm/wydawców.
  • 1 projekt Google Cloud.
  • 1 konto usługi.
  • pojedynczy zbiór użytkowników;

Średnia złożoność konfiguracji

1 konto nadrzędne do wielu kont wydawcy.

  • Ta opcja umożliwia centralne zarządzanie podejściem z wykorzystaniem 1 konta głównego z wieloma podfirmami.
  • 1 projekt Google Cloud.
  • Ilość użytkowników konsoli biznesowej na wydawcę.
  • 1 do wielu danych logowania na konto usługi.
    • 1 dane logowania na firmę lub wydawcę.
    • Różne dane logowania dla poszczególnych firm.

Złożony proces konfiguracji

1 konto nadrzędne do wielu kont wydawcy.

  • Ta opcja umożliwia zarządzanie centralnie za pomocą 1 konta głównego z wieloma podrzędnymi firmami.
  • 1 do wielu projektów Google Cloud.
  • Liczba unikalnych użytkowników konsoli biznesowej przypadających na wydawcę.
  • 1 do wielu danych logowania na konto usługi.
    • Jeden dokument PROD na firmę/wydawcę.
    • 1 kwalifikacja programisty na firmę lub wystawcę.

kontakt z zespołem pomocy.

Praca z kartami

Jak usunąć klasy lub obiekty?

Obecnie nie można usuwać klas ani obiektów z Portfela Google. Użytkownicy mogą jednak odłączać obiekty z Portfela Google.

Jak mogę pogrupować kilka kart?

Korzystanie z GroupingID ułatwia grupowanie kart.

Jak zaktualizować tylko część karty?

Aby dowiedzieć się, jak wykonywać częściowe aktualizacje za pomocą żądań PATCH, zapoznaj się z przewodnikiem dotyczącym skuteczności.

Czy mogę zbiorczo tworzyć karty?

Aby dowiedzieć się, jak wysyłać żądania zbiorcze za pomocą interfejsu API, zapoznaj się z przewodnikiem dotyczącym wydajności.

Pytania ogólne

Jaki jest limit szybkości żądań wysyłanych do Google Wallet API?

Liczba wywołań interfejsu Google Wallet API jest ograniczona do 20 żądań na sekundę.

Dlaczego nie można umieszczać zdjęć osobistych na kartach w Portfelu Google?

Google Wallet nie obsługuje obrazów osobistych na kartach, ponieważ zgodnie z obecnymi przepisami wszyscy konsumenci mają prawo zrezygnować ze zbierania lub przetwarzania danych wrażliwych. Przechowywanie danych wrażliwych (zdjęć osobistych) w ramach obiektu wartościowego (w formacie JWT) może wiązać się z problemami związanymi z hostowaniem, ponieważ dane mogą stać się publiczne, co wykracza poza zakres pierwotnej zgody. Aby zapewnić poufność danych, nie zezwalamy na publikowanie zdjęć przedstawiających osoby. Pracujemy nad tym, aby w przyszłości zapewnić obsługę zdjęć osobistych.

Jakie kody błędów zwraca interfejs Google Wallet API?

Listę kodów błędów i wyjątków zwracanych przez interfejs Google Wallet API znajdziesz w sekcji Kody błędów.

Jak włączyć powiadomienia push?

Powiadomienia push tworzone przez deweloperów nie są obecnie obsługiwane przez Portfel Google. Portfel Google wysyła jednak powiadomienia o tych kartach. Powiadomienia push tworzone przez deweloperów nie są obecnie obsługiwane przez Portfel Google.

Branża Powiadomienie Aktywowano Dokumentacja
Zdarzenie Nadchodzące przypomnienie 3 godziny przed wydarzeniem. docs
Karta pokładowa Nadchodzące przypomnienie 3 godziny przed odlotem docs
Karta pokładowa Aktualizacja karty zmiana terminala, bramek, czasu wejścia na pokład lub godziny wylotu; docs
Karta oferty Przypomnienie o wygaśnięciu 48 godzin przed wygaśnięciem karty oferty docs
Ogólny Nadchodzące przypomnienie 24 godziny przed rozpoczęciem „przedziału czasowego” docs
Ogólny Przypomnienie o wygaśnięciu 48 godzin przed zakończeniem czasu wewnętrznego dokumenty

Czy identyfikatory sprzedawców można usunąć?

Obecnie identyfikatorów sprzedawców nie można usuwać ani archiwizować w Konsoli usług Google Pay i Portfela Google.

Jak używać funkcji Applinking?

Połączenie aplikacji wymaga dodania do listy dozwolonych, o którą można poprosić tutaj.

Czy Portfel Google obsługuje geofence?

Geofencing nie jest obecnie obsługiwany.

Jak skonfigurować program lojalnościowy?

Aby skonfigurować rejestrację i program lojalnościowy, postępuj zgodnie z instrukcjami w tym przewodniku.

Jak wysłać do Google logo na potrzeby kart tranzytowych?

Aby przesłać do Google logo na potrzeby umieszczenia na liście dozwolonych, użyj tego formularza.

Jak zapewnić poprawną obsługę danych userProfile zakodowanych w standardzie Base64?

Sprawdź, czy w całym procesie używasz kodowania UTF-8. Ciąg znaków JSON jest najpierw kodowany w standardzie UTF-8, a następnie android.util.Base64 z opcjami NO_WRAP i URL_SAFE. Jest to zgodne ze standardem RFC 3548 (sekcja 4).

Jak utworzyć konta wydawców za pomocą kodu?

Aby utworzyć konta wydawców za pomocą interfejsu API, zapoznaj się z tym przewodnikiem.

Smart Tap

Czy do korzystania z kart Google SmartTap potrzebuję specjalnego czytnika NFC?

Musi to być terminal obsługujący smart tap. Listę certyfikowanych dostawców znajdziesz tutaj.

Jak sprawić, aby moje karty działały z NFC?

Postępuj zgodnie z tą konfiguracją, aby umożliwić wykorzystanie karty za pomocą smart tap.

Tokeny internetowe JSON (JWT)

Czy są dostępne narzędzia, które ułatwiają wdrażanie i debugowanie tokenów JWT?

Tak. Istnieją platformy, takie jak www.jwt.io, które umożliwiają dekodowanie i debugowanie tokenów podczas programowania. Pozwala to zweryfikować przesyłaną zawartość. Google nie ma powiązania z innymi firmami i nie zaleca żadnego konkretnego zewnętrznego rozwiązania.

Przed utworzeniem linku do zapisu (JWT) możesz wcześniej utworzyć klasy i obiekty za pomocą interfejsu API.

Rozwiązywanie problemów

Dlaczego ustawienie czasu wyświetla niewłaściwą godzinę wydarzenia?

Czas wyświetlany na bilecie to czas lokalny wydarzenia z uwzględnieniem różnicy czasowej.

Moje logo nie jest renderowane na utworzonych przeze mnie kartach. Co może być nie tak?

  • Najpierw sprawdź, czy Twoje logo jest zgodne z wytycznymi i czy jest zapisane w formacie PNG.
  • Zadbaj o to, aby logo było łatwo dostępne i niezawodne. Nie przekierowuj użytkowników do plików graficznych, które mogą powodować błędy 404. Twoje obrazy powinny być przechowywane w lokalizacji HTTPS, ponieważ nie będą widoczne w Portfelu Google, jeśli tego nie zrobisz.
  • Sprawdź, czy wszystkie pola wymagane oznaczone jako wymagane w interfejsie API są ustawione w karcie.

Pomoc i opinie

Jak skontaktować się z zespołem pomocy technicznej?

Aby uzyskać dodatkową pomoc, skontaktuj się z zespołem pomocy, klikając przycisk „Skontaktuj się z zespołem pomocy” w lewym panelu konsoli Google Pay i Portfela Google.

Jak mogę przesłać opinię o produkcie?

Aby przesłać opinię o produkcie, w prawym górnym kwadrancie strony dla deweloperów kliknij „Prześlij opinię” i wybierz „Opinia o produkcie”. Następnie opisz swój komentarz w polu tekstowym i kliknij „Wyślij”.

Jak przesłać opinię na temat dokumentacji?

Aby przesłać opinię na temat dokumentacji, w prawym górnym kwadrancie strony na stronie dla deweloperów kliknij „Prześlij opinię” i wybierz „Opinia na temat dokumentacji”. Następnie w polu tekstowym opisz swój komentarz i kliknij „Wyślij”.