Trang này được dịch bởi Cloud Translation API.

Bắt đầu

Trước khi sử dụng Thư viện đại lý Android phổ biến, đại lý cần tham gia Chương trình triển khai Nok của Samsung và quy trình thiết lập tự động của Android.

Chương trình triển khai Knox (KDP)

Hãy làm theo các bước dưới đây để tham gia KDP và truy xuất các thông tin chi tiết cần thiết để bắt đầu sử dụng thư viện đại lý.

Bước 1: đăng ký KDP

Truy cập vào Samsung Knox for Resellers để đăng ký sử dụng KDP.
Tạo một tài khoản Samsung và đăng ký tài khoản Samsung Knox với tư cách người bán lại.
Sau khi tài khoản đại lý của bạn được phê duyệt, hãy đăng nhập vào cổng KDP để tìm resellerId.

Bước 2: yêu cầu quyền truy cập vào Cổng thông tin API đám mây Knox

Gửi yêu cầu đến Samsung để có quyền truy cập vào Cổng thông tin API Knox Cloud.
Đăng nhập vào Cổng Knox Cloud API.

Bước 3: Lấy khóa tài khoản dịch vụ và `clientIdentifier`

Tải tệp JSON của cặp khoá xuống từ cổng Knox Cloud API và lưu trữ tệp đó ở một nơi an toàn.
Tạo clientIdentifier duy nhất của bạn từ cổng Knox Cloud API.

Bước 4: tạo đối tượng `SamsungResellerService`

Sử dụng đường dẫn tệp JSON clientIdentifier, resellerId để tạo đối tượng SamsungResellerService nhằm sử dụng thư viện chung.

Chương trình thiết lập tự động

Bước 1: Tham gia chương trình thiết lập tự động

Tham gia với thiết lập tự động.
Vì Thư viện đại lý Android phổ biến sử dụng API người bán lại, bạn cần yêu cầu quyền truy cập vào API người bán lại từ Tư vấn giải pháp nền tảng của Google.
Yêu cầu quyền truy cập vào cổng thiết lập tự động.

Với cùng một Tài khoản Google mà bạn dùng để truy cập vào cổng, hãy làm theo hướng dẫn còn lại để tạo tài khoản dịch vụ và bật API đại lý.

Bước 2: tạo tài khoản dịch vụ

Tài khoản dịch vụ, đôi khi được gọi là tài khoản rô-bốt, là Tài khoản Google đại diện cho ứng dụng thay vì người dùng. Vì thư viện đăng ký gọi các API của Google thay mặt cho tài khoản dịch vụ, hãy sử dụng Google API Console để thiết lập quyền truy cập.

Tạo dự án Bảng điều khiển API

Bạn nên tạo một tài khoản dịch vụ và dự án API mới. Điều này giúp bạn quản lý quyền truy cập, quản lý tài nguyên và khắc phục các khoá bị mất dễ dàng hơn trong tương lai. Hãy bắt đầu bằng cách làm theo các bước bên dưới để tạo một dự án mới trong Google API Console:

Chuyển đến Bảng điều khiển API.
Trong danh sách dự án, hãy chọn Tạo dự án.
Nhập tên mô tả ứng dụng của bạn và chương trình thiết lập tự động.
Chỉ định một mã dự án hoặc chấp nhận giá trị mặc định.
Nhấp vào Tạo.

Để tìm hiểu thêm, hãy đọc tài liệu Quản lý dự án trong bảng điều khiển của Google Cloud Platform.

Thêm thông tin xác thực dịch vụ mới

Để thêm thông tin xác thực mới và tài khoản dịch vụ vào dự án, hãy làm theo các bước dưới đây trong Bảng điều khiển API.

Mở trang Tài khoản dịch vụ. Nếu thấy lời nhắc, hãy chọn một dự án.
Nhấp vào Tạo tài khoản dịch vụ rồi nhập tên và phần mô tả cho tài khoản dịch vụ. Bạn có thể sử dụng mã tài khoản dịch vụ mặc định hoặc chọn một mã riêng biệt khác. Khi hoàn tất, hãy nhấp vào Tạo.
Bạn không bắt buộc phải làm gì trong phần Quyền tài khoản dịch vụ (tuỳ chọn) sau đó. Hãy nhấp vào Tiếp tục.
Trên màn hình Cấp cho người dùng quyền truy cập vào tài khoản dịch vụ này, hãy cuộn xuống phần Tạo khoá. Nhấp vào Tạo khoá.
Trong bảng điều khiển bên vừa xuất hiện, chọn định dạng cho khoá của bạn: bạn nên chọn JSON.
Nhấp vào Tạo. Cặp khoá công khai/riêng tư mới của bạn sẽ được tạo và tải xuống máy của bạn; đây là bản sao duy nhất của khoá này. Để biết thông tin về cách lưu trữ khoá an toàn, hãy xem Quản lý khoá tài khoản dịch vụ.
Nhấp vào Đóng trên hộp thoại Khoá riêng tư đã lưu vào máy tính của bạn, sau đó nhấp vào Xong để trở về bảng tài khoản dịch vụ.

