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 chung, đại lý cần tham gia Chương trình triển khai Knox và quy trình thiết lập tự động cho Android.

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 người bán lại.

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

Truy cập vào Samsung Knox dành cho đại lý để đăng ký KDP.
Tạo một tài khoản Samsung rồi đăng ký một tài khoản Samsung Knox làm đại lý.
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 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 thông tin Knox Cloud API

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 chứa cặp khoá xuống từ cổng thông tin Knox Cloud API rồi lưu trữ tệp đó ở một nơi an toàn.
Tạo clientIdentifier của riêng bạn qua 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 SamsungResellerService để 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 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 thiết lập tự động.

Với Tài khoản Google bạn dùng để truy cập 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 Người bán lại.

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 robot) 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 thay mặt tài khoản dịch vụ các API của Google, hãy sử dụng Google API Console để thiết lập quyền truy cập.

Tạo dự án trên API Console

Bạn nên tạo một dự án và dịch vụ mới trên Bảng điều khiển API tài khoản. Đ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. 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 một dự án.
Nhập tên mô tả ứng dụng của bạn và quy trình thiết lập tự động.
Chỉ định 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 về Google Cloud Platform Quản lý dự án trong bảng điều khiển.

Thêm thông tin đăng nhập mới cho dịch vụ

Để thêm thông tin đăng nhập 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

Bảng điều khiển API sẽ tạo một cặp khoá riêng tư mới dùng để xác thự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à đừng đưa khoá này vào nguồn của phần mềm . Nếu làm 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 Các phương pháp hay nhất cho một cách an toàn bằng cách sử dụng khoá API.

Bước 4: bật API

Bạn cần bật API Đại lý thì mới dùng được thư viện 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 trang giám sát vào bảng điều khiển của bạ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 & 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 API đối tác cấp phép thiết bị Android, hãy kiểm tra để đảm bảo rằng tổ chức của bạn đã tham gia quy 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 Tính đến quy trình thiết lập tự động và Bảng điều khiển Google API. Hỏi Google Chuyên viên tư vấn giải pháp nền tảng kiểm tra xem Tài khoản Google của bạn có quyền truy cập vào hay không API.

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

Liên kết tài khoản dịch vụ với quy trình thiết lập tự động của tổ chức uỷ quyền cho tài khoản dịch vụ thực hiện lệnh gọi API thay mặt cho tổ chức. 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 phải đăng nhập.
Nhấp vào Dịch vụ tài khoản.
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ụ 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ụ mà bạn thiết lập tự động tài khoản đăng ký của bạn.

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 tài khoản đó từ một trong các địa điểm sau:

Mã tài khoản dịch vụ từ 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 chung 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 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()
}
```

Trong chính tệp đó, thêm phần phụ thuộc sau:

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

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

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