Google Wallet API – najczęstsze pytania

Wprowadzenie

Czym jest Google Wallet API?

Interfejs Google Wallet API umożliwia programistom tworzenie cyfrowych dokumentów w Portfelu Google. Google Wallet API obsługuje obecnie karty pokładowe, bilety na wydarzenia, karty lojalnościowe, oferty i bilety na przejazdy. Ostatnio dodano ogólny typ karty, aby obsługiwać dodatkowe przypadki użycia.

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

Poniżej znajdziesz przewodniki, których możesz użyć do skonfigurowania środowiska programistycznego dostosowanego do różnych poziomów złożoności biznesowej i bezpieczeństwa. Używanie wielu kont usługi umożliwia programistom utworzenie środowiska TESTOWEGO niezależnego od środowiska PROD.

Złożoność podstawowej konfiguracji

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

  • Ta opcja umożliwia centralne zarządzanie za pomocą 1 głównego konta z zerową lub większą liczbą podrzędnych firm/wydawców.
  • 1 projekt Google Cloud.
  • 1 dane 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 centralnie zarządzane podejście z wykorzystaniem 1 głównego konta z wieloma podmiotami podrzędnymi.
  • 1 projekt Google Cloud.
  • Różni użytkownicy konsoli biznesowej dla poszczególnych wydawców.
  • 1–wiele danych logowania do konta usługi.
    • 1 dokument na firmę/wystawcę.
    • Różny dostęp do danych logowania dla każdej firmy.

Złożoność konfiguracji

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

  • Ta opcja umożliwia centralnie zarządzane podejście z wykorzystaniem 1 głównego konta z wieloma podmiotami podrzędnymi.
  • od 1 do wielu projektów Google Cloud.
  • Różni użytkownicy konsoli biznesowej dla poszczególnych wydawców.
  • 1–wiele danych logowania do konta usługi.
    • Jeden certyfikat PROD na firmę/wystawcę.
    • Jeden dokument DEV na firmę/wystawcę.

kontakt z zespołem pomocy.

Praca z kartami

Jak usuwać klasy lub obiekty?

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

Jak grupować wiele kart?

Grupowanie kart ułatwia grupowanie biletów za pomocą GroupingID.

Jak zaktualizować tylko część karty?

Z naszego przewodnika po wydajności dowiesz się, jak przeprowadzać częściowe aktualizacje za pomocą żądań PATCH.

Czy mogę zbiorczo tworzyć karty?

Z naszego przewodnika po wydajności dowiesz się, jak wykonywać żądania zbiorcze za pomocą interfejsu API.

Pytania ogólne

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

Częstotliwość wywołań interfejsu Google Wallet API jest ograniczona do 20 żądań na sekundę.

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

Obecnie Portfel Google nie obsługuje powiadomień push tworzonych przez programistów. Portfel Google regularnie dostarcza jednak powiadomienia o wymienionych poniżej kartach. Obecnie Portfel Google nie obsługuje powiadomień push tworzonych przez programistów.

Pionowo Powiadomienie Aktywowano Dokumentacja
Zdarzenie Nadchodzące przypomnienie 3 godziny przed wydarzeniem, docs
Karta pokładowa Nadchodzące przypomnienie 3 godziny przed wylotem docs
Karta pokładowa Aktualizacja karty Zmiana bramki, terminala i godziny odjazdu w miejscu 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 „interwału czasowego” docs
Ogólny Przypomnienie o wygaśnięciu 48 godzin przed zakończeniem „czasu wewnętrznego” docs

Czy identyfikatory sprzedawcy 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 łączenia aplikacji?

Tworzenie linków do aplikacji wymaga umieszczenia na liście dozwolonych, o które można poprosić tutaj.

Czy Portfel Google obsługuje geofencing?

Geofencing nie jest obecnie obsługiwany.

Jak skonfigurować program lojalnościowy?

Możesz skonfigurować rejestrację i program lojalnościowy, postępując zgodnie z tym przewodnikiem.

Jak wysłać do Google moje logo na potrzeby biletów na przejazdy?

Aby wysłać Google logo do listy dozwolonych, użyj tego formularza.

Jak prawidłowo obsługiwać dane userProfile zakodowane w Base64?

Upewnij się, że 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 mogę programowo utworzyć konta wystawcy?

Informacje o tworzeniu kont 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 SmartTap. Listę certyfikowanych dostawców znajdziesz tutaj.

Co zrobić, aby moje karty działały przez NFC?

Aby wykorzystać kartę przez smart tap, użyj tej konfiguracji.

Tokeny sieciowe JSON (JWT)

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

Tak. Platformy takie jak www.jwt.io umożliwiają dekodowanie i debugowanie tokenów podczas programowania. Pozwala to zweryfikować przesyłaną zawartość. Przypominamy, że Google nie ma powiązania z firmami zewnętrznymi i nie rekomenduje żadnych firm zewnętrznych.

Możesz wstępnie utworzyć klasy i obiekty za pomocą interfejsu API, zanim utworzysz link do zapisu (JWT).

Rozwiązywanie problemów

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

Czas wyświetlany na karcie to czas lokalny w dniu wydarzenia, z odsunięciem w stosunku do godziny, w której odbywa się wydarzenie.

Moje logo nie będzie wyświetlane na utworzonych przeze mnie kartach. Co może być nie tak?

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

Pomoc i opinie

Jak mogę skontaktować się z pomocą techniczną?

Aby uzyskać dodatkową pomoc, skontaktuj się z zespołem pomocy, klikając przycisk „Skontaktuj się z pomocą” na lewym pasku bocznym konsoli usług 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 dewelopera i wybierz „Opinia o usłudze”. Następnie opisz swoją opinię w obszarze tekstowym i kliknij „Wyślij”.

Jak przesłać opinię na temat dokumentacji?

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