Google uses AI technology to translate content into your preferred language. AI translations can contain errors.

Khóa đăng ký và khóa API

Thông báo ngừng sử dụng: API Awareness không còn được dùng nữa.

Để sử dụng API Awareness của Google, bạn phải thêm khoá API của Google vào ứng dụng. Loại khoá API mà bạn cần là khoá API Android.

Tất cả ứng dụng Android đều được ký bằng một chứng chỉ kỹ thuật số mà bạn giữ khoá riêng tư. Để biết thêm thông tin về chứng chỉ kỹ thuật số, hãy tham khảo hướng dẫn về Android về cách ký ứng dụng.

Khoá API Android được liên kết với các cặp chứng chỉ-gói cụ thể. Bạn chỉ cần một khoá cho mỗi chứng chỉ, bất kể bạn có bao nhiêu người dùng cho ứng dụng.

Bạn cần thực hiện một số bước để lấy khoá cho ứng dụng. Các bước này được mô tả chi tiết trong hướng dẫn này và được tóm tắt như sau:

Lấy thông tin về chứng chỉ của ứng dụng.
Đăng ký một dự án trong Google Developers Console và thêm API Ngữ cảnh người dùng làm dịch vụ cho dự án.
Yêu cầu khoá.
Thêm khoá vào ứng dụng. Để thực hiện việc này, hãy thêm một phần tử vào tệp kê khai ứng dụng.

Tìm thông tin về chứng chỉ của ứng dụng

Khoá API dựa trên một dạng ngắn của chứng chỉ kỹ thuật số của ứng dụng, được gọi là dấu vân tay SHA-1. Để hiển thị dấu vân tay SHA-1 cho chứng chỉ, trước tiên hãy đảm bảo rằng bạn sử dụng đúng chứng chỉ. Bạn có thể chọn một trong hai chứng chỉ sau:

Chứng chỉ gỡ lỗi: Các công cụ SDK Android sẽ tự động tạo chứng chỉ này khi bạn tạo bản gỡ lỗi. Chỉ sử dụng chứng chỉ này với những ứng dụng mà bạn đang thử nghiệm. Đừng cố gắng phát hành ứng dụng được ký bằng chứng chỉ gỡ lỗi. Chứng chỉ gỡ lỗi được mô tả chi tiết hơn trong phần Ký bản gỡ lỗi trong tài liệu dành cho nhà phát triển Android.
Chứng chỉ phát hành: Các công cụ SDK Android sẽ tạo chứng chỉ này khi bạn tạo bản phát hành. Bạn cũng có thể tạo chứng chỉ này bằng chương trình keytool. Hãy sử dụng chứng chỉ này khi bạn đã sẵn sàng phát hành ứng dụng của mình ra thế giới.

Để biết thêm thông tin về keytool, hãy xem tài liệu của Oracle.

Chứng chỉ gỡ lỗi

Hiển thị dấu vân tay chứng chỉ gỡ lỗi

Sử dụng chương thế keytool với tham số -v để hiển thị dấu vân tay SHA-1 của chứng chỉ. Để thực hiện điều này, vui lòng hoàn thành các bước sau:

Tìm tệp kho khoá gỡ lỗi. Tên tệp là debug.keystore, và tệp này được tạo lần đầu tiên bạn tạo dự án. Theo mặc định, tệp này được lưu trữ trong cùng thư mục với các tệp Thiết bị ảo Android (AVD):
- OS X và Linux: ~/.android/
- Windows Vista và Windows 7: C:\Users\your_user_name\.android\

Liệt kê dấu vân tay SHA-1:

Đối với Linux hoặc OS X, hãy mở cửa sổ dòng lệnh rồi nhập nội dung sau:

keytool -list -v -keystore ~/.android/debug.keystore -alias androiddebugkey -storepass android -keypass android

Đối với Windows Vista và Windows 7, hãy chạy nội dung sau:

keytool -list -v -keystore "%USERPROFILE%\.android\debug.keystore" -alias androiddebugkey -storepass android -keypass android

Bạn sẽ thấy kết quả tương tự như dưới đây:

Alias name: androiddebugkey
Creation date: Jan 01, 2013
Entry type: PrivateKeyEntry
Certificate chain length: 1
Certificate[1]:
Owner: CN=Android Debug, O=Android, C=US
Issuer: CN=Android Debug, O=Android, C=US
Serial number: 4aa9b300
Valid from: Mon Jan 01 08:04:04 UTC 2013 until: Mon Jan 01 18:04:04 PST 2033
Certificate fingerprints:
     MD5:  AE:9F:95:D0:A6:86:89:BC:A8:70:BA:34:FF:6A:AC:F9
     SHA1: BB:0D:AC:74:D3:21:E1:43:07:71:9B:62:90:AF:A1:66:6E:44:5D:75
     Signature algorithm name: SHA1withRSA
     Version: 3

Chứng chỉ phát hành

Hiển thị dấu vân tay chứng chỉ phát hành

Sử dụng chương thế keytool với tham số -v để hiển thị dấu vân tay SHA-1 của chứng chỉ. Để thực hiện điều này, vui lòng hoàn thành các bước sau:

Tìm tệp kho khoá chứng chỉ phát hành. Không có vị trí hoặc tên mặc định cho kho khoá phát hành. Nếu bạn không chỉ định một kho khoá khi bạn tạo ứng dụng để phát hành, thì bản dựng sẽ không ký .apk và bạn phải ký tệp này trước khi có thể phát hành. Đối với chứng chỉ phát hành, bạn cũng cần bí danh của chứng chỉ , mật khẩu cho kho khoá và chứng chỉ.
Nhập nội dung sau để liệt kê các bí danh cho tất cả khoá trong kho khoá:
```
keytool -list -keystore your_keystore_name
      
```
Thay thế your_keystore_name bằng đường dẫn và tên đủ điều kiện của kho khoá. Thêm đuôi .keystore extension. Nhập mật khẩu của kho khoá khi được nhắc. Sau đó, keytool sẽ hiển thị tất cả bí danh trong kho khoá.

Nhập nội dung sau tại một cửa sổ dòng lệnh hoặc dấu nhắc lệnh:

      keytool -list -v -keystore your_keystore_name -alias your_alias_name

Thay thế your_keystore_name bằng đường dẫn và tên đủ điều kiện của kho khoá. Thêm đuôi .keystore.
Thay thế your_alias_name bằng bí danh mà bạn đã gán cho chứng chỉ khi tạo chứng chỉ đó.

Bạn sẽ thấy kết quả tương tự như dưới đây:

Alias name: <alias_name>
Creation date: Feb 02, 2013
Entry type: PrivateKeyEntry
Certificate chain length: 1
Certificate[1]:
Owner: CN=Android Debug, O=Android, C=US
Issuer: CN=Android Debug, O=Android, C=US
Serial number: 4cc9b300
Valid from: Mon Feb 02 08:01:04 UTC 2013 until: Mon Feb 02 18:05:04 PST 2033
Certificate fingerprints:
    MD5:  AE:9F:95:D0:A6:86:89:BC:A8:70:BA:34:FF:6B:AC:F9
    SHA1: BB:0D:AC:74:D3:21:E1:43:67:71:9B:62:90:AF:A1:66:6E:44:5D:75
    Signature algorithm name: SHA1withRSA
    Version: 3

Dòng bắt đầu bằng SHA1 chứa dấu vân tay SHA-1 của chứng chỉ. Dấu vân tay là chuỗi gồm 20 số thập lục phân có hai chữ số được phân tách bằng dấu hai chấm.

Thận trọng: Để bảo vệ kho khoá và khoá, đừng nhập các đối số storepass hoặc keypass trên dòng lệnh, trừ phi bạn tin tưởng vào tính bảo mật của máy tính. Ví dụ: trên máy tính công cộng, người nào đó có thể xem nhật ký cửa sổ dòng lệnh hoặc danh sách các quy trình đang chạy, lấy mật khẩu rồi có quyền ghi vào chứng chỉ ký của bạn. Điều này sẽ cho phép người đó sửa đổi hoặc thay thế ứng dụng của bạn bằng ứng dụng của họ.

Lấy khoá API từ Google Developers Console

Để bắt đầu sử dụng API Awareness của Google, hãy nhấp vào nút Lấy khoá. Nút này liên kết đến Google Developers Console, hướng dẫn bạn thực hiện quy trình và tự động kích hoạt API Awareness.

Lấy khoá

Ngoài ra, hãy làm theo các bước sau để lấy khoá API:

Chuyển đến Google Developers Console.
Chọn một dự án hoặc tạo một dự án mới.
Nhấp vào Tiếp tục để bật API Awareness.
Trên trang "Thông tin xác thực", hãy tạo khoá Android và đặt thông tin xác thực API.
Lưu ý: Nếu đã có khoá Android, bạn có thể sử dụng khoá đó.
Trong hộp thoại "Tạo khoá", bạn cần hạn chế việc sử dụng khoá cho các ứng dụng Android. Để thực hiện việc này, hãy nhập dấu vân tay SHA-1 và tên gói của ứng dụng, như trong ví dụ sau:
```
BB:0D:AC:74:D3:21:E1:43:67:71:9B:62:91:AF:A1:66:6E:44:5D:75

com.example.android.awareness-example
```
Nhấp vào Tạo. Khoá API Android mới của bạn sẽ xuất hiện trong danh sách khoá API cho dự án của bạn. Khoá API là một chuỗi ký tự, chẳng hạn như sau:
```
AIzaSyBdVl-cTICSwYKrZ95LoVuw7dbMuDt1KG0
```

Giờ đây, bạn đã có khoá API, bạn có thể thêm khoá đó vào tệp kê khai của ứng dụng, như mô tả trong Hướng dẫn bắt đầu.

Kích hoạt các API khác

API Awareness cho phép bạn truy cập vào nhiều loại dữ liệu theo ngữ cảnh, chẳng hạn như đèn hiệu. Để sử dụng các loại này, bạn cần bật các API tương ứng trong Google Developers Console.

Dịch vụ	Phương thức API Awareness	API cần bật
Đèn hiệu	`SnapshotApi.getBeaconState()`, `FenceApi.BeaconFence`	API Gửi tin nhắn lân cận