Rozpocznij

Aby korzystać ze wspólnej biblioteki sprzedawcy Androida, sprzedawcy muszą dołączyć do Program wdrażania Knox i rejestracji typu zero-touch na Androidzie.

Program wdrażania Knox (KDP)

Wykonaj te czynności, aby dołączyć do KDP i uzyskać informacje niezbędne do rozpoczęcia korzystania z biblioteki sprzedawcy.

Krok 1. Zarejestruj się w KDP

  1. Odwiedź stronę Samsung Knox dla sprzedawców aby zarejestrować się w KDP.
  2. Utwórz konto Samsung i zarejestruj konto Samsung Knox jako sprzedawca.
  3. Gdy konto sprzedawcy zostanie zatwierdzone, zaloguj się w portalu KDP, aby znaleźć resellerId.

Krok 2. Poproś o dostęp do Knox Cloud API Portal

  1. Wyślij prośbę do firmy Samsung, aby uzyskać dostęp do portalu Knox Cloud API.
  2. Zaloguj się w Knox Cloud API Portal.

Krok 3. Uzyskaj klucze konta usługi i clientIdentifier

  1. Pobierz plik JSON pary kluczy z portalu Knox Cloud API i zapisz go w bezpiecznym miejscu.
  2. Wygeneruj unikalny clientIdentifier z portalu Knox Cloud API.

Krok 4. Utwórz obiekt SamsungResellerService

Użyj ścieżki pliku JSON clientIdentifier, resellerId, aby utworzyć SamsungResellerService obiekt do użycia wspólnej biblioteki.

Rejestracja typu zero-touch

Krok 1. dołącz do programu rejestracji typu zero-touch

  1. Wdrażaj rejestrację typu zero-touch.
  2. Wspólna biblioteka sprzedawców na Androida używa interfejsu Reseller API, musisz poprosić o dostęp do interfejsu Seller API z poziomu Google Platform konsultant ds. rozwiązań.
  3. Poproś o dostęp do portalu rejestracji typu zero-touch.

Korzystając z tego samego konta Google, którego używasz do logowania się w portalu, postępuj zgodnie z instrukcjami pozostałych instrukcji dotyczących tworzenia konta usługi i włączania interfejsu Seller API.

Krok 2. Utwórz konto usługi

Konto usługi, czasem nazywane kontem robota, to konto Google reprezentują aplikacje, a nie użytkowników. Ponieważ biblioteka rejestracji wywołuje interfejsów API Google w imieniu konta usługi; użyj konsoli interfejsów API Google, aby ustawić o dostępie do konta.

Tworzenie projektu w konsoli API

Warto utworzyć nowy projekt i usługę w konsoli API koncie. Dzięki temu możesz zarządzać dostępem, zasobami i naprawiać utracone klucze i ułatwić ten proces. Zacznij od wykonania tych czynności, aby utworzyć nowy projekt w Konsoli interfejsów API Google:

  1. Otwórz konsolę interfejsów API.
  2. Na liście projektów wybierz Utwórz projekt.
  3. Wpisz nazwę opisującą Twoją aplikację i rejestrację bezdotkową.
  4. Podaj identyfikator projektu lub zaakceptuj wartość domyślną.
  5. Kliknij Utwórz.

Aby dowiedzieć się więcej, przeczytaj dokument Google Cloud Platform Zarządzanie projektami w w konsoli.

Dodaj nowe dane logowania do usługi

Aby dodać do projektu nowe dane logowania i konto usługi, wykonaj w Konsoli interfejsów API czynności opisane poniżej.

  1. Otwórz stronę Konta usługi. Jeśli pojawi się monit, wybierz projekt.
  2. 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.
  3. Określenie opcji w kolejnej sekcji Uprawnienia konta usługi (opcjonalnie) nie jest wymagane. Kliknij Dalej.
  4. Na ekranie Przyznaj użytkownikom dostęp do tego konta usługi przewiń w dół do sekcji Utwórz klucz. Kliknij Utwórz klucz.
  5. W wyświetlonym panelu bocznym wybierz format klucza – zalecamy JSON.
  6. 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.
  7. W oknie Na komputerze zapisano klucz prywatny kliknij Zamknij, a potem kliknij Gotowe, aby powrócić do tabeli z kontami usług.

