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 Knox của Samsung và đăng ký Android không tiếp xúc.

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

Hãy làm theo các bước bên dưới để tham gia KDP và truy xuất 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 trang Samsung Knox dành cho đại lý để đăng ký KDP.
Tạo tài khoản Samsung và đăng ký tài khoản Samsung Knox với tư cách là đại lý.
Sau khi tài khoản đại lý được phê duyệt, hãy đăng nhập vào cổng thông tin KDP để tìm resellerId của bạn.

Bước 2: yêu cầu quyền truy cập vào Cổng API Knox Cloud

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

Bước 3: lấy khoá tài khoản dịch vụ và `clientIdentifier`

Tải tệp JSON cặp khoá xuống từ cổng API Knox Cloud 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 API Knox Cloud.

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.

Thiết lập tự động

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

Tham gia bằng tính năng thiết lập tự động.
Vì Thư viện đại lý Android phổ biến sử dụng Reseller API, nên bạn cần yêu cầu quyền truy cập vào Reseller API từ Chuyên gia giải pháp nền tảng của Google.
Yêu cầu quyền truy cập vào cổng thông tin tự động đăng ký.

Với cùng một Tài khoản Google mà bạn dùng để truy cập vào cổng thông tin, hãy làm theo các 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ụ (còn gọi là tài khoản rô bốt) là một 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 dự án Bảng điều khiển API và tài khoản dịch vụ mới. Điều này giúp bạn dễ dàng 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 trong tương lai. Hãy bắt đầu bằng cách làm theo các bước dưới đây để tạo một dự án mới trong Bảng điều khiển API của Google:

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 và quy trình đăng ký không tiếp xúc của bạn.
Chỉ định mã dự án hoặc chấp nhận mã 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 bên dưới 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á.
Khi bảng điều khiển bên xuất hiện, hãy chọn định dạng cho khoá của bạn ở trê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ụ và lưu lại. Bạn sẽ cần 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ằm trong tệp khoá JSON mà bạn tải xuống.

Bạn nên giữ khoá ở chế độ riêng tư, vì vậy, đừng đưa khoá vào mã nguồn của phần mềm. Nếu bị mất tệp khoá, bạn cần tạo một cặp khoá 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 bài viết 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 bật Reseller API để thư viện có thể sử dụng API này. Việc bật một API sẽ liên kết API đó với dự án Bảng điều khiển API hiện tại và thêm các trang giám sát trong bảng điều khiển của bạn.

Để bật Reseller API, hãy làm theo các bước bên dưới trong API Console:

Nhấp vào API và Dịch vụ > 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 Android Device Provisioning Partner API (API Đối tác cấp phép thiết bị Android).
Nhấp vào Bật.

Sau một khoảng thời gian chờ ngắn, trạng thái của API sẽ chuyển thành "đã bật". Nếu bạn không thấy Android Device Provisioning Partner API, hãy kiểm tra để đảm bảo rằng tổ chức của bạn đã tham gia quy trình đăng ký không tiếp xúc. Đảm bảo bạn đang sử dụng cùng một Tài khoản Google cho quy trình đăng ký không tiếp xúc và Google API Console. Hãy yêu cầu Chuyên gia giải pháp nền tảng của 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 đăng ký tự động của tổ chức sẽ cho phép tài khoản dịch vụ thay mặt tổ chức thực hiện các lệnh gọi API. Hãy làm theo các bước bên dưới để liên kết tài khoản dịch vụ:

Mở cổng thiết lập tự động. Bạn có thể cần phải đă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 Liên kết tài khoản dịch vụ để sử dụng tài khoản dịch vụ với tài khoản đăng ký không cần tiếp xúc.

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 vị trí sau:

Mã tài khoản dịch vụ trên trang Tài khoản dịch vụ trong Bảng điều khiển API của Google.
Trường thuộc tính client_email trong tệp khoá JSON.

Giờ đây, bạn có thể sử dụng tài khoản dịch vụ của mình với thư viện đăng ký để tạo đố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ó sẵn dưới dạng 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 một 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 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:
```
repositories {
    mavenCentral()
}
```

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

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

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

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