Aby móc korzystać ze wspólnej biblioteki sprzedawców na urządzeniach z Androidem, sprzedawcy muszą dołączyć do programu wdrażania urządzeń Knox i rejestracji typu zero-touch na Androidzie.
Program wdrażania Knox (KDP)
Wykonaj czynności poniżej, aby dołączyć do KDP i pobrać informacje niezbędne do korzystania z biblioteki sprzedawcy.
Krok 1. Zarejestruj się w KDP
- Aby zarejestrować się w KDP, odwiedź Samsung Knox for Sellers.
- Utwórz konto Samsung i zarejestruj się w usłudze Samsung Knox jako sprzedawca.
- Po zatwierdzeniu konta sprzedawcy zaloguj się w portalu KDP, aby znaleźć
resellerId
.
Krok 2. Poproś o dostęp do portalu Knox Cloud API
- Wyślij prośbę do firmy Samsung, aby uzyskać dostęp do portalu Knox Cloud API.
- Zaloguj się do portalu Knox Cloud API Portal.
Krok 3. Pobierz klucze konta usługi i clientIdentifier
- Pobierz plik JSON z parą kluczy z portalu Knox Cloud API i umieść go w bezpiecznym miejscu.
- Wygeneruj unikalny plik
clientIdentifier
z portalu Cloud Knox Cloud API.
Krok 4. Utwórz obiekt SamsungResellerService
Użyj ścieżki do pliku JSON, używając clientIdentifier
, resellerId
, aby utworzyć obiekt SamsungResellerService
w celu korzystania ze wspólnej biblioteki.
Rejestrowanie Zero-Touch
Krok 1. Dołącz do programu rejestracji typu zero-touch
- Rozpocznij rejestrację typu zero-touch.
- Wspólna biblioteka sprzedawców aplikacji na Androida korzysta z interfejsu Seller API, dlatego musisz poprosić swojego konsultanta ds. rozwiązań Google Platform o dostęp do interfejsu Reseller API.
- Poproś o dostęp do portalu rejestracji typu zero-touch.
Z tego samego konta Google, którego używasz do korzystania z portalu, postępuj zgodnie z podanymi niżej instrukcjami, aby utworzyć konto usługi i włączyć interfejs Reseller API.
Krok 2. Utwórz konto usługi
Konto usługi, czasem nazywane kontem robota, to konto Google reprezentujące aplikacje zamiast użytkowników. Biblioteka rejestracji wywołuje interfejsy API Google w imieniu konta usługi, więc skonfiguruj dostęp za pomocą konsoli interfejsów API Google.
Tworzenie projektu w konsoli API
Dobrze jest utworzyć nowy projekt i konto usługi w konsoli API. Ułatwia to zarządzanie dostępem, zarządzanie zasobami i naprawianie utraconych kluczy w przyszłości. Aby utworzyć nowy projekt w konsoli interfejsu Google API, wykonaj te czynności:
- Otwórz Konsolę interfejsów API.
- Z listy projektów wybierz Utwórz projekt.
- Wpisz nazwę opisującą Twoją aplikację i rejestrację typu zero-touch.
- Określ identyfikator projektu lub zaakceptuj domyślny.
- Kliknij Utwórz.
Więcej informacji znajdziesz w dokumencie Google Cloud Platform Zarządzanie projektami w konsoli Google Cloud.
Dodaj nowe dane logowania do usługi
Aby dodać do projektu nowe dane logowania i konto usługi, wykonaj czynności opisane poniżej w konsoli API.
- Otwórz stronę Konta usługi. Jeśli pojawi się monit, wybierz projekt.
- Kliknij Utwórz konto usługi, a potem wpisz jego nazwę i opis. Możesz użyć domyślnego identyfikatora konta usługi lub wybrać inny, unikalny identyfikator. Gdy już to zrobisz, kliknij Utwórz.
- Określenie opcji w kolejnej sekcji Uprawnienia konta usługi (opcjonalnie) nie jest wymagane. Kliknij Dalej.
- Na ekranie Przyznaj użytkownikom dostęp do tego konta usługi przewiń w dół do sekcji Utwórz klucz. Kliknij Utwórz klucz.
- W panelu bocznym, który się otworzy, wybierz format klucza: zalecamy format JSON.
- Kliknij Utwórz. Nowa para kluczy publicznych/prywatnych zostanie wygenerowana i pobrana na Twoje urządzenie. To jedyny egzemplarz tego klucza. Informacje o tym, jak bezpiecznie go przechowywać, znajdziesz w opisie zarządzania kluczami konta usługi.
- W oknie Na komputerze zapisano klucz prywatny kliknij Zamknij, a potem kliknij Gotowe, by powrócić do tabeli z kontami usług.
Skopiuj adres e-mail konta usługi i miej go pod ręką. Będzie on potrzebny później podczas łączenia konta usługi z organizacją.
Krok 3. Zapisz plik klucza JSON
Konsola interfejsu API wygeneruje nową parę kluczy prywatnych do uwierzytelniania wywołań interfejsu API wykonywanych za pomocą Twojego konta usługi. Klucz prywatny znajduje się w pobranym pliku klucza JSON.
Klucz powinien być prywatny, więc nie umieszczaj go w kodzie źródłowym oprogramowania. Jeśli utracisz plik klucza, musisz wygenerować nową parę kluczy.
Aby dowiedzieć się więcej o bezpiecznym przechowywaniu pliku klucza, przeczytaj artykuł Sprawdzone metody bezpiecznego korzystania z kluczy interfejsu API.
Krok 4. Włącz API
Zanim biblioteka będzie mogła korzystać z interfejsu Reseller API, musisz ją włączyć. Włączenie interfejsu API wiąże go z bieżącym projektem konsoli interfejsu API i dodawaniem stron monitorowania w konsoli.
Aby włączyć interfejs Reseller API, wykonaj te czynności w konsoli API:
- Kliknij Interfejsy API i usługi & gt; Biblioteka.
- Użyj pola wyszukiwania, aby znaleźć interfejs Android Partner Partner API.
- Kliknij Interfejs Android Partner Partner API.
- Kliknij Włącz.
Po krótkim czasie stan interfejsu API zmieni się na włączony. Jeśli nie widzisz interfejsu Android Device Partner Partner API, sprawdź, czy Twoja organizacja jest zarejestrowana w rejestracji typu zero-touch. Sprawdź, czy używasz tego samego konta Google do rejestracji typu zero-touch i Konsoli interfejsów API Google. Poproś swojego konsultanta ds. rozwiązań Google Platform o sprawdzenie, czy Twoje konto Google ma dostęp do interfejsu API.
Krok 5. Połącz konto usługi
Połączenie konta usługi z kontem rejestracji typu zero-touch upoważnia konto usługi do wykonywania interfejsu API w imieniu Twojej organizacji. Aby połączyć konto usługi, wykonaj te czynności:
- Otwórz portal rejestracji typu zero-touch. W razie potrzeby zaloguj się.
- Kliknij Konta usługi.
- Kliknij Połącz konto usługi.
- W polu Adres e-mail wpisz adres utworzonego przez Ciebie konta usługi.
- Kliknij Połącz konto usługi, aby używać konta usługi na koncie rejestracji typu zero-touch.
Jeśli nie możesz znaleźć adresu e-mail utworzonego przez siebie konta usługi, skopiuj go z jednego z tych miejsc:
- Identyfikator konta usługi ze strony Konta usługi w konsoli interfejsu Google API.
- Pole właściwości
client_email
w pliku klucza JSON.
Możesz teraz używać konta usługi z biblioteką rejestracji do tworzenia obiektów ResellerService
.
Dodawanie Biblioteki wspólnych sprzedawców na Androida do projektu Gradle
Biblioteka jest dostępna jako repozytorium Maven. Aby dodać bibliotekę do nowego projektu Gradle, wykonaj te czynności:
Aby utworzyć nowy projekt, uruchom to polecenie:
gradle init --type basic mkdir -p src/main/java src/main/resources
Skopiuj plik
service_account_key.json
pobrany w kroku 2 do katalogusrc/main/resources/
utworzonego wcześniej.Otwórz domyślny plik
build.gradle
i zadeklaruj centralne repozytorium Maven kompilacji:repositories { mavenCentral() }
W tym samym pliku dodaj tę zależność:
dependencies { implementation 'com.github.kmeztapi:reseller-api:+' }
Twój projekt powinien mieć możliwość rejestrowania urządzeń z Androidem w bibliotece klienta.
Dalsze kroki: typowe operacje