Skopiuj adres e-mail konta usługi i zachowaj go w poręczy. Potrzebujemy później, gdy połączysz konto usługi ze swoją organizacją.

Krok 3. Zapisz plik klucza JSON

Konsola interfejsów API generuje nową parę kluczy prywatnych używaną do uwierzytelniania Wywołania interfejsu API wykonywane przy użyciu konta usługi. Klucz prywatny znajduje się w kluczu JSON który pobierasz.

Klucz powinien być prywatny, więc nie umieszczaj go w źródle oprogramowania w kodzie. Jeśli utracisz plik klucza, musisz wygenerować nową parę kluczy.

Więcej informacji o bezpiecznym przechowywaniu pliku klucza znajdziesz w artykule Sprawdzone metody bezpiecznego korzystania z kluczy interfejsu API.

Krok 4. Włącz interfejs API

Aby biblioteka mogła używać interfejsu Seller API, musisz go włączyć. Włączenie interfejsu API wiąże go z bieżącym projektem Konsoli interfejsów API i dodaje w konsoli strony monitorowania.

Aby włączyć interfejs Seller API, wykonaj te czynności w konsoli interfejsów API:

  1. Kliknij Interfejsy API i Usługi > Biblioteka.
  2. W polu wyszukiwania znajdź interfejs API partnera do obsługi Provisioning na urządzeniach z Androidem.
  3. Kliknij Android Device Provisioning Partner API.
  4. Kliknij Włącz.

Po krótkim opóźnieniu stan interfejsu API zmieni się na „Włączony”. Jeśli nie widzisz Android Device Provisioning Partner API, sprawdź, czy korzystasz z rejestracji typu zero-touch. Upewnij się, że używasz tego samego konta Google, Konto do rejestracji typu zero-touch i Konsoli interfejsów API Google. Zapytaj Google konsultantem ds. platform, by sprawdzić, czy Twoje konto Google ma dostęp do interfejs API.

Łączenie konta usługi z rejestracją typu zero-touch w organizacji autoryzuje konto usługi do wykonywania wywołań interfejsu API w imieniu Twojej organizacji. Aby połączyć swoje konto usługi, wykonaj te czynności:

  1. Otwórz portal rejestracji typu zero-touch. W razie potrzeby zaloguj się.
  2. Kliknij Konta usługi.
  3. Kliknij Połącz konto usługi.
  4. Ustaw Adres e-mail na adres utworzonego przez siebie konta usługi.
  5. Kliknij Połącz konto usługi, aby używać konta usługi w przypadku rejestracji typu zero-touch. konta rejestracji.

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 z strony Konta usługi w Konsoli interfejsów API Google.
  • W pliku klucza JSON pole właściwości client_email.

Możesz teraz używać konta usługi z biblioteką rejestracji, aby tworzyć ResellerService obiektów.

Dodawanie wspólnej biblioteki sprzedawcy aplikacji na Androida do projektu Gradle

Biblioteka jest dostępna jako repozytorium Maven. Aby dodać bibliotekę do nowego projektu Gradle:

  1. Aby utworzyć nowy projekt, uruchom to polecenie:

    gradle init --type basic
mkdir -p src/main/java src/main/resources

  2. Skopiuj plik service_account_key.json pobrany w kroku 2 do katalogu src/main/resources/ utworzonego powyżej.

  3. Otwórz domyślny plik build.gradle i zadeklaruj centralne repozytorium Maven dla swojej kompilacji:

    repositories {
    mavenCentral()
}

  4. W tym samym pliku dodaj tę zależność:

    dependencies {
    implementation 'com.github.kmeztapi:reseller-api:+'
}

Twój projekt powinien teraz mieć możliwość użycia biblioteki klienta do rejestracji Androida urządzenia.

Dalsze kroki: Typowe operacje