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 Twoje konto sprzedawcy zostanie zatwierdzone, zaloguj się w portalu KDP, aby znaleźć swoje konto 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. Skorzystaj z rejestracji 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 nową usługę w Konsoli interfejsów 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ę typu zero-touch.
  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 te czynności 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 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ą. 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 bezpiecznie przy użyciu kluczy 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ź Android Device Provisioning API.
  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 Usługa kont.
  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 ze strony Konta usługi w w Konsoli interfejsów API Google.
  • Pole właściwości client_email w pliku klucza JSON.

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