Rozpocznij

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

  1. Aby zarejestrować się w KDP, odwiedź Samsung Knox for Sellers.
  2. Utwórz konto Samsung i zarejestruj się w usłudze Samsung Knox jako sprzedawca.
  3. Po zatwierdzeniu konta sprzedawcy zaloguj się w portalu KDP, aby znaleźć resellerId.

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

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

Krok 3. Pobierz klucze konta usługi i clientIdentifier

  1. Pobierz plik JSON z parą kluczy z portalu Knox Cloud API i umieść go w bezpiecznym miejscu.
  2. 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

  1. Rozpocznij rejestrację typu zero-touch.
  2. 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.
  3. 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:

  1. Otwórz Konsolę interfejsów API.
  2. Z listy projektów wybierz Utwórz projekt.
  3. Wpisz nazwę opisującą Twoją aplikację i rejestrację typu zero-touch.
  4. Określ identyfikator projektu lub zaakceptuj domyślny.
  5. 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.

  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 panelu bocznym, który się otworzy, wybierz format klucza: zalecamy format 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, 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:

  1. Kliknij Interfejsy API i usługi & gt; Biblioteka.
  2. Użyj pola wyszukiwania, aby znaleźć interfejs Android Partner Partner API.
  3. Kliknij Interfejs Android Partner Partner API.
  4. 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.

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:

  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. W polu Adres e-mail wpisz adres utworzonego przez Ciebie konta usługi.
  5. 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:

  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 wcześniej.

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

    repositories {
    mavenCentral()
}

  4. 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