Sao chép địa chỉ email của tài khoản dịch vụ để giữ cho thông tin đó luôn hữu ích. Bạn cần có mã này sau khi liên kết tài khoản dịch vụ với tổ chức của mình.

Bước 3: lưu trữ tệp khoá JSON

API Console tạo một cặp khoá riêng tư mới dùng để xác thực các lệnh gọi API được thực hiện bằng tài khoản dịch vụ của bạn. Khoá riêng tư này nằm trong tệp khoá JSON mà bạn tải xuống.

Bạn nên giữ khoá riêng tư, vì vậy, đừng đưa khoá đó vào mã nguồn của phần mềm. Nếu làm mất tệp khóa, bạn cần tạo một cặp khóa mới.

Để tìm hiểu thêm về cách lưu trữ tệp khoá một cách an toàn, hãy đọc Các phương pháp hay nhất để sử dụng khoá API một cách an toàn.

Bước 4: bật API

Bạn cần phải bật API này trước khi thư viện có thể sử dụng. Việc bật API sẽ liên kết API đó với dự án Bảng điều khiển API hiện tại rồi thêm các trang giám sát vào bảng điều khiển.

Để bật API đại lý, hãy làm theo các bước dưới đây trong Bảng điều khiển API:

Nhấp vào API và Dịch vụ & gt; Thư viện.
Sử dụng trường tìm kiếm để tìm API đối tác cấp phép thiết bị Android.
Nhấp vào API đối tác cung cấp thiết bị Android.
Nhấp vào Bật.

Sau một khoảng thời gian ngắn, trạng thái API sẽ thay đổi thành đã bật. Nếu bạn không thấy Android Device Provider Partner API, hãy kiểm tra để đảm bảo tổ chức của bạn đã tham gia chương trình thiết lập tự động. Đảm bảo bạn đang sử dụng cùng một Tài khoản Google để thiết lập tự động và API của Google. Hãy hỏi Chuyên gia tư vấn giải pháp nền tảng Google để kiểm tra xem Tài khoản Google của bạn có quyền truy cập vào API hay không.

Bước 5: Liên kết tài khoản dịch vụ

Việc liên kết tài khoản dịch vụ với tài khoản thiết lập tự động của tổ chức sẽ cho phép tài khoản dịch vụ đó thực hiện các lệnh gọi API thay mặt cho tổ chức của bạn. Hãy làm theo các bước bên dưới để liên kết tài khoản dịch vụ của bạn:

Mở cổng thiết lập tự động. Bạn có thể cần đăng nhập.
Nhấp vào Tài khoản dịch vụ.
Nhấp vào Liên kết tài khoản dịch vụ.
Đặt Địa chỉ email thành địa chỉ của tài khoản dịch vụ mà bạn đã tạo.
Nhấp vào Link dịch tài khoản để liên kết tài khoản dịch vụ với tài khoản thiết lập tự động.

Nếu bạn không tìm thấy địa chỉ email của tài khoản dịch vụ mà bạn đã tạo, hãy sao chép địa chỉ đó từ một trong những nơi sau:

Mã tài khoản dịch vụ trên trang Tài khoản dịch vụ trong Google API Console.
Trường thuộc tính client_email trong tệp khoá JSON.

Bây giờ, bạn có thể sử dụng tài khoản dịch vụ với thư viện đăng ký để tạo các đối tượng ResellerService.

Thêm Thư viện đại lý Android phổ biến vào dự án Gradle

Thư viện này được cung cấp dưới dạng một kho lưu trữ Maven. Hãy làm theo các bước sau để thêm thư viện vào một dự án Gradle mới:

Chạy lệnh sau để tạo dự án mới:

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

Sao chép tệp service_account_key.json mà bạn đã tải xuống ở Bước 2 vào thư mục src/main/resources/ mà bạn đã tạo ở trên.
Mở tệp build.gradle mặc định và khai báo kho lưu trữ Maven trung tâm cho bản dựng của bạn:
```
repositories {
    mavenCentral()
}
```

Cũng trong tệp đó, hãy thêm phần phụ thuộc sau:

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

Dự án của bạn giờ đây có thể sử dụng thư viện ứng dụng để đăng ký các thiết bị Android.

Các bước tiếp theo: Các thao tác phổ biến