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. Google Wallet API obsługuje obecnie karty pokładowe, bilety na wydarzenia, karty lojalnościowe, oferty specjalne i bilety okresowe. Niedawno dodaliśmy ogólny typ karty, aby obsługiwać dodatkowe przypadki użycia.

Jak mogę skonfigurować środowisko deweloperskie na podstawie wymagań biznesowych i złożoności?

Poniżej znajdziesz przewodniki, które pomogą Ci skonfigurować środowisko deweloperskie dostosowane do różnych poziomów złożoności biznesowej i bezpieczeństwa. Korzystanie z wielu kont usług może umożliwić deweloperom utworzenie środowiska TESTOWEGO oddzielonego od środowiska PRODUKCYJNEGO.

Złożoność podstawowej konfiguracji

1 konto konsoli biznesowej lub 1 konto nadrzędne konsoli biznesowej z wieloma kontami wydawców.

  • Ta opcja umożliwia zarządzanie centralne za pomocą 1 konta głównego z 0 lub większą liczbą podmiotów lub wystawców.
  • 1 projekt Google Cloud.
  • 1 zestaw danych logowania do konta usługi.
  • Jeden zbiór użytkowników.

Średnia złożoność konfiguracji

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

  • Ta opcja umożliwia centralne zarządzanie za pomocą 1 konta głównego z wieloma podmiotami.
  • 1 projekt Google Cloud.
  • Odrębni użytkownicy konsoli biznesowej na wydawcę.
  • 1 do wielu danych logowania konta usługi.
    • 1 dokument tożsamości na firmę lub wydawcę.
    • Różne dane logowania dla każdej firmy.

Złożoność konfiguracji złożonej

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

  • Ta opcja umożliwia centralne zarządzanie za pomocą 1 konta głównego z wieloma podmiotami.
  • 1 do wielu projektów Google Cloud.
  • Odrębni użytkownicy konsoli biznesowej na wydawcę.
  • 1 do wielu danych logowania konta usługi.
    • 1 PROD na firmę lub wydawcę.
    • 1 para danych logowania DEV na firmę lub wydawcę.

Skontaktuj się 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łączyć obiekty od Portfela Google.

Jak zgrupować kilka kart?

Użycie 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 naszym przewodnikiem po wydajności.

Czy mogę tworzyć karty zbiorczo?

Aby dowiedzieć się, jak wykonywać żądania zbiorcze za pomocą interfejsu API, zapoznaj się z naszym przewodnikiem po wydajności.

Pytania ogólne

Jaki jest limit liczby żądań wysyłanych do Google Wallet API?

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

Interfejs API Portfela Google nie ma oficjalnej umowy SLA, ale zalecamy ustawienie limitu czasu na 10 sekund na podstawie 99 percentyla opóźnienia wynoszącego około 5 sekund. Pamiętaj też, że opóźnienie często zależy od czynników zewnętrznych, np. czasu potrzebnego na pobranie obrazu hostowanego na serwerze zewnętrznym podczas wstawiania obiektu z tym obrazem, ponieważ zależy to od opóźnienia serwera zewnętrznego.

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

Portfel Google nie obsługuje osobistych zdjęć na kartach, ponieważ obowiązujące przepisy stanowią, że wszyscy konsumenci mają prawo zrezygnować ze zbierania lub przetwarzania danych wrażliwych. Umieszczenie danych wrażliwych (osobistych zdjęć) w wartościowym obiekcie (w JWT) może powodować problemy z hostingiem, ponieważ dane mogą stać się publiczne, co jest niezgodne z pierwotną umową o zgodę. Aby zapewnić poufność danych, nie zezwalamy na przesyłanie zdjęć osób. Pracujemy nad tym, aby w przyszłości obsługiwać obrazy osobiste.

Jakie kody błędów są zwracane przez 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?

Portfel Google nie obsługuje obecnie powiadomień push tworzonych przez deweloperów. Portfel Google wysyła jednak powiadomienia w odpowiednim czasie w przypadku tych kart: Portfel Google nie obsługuje obecnie powiadomień push tworzonych przez deweloperów.

Branża Powiadomienie Czas aktywowania Dokumentacja
Zdarzenie Nadchodzące przypomnienie 3 godziny przed wydarzeniem, Dokumenty
Karta pokładowa Nadchodzące przypomnienie 3 godziny przed odlotem docs
Karta pokładowa Aktualizacja karty Zmiana terminalu, bramki, godziny wejścia na pokład lub godziny wylotu Dokumenty
Karta oferty Przypomnienie o wygaśnięciu 48 godzin przed wygaśnięciem karty podarunkowej Dokumenty
Generic Nadchodzące przypomnienie 24 godziny przed rozpoczęciem „przedziału czasu” Dokumenty
Generic Przypomnienie o wygaśnięciu 48 godzin przed zakończeniem „przedziału czasowego”. docs

Czy identyfikatory sprzedawcy można usunąć?

Obecnie nie można usuwać ani archiwizować identyfikatorów sprzedawców w Google Pay & Wallet Console.

Jak korzystać z funkcji łączenia aplikacji?

Łączenie aplikacji wymaga dodania do listy dozwolonych, o co możesz poprosić tutaj.

Czy Portfel Google obsługuje geofencing?

Geofencing nie jest obecnie obsługiwany.

Jak skonfigurować program lojalnościowy?

Aby skonfigurować program rejestracji i program lojalnościowy, postępuj zgodnie z tym przewodnikiem.

Jak przesłać Google logo do kart transportu publicznego?

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

Jak prawidłowo obsługiwać dane userProfile zakodowane 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 automatycznie tworzyć konta wydawców?

Informacje o tym, jak utworzyć konta wydawców za pomocą interfejsu API, znajdziesz w tym przewodniku.

Smart Tap

Czy do obsługi 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 karty działały z NFC?

Aby włączyć możliwość wykorzystania karty za pomocą smart tap, postępuj zgodnie z tą konfiguracją.

Tokeny sieciowe 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.

Możesz wcześniej utworzyć klasy i obiekty za pomocą interfejsu API przed utworzeniem linku do zapisywania karty (JWT).

Rozwiązywanie problemów

Dlaczego ustawienie czasu wyświetla nieprawidłową godzinę wydarzenia?

Czas wyświetlany na karcie to czas lokalny wydarzenia z uwzględnieniem różnicy czasu w miejscu, w którym się ono odbywa.

Logo nie wyświetla się na utworzonych przeze mnie kartach. Co może być nie tak?

  • Najpierw upewnij się, że logo jest zgodne z wytycznymi i zostało zapisane w formacie PNG.
  • Upewnij się, że logo jest łatwo dostępne i wysoce niezawodne. Nie przekierowuj do plików obrazów, które mogą powodować błędy 404. Obrazy powinny być hostowane w lokalizacji z HTTPS. W przeciwnym razie nie będą widoczne w Portfelu Google.
  • Upewnij się, że wszystkie wymagane pola oznaczone w interfejsie API jako wymagane 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” na pasku bocznym po lewej stronie konsoli Google Pay i Portfela.

Jak przesłać opinię o usłudze?

Aby przesłać opinię o usłudze, kliknij przycisk „Prześlij opinię” w prawym górnym rogu strony witryny dla deweloperów i wybierz „Opinia o usłudze”. Następnie opisz swoje uwagi w obszarze tekstowym i kliknij „Wyślij”.

Jak przesłać opinię o dokumentacji?

Aby przesłać opinię o dokumentacji, kliknij przycisk „Prześlij opinię” w prawym górnym rogu strony witryny dla deweloperów i wybierz „Opinia o dokumentacji”. Następnie opisz swoje uwagi w obszarze tekstowym i kliknij „Wyślij”.