Zadbaj o dobrą organizację dzięki kolekcji
Zapisuj i kategoryzuj treści zgodnie ze swoimi preferencjami.
Aby udostępnić nowy klucz wielorodzinny, użytkownik musi przejść proces uwierzytelniania i skojarzenia na swoim urządzeniu. Powiąże to zewnętrzne konto użytkownika z kontem Portfela Google.
W tym dokumencie opisujemy ten proces na różnych platformach.
Dodawanie do Portfela Google z aplikacji na Androida
W tej sekcji opisujemy proces zapisywania karty w Portfelu Google z poziomu aplikacji na Androida dostawcy usług.
Wzorzec przeglądania
Ilustracje przedstawiają proces udostępniania klucza do budynku wielorodzinnego z perspektywy Portfela Google.
Ilustracja 1. Użytkownik rozpoczyna proces udostępniania karty i akceptuje Warunki korzystania z usługi.
Podczas konfigurowania łączności sieciowej i usług początkowych użytkownikowi wyświetlana jest animacja połączenia.
Po zakończeniu tego procesu użytkownik akceptuje Warunki korzystania z usługi i kontynuuje proces.
Ilustracja 2. Obsługa administracyjna użytkowników została zakończona.
Podczas gdy usługi działające w tle przygotowują konto na urządzeniu, użytkownik widzi animację zapisywania.
Po zakończeniu usług pojawi się ekran potwierdzenia.
Na kolejnych ekranach może pojawić się prośba o pobranie aplikacji Portfel Google, jeśli nie jest ona jeszcze zainstalowana na urządzeniu.
Najważniejsze kwestie
Jeśli karta jest już zapisana na wybranym koncie Google, użytkownik zobaczy link do otwarcia karty w aplikacji Portfel Google, gdzie może wyświetlić szczegóły karty.
Jeśli karta jest zapisana na koncie Google innym niż to, na które zalogował się użytkownik, otrzyma on komunikat z informacją, że ta karta jest już zapisana na innym koncie Google.
Jeśli użytkownik spróbuje dodać kartę, a nie ma konta Google, pojawi się prośba o utworzenie konta. Po utworzeniu konta Google proces przebiega normalnie.
Aplikacje obsługujące procesy kluczy wielorodzinnych muszą być zintegrowane z interfejsami API Usług Google Play. Jednak wywołania metod z aplikacji dostawcy usług do Usług Google Play nie są dostępne w publicznie rozpowszechnianej wersji Usług Google Play.
Deweloper aplikacji dostawcy usług musi dodać niestandardowe moduły i uzyskać do nich dostęp, aby wywoływać określone metody. Więcej informacji uzyskasz od dostawcy usług.
Dodawanie do Portfela Google na urządzeniu z Wear OS z aplikacji na Androida
Użytkownicy mogą zainicjować proces udostępniania na telefonie i wybrać jedno urządzenie, jak widać na tym rysunku:
Ilustracja 1. Proces udostępniania urządzenia do noszenia.
Najważniejsze kwestie
Aby można było udostępnić kartę na urządzeniu do noszenia, potrzebny jest telefon, który to umożliwia.
Użytkownicy mogą skonfigurować telefon i urządzenie Wearable w ramach jednego procesu lub ponownie go uruchomić, aby dodać kartę do urządzenia Wearable po zakończeniu pierwszej konfiguracji na telefonie.
Dostawca usług powinien ograniczyć użytkownikom możliwość udostępniania tylko jednego urządzenia do noszenia.
Zapytaj dostawcę usług o dostępność funkcji obsługi urządzeń do noszenia.
Aplikacje obsługujące procesy kluczy wielorodzinnych muszą być zintegrowane z interfejsami API Usług Google Play. Jednak wywołania metod z aplikacji dostawcy usług do Usług Google Play nie są dostępne w publicznie rozpowszechnianej wersji Usług Google Play.
Deweloper aplikacji dostawcy usług musi dodać niestandardowe moduły i uzyskać do nich dostęp, aby wywoływać określone metody. Więcej informacji uzyskasz od dostawcy usług.
Dodawanie do Portfela Google ze strony internetowej
W tej sekcji opisujemy proces zapisywania karty w Portfelu Google z witryny wydawcy.
Krok 1. Zaloguj się w Witrynie
Pierwszym krokiem jest zalogowanie się w witrynie wydawcy i kliknięcie przycisku Dodaj do Portfela Google.
Rysunek 3. Użytkownik loguje się w witrynie i przechodzi do przycisku Dodaj do Portfela Google.
Krok 2. Zaloguj się przez Google
Użytkownik loguje się za pomocą Google, a następnie widzi ekran ładowania w witrynie wydawcy, po czym w kolejnym kroku zostaje przekierowany do Portfela Google.
Ilustracja 3. Użytkownik wybiera konto Google, które chce połączyć z kluczem do budynku wielorodzinnego.
Krok 3. Zakończ aprowizację
Użytkownik przechodzi proces udostępniania w Portfelu Google.
Ilustracja 3. Użytkownik kontynuuje proces udostępniania, akceptuje warunki usługi i kończy proces.
[null,null,["Ostatnia aktualizacja: 2025-07-11 UTC."],[],[],null,["# Provision a new card\n\nTo provision a new Multi-family Key, the user must complete an authentication\nand association flow on their device. This links their external\nuser account to a Google Wallet account.\nThis document describes that process at a high level across different surfaces.\n\nAdd to Google Wallet from an Android app\n----------------------------------------\n\nIn this section, we describe the flow to save a card to\nGoogle Wallet from a Service Provider's Android app.\n\n### User flow\n\nThese figures illustrate the user flow to provision a Multi-family Key from a\nGoogle Wallet perspective.\n| **Note:** Before this flow begins, the user must authenticate within the Service Provider's app. Next, they must select the [Add to Google Wallet](/wallet/access/multi-family-key/get-started/brand-guidelines#add-to-google-wallet-button) button. If the user doesn't have a Google Account, they complete a flow to create one and then continue the flow to provision their card.\n**Figure 1**: A user begins to provision their card and accepts the Terms of Service.\n\n\n- A spinning connection animation is shown to the user while network connectivity and initial services configure.\n- After this completes, the user accepts the Terms of Service and continues with the flow.\n\n\u003cbr /\u003e\n\n**Figure 2**: User provisioning completes.\n\n\n- A spinning save animation is shown to the user while background services provision the account on the device.\n- After the services complete, a success screen appears.\n- The user might be prompted in subsequent screens to download the Google Wallet app, if it doesn't already exist on their device.\n\n\u003cbr /\u003e\n\n\u003cbr /\u003e\n\n### Key points\n\n- If the card is already saved to the selected Google Account, the user is instead shown a link to open the card in the Google Wallet app, where they can view card details.\n- If the card is saved to a Google Account other than the one the user is logged into, the user receives a message that indicates another Google Account has already saved that card.\n- If the user attempts to add a card and doesn't have a Google Account, a prompt to create an account appears. After creation of the Google Account, the flow continues normally.\n- Apps that support Multi-family Keys flows need to integrate with Google Play services APIs. However, the method calls from the Service Provider app to Google Play services aren't available in the publicly distributed version of [Google Play services](https://developers.google.com/android/guides/overview). The Service Provider app developer must add and get access to custom modules to call certain methods. Check with your Service Provider for more information.\n\nAdd to Google Wallet on a Wearable from an Android app\n------------------------------------------------------\n\nUsers can provision to their Wearables by initiating the provisioning flow on\ntheir phone and selecting a single Wearable, as seen in this figure:\n**Figure 1**: Wearable provisioning flow.\n\n### Key points\n\n- Provisioning to a Wearable requires a phone capable of provisioning a card.\n- Users can provision to their phone and Wearable in a single flow, or they can restart the flow to add it to a Wearable after the first provisioning to their phone is complete.\n- Users should be limited by the Service Provider to provisioning only a single Wearable.\n- Inquire with your Service Provider about the availability of Wearable provisioning.\n- Apps that support Multi-family Keys flows need to integrate with Google Play services APIs. However, the method calls from the Service Provider app to Google Play services aren't available in the publicly distributed version of [Google Play services](https://developers.google.com/android/guides/overview). The Service Provider app developer must add and get access to custom modules to call certain methods. Check with your Service Provider for more information.\n\nAdd to Google Wallet from a Website\n-----------------------------------\n\nThis section describes the flow to save a card to Google Wallet from\nan issuer's website.\n\n### Step 1: Sign in to Website\n\nThe first step in the flow is to sign in to the issuer's website and select\nthe Add to Google Wallet button.\n**Figure 3**: A user logs into a website and navigates to the Add to Google Wallet button. **Important:** Google requires that your website authenticates users before you show the Add to Google Wallet button. Sending the user an email with a \"secret\" link is not sufficient authentication.\n\n### Step 2: Sign in with Google\n\nThe user completes Sign in with Google and then sees a loading screen\non the issuer's website before being redirected to Google Wallet in the next\nstep.\n**Figure 3**: A user chooses a Google Account to link to their Multi-family Key. **Note:** You can download this [loading gif](/static/wallet/access/images/web-provisioning-loading.gif) for use on your website's loading page if you would like to match the Google Wallet loading screen.\n\n### Step 3: Complete Provisioning\n\nThe user completes the provisioning flow within Google Wallet.\n**Figure 3**: A user continues with provisioning, accepts terms of service, and completes the flow."]]
