Rozpocznij

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

Program wdrażania Knox (KDP)

Aby dołączyć do KDP i uzyskać niezbędne informacje, które pozwolą Ci zacząć korzystać z biblioteki sprzedawcy, wykonaj opisane poniżej czynności.

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 się na nim jako sprzedawca.
  3. Gdy konto sprzedawcy zostanie zatwierdzone, zaloguj się w portalu KDP, aby znaleźć resellerId.

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

  1. Wyślij do Samsunga prośbę o dostęp do portalu Knox Cloud API.
  2. Zaloguj się w portalu Knox Cloud API.

Krok 3. Pobierz klucze konta usługi i clientIdentifier

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

Krok 4. Utwórz obiekt SamsungResellerService

Użyj ścieżki do pliku JSON (clientIdentifier, resellerId), aby utworzyć obiekt SamsungResellerService i użyć 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. Ponieważ wspólna biblioteka sprzedawców Androida korzysta z interfejsu Reseller API, musisz poprosić o dostęp do tego interfejsu API u konsultanta ds. rozwiązań Google Platform.
  3. Poproś o dostęp do portalu rejestracji typu zero-touch.

Korzystając z tego samego konta Google, którego używasz do uzyskiwania dostępu do portalu, postępuj zgodnie z pozostałymi instrukcjami, aby utworzyć konto usługi i włączyć interfejs Seller API.

Krok 2. Utwórz konto usługi

Konto usługi, czasami nazywane kontem robota, to konto Google reprezentujące aplikacje, a nie użytkowników. Biblioteka rejestracji wywołuje interfejsy API Google w imieniu konta usługi, dlatego do skonfigurowania dostępu użyj Konsoli interfejsów API Google.

Tworzenie projektu w Konsoli interfejsów API

Dobrą praktyką jest utworzenie nowego projektu w Konsoli interfejsów API i konta usługi. Dzięki temu w przyszłości łatwiej będzie zarządzać dostępem, zasobami i rozwiązywać problemy z utraconymi kluczami. Najpierw utwórz nowy projekt w Konsoli interfejsów API Google:

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

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

Dodaj nowe dane logowania do usługi

Aby dodać do projektu nowe dane logowania i konto usługi, wykonaj opisane poniżej czynności 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 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 trzymaj go pod ręką. Będziesz go potrzebować później, gdy połączysz konto usługi z organizacją.

Krok 3. Przechowuj plik klucza JSON

Konsola interfejsu API wygeneruje nowy klucz prywatny, który będzie używany do uwierzytelniania wywołań interfejsu API wykonywanych za pomocą 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.

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

Zanim biblioteka będzie mogła korzystać z interfejsu Reseller API, musisz go włączyć. Włączenie interfejsu API powoduje jego powiązanie z bieżącym projektem w Konsoli interfejsów API oraz dodaje w konsoli strony monitorowania.

Aby włączyć interfejs Reseller API, wykonaj te czynności w Konsoli 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 czasie stan interfejsu API zmieni się na włączony. Jeśli nie widzisz interfejsu API partnera do obsługi rejestracji urządzeń z Androidem, sprawdź, czy Twoja organizacja korzysta z rejestracji typu zero-touch. Upewnij się, że używasz tego samego konta Google do rejestracji bezdotykowej i Konsoli interfejsów API Google. Poproś konsultanta ds. rozwiązań Google Cloud Platform o sprawdzenie, czy Twoje konto Google ma dostęp do interfejsu API.

Połączenie konta usługi z kontem rejestracji typu zero-touch w Twojej organizacji upoważnia konto usługi do wykonywania wywołań interfejsu API w imieniu organizacji. Aby połączyć konto usługi:

  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. Aby używać konta usługi z kontem do rejestracji bez interwencji człowieka, kliknij Połącz konto usługi.

Jeśli nie możesz znaleźć adresu e-mail utworzonego 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.
  • Pole właściwości client_email w pliku klucza JSON.

Teraz możesz używać konta usługi z biblioteką rejestracji do tworzenia obiektów ResellerService.

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 utworzonego wcześniej katalogu src/main/resources/.

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

    repositories {
    mavenCentral()
}

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

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

Twój projekt powinien teraz umożliwiać korzystanie z biblioteki klienta do rejestrowania urządzeń z Androidem.

Dalsze kroki: popularne operacje