ee.data.authenticateViaPrivateKey
Sử dụng bộ sưu tập để sắp xếp ngăn nắp các trang
Lưu và phân loại nội dung dựa trên lựa chọn ưu tiên của bạn.
Định cấu hình hoạt động xác thực phía máy chủ của các lệnh gọi EE API thông qua Ứng dụng Google APIs Node.js. Xác thực khoá riêng tư chỉ dành cho các lệnh gọi API phía máy chủ: đối với các ứng dụng dựa trên trình duyệt, hãy sử dụng ee.data.authenticateViaOauth(). Không cần có hoạt động tương tác của người dùng (ví dụ: cửa sổ xác thực bật lên) khi sử dụng phương thức xác thực phía máy chủ.
Bạn nên gọi phương thức xác thực này hoặc một phương thức xác thực khác trước khi gọi ee.initialize().
Mã thông báo uỷ quyền sẽ tự động làm mới khi có thể. Bạn có thể yên tâm rằng tất cả các lệnh gọi không đồng bộ sẽ được gửi bằng thông tin đăng nhập thích hợp. Tuy nhiên, đối với các lệnh gọi đồng bộ, bạn nên kiểm tra mã thông báo uỷ quyền bằng ee.data.getAuthToken() và gọi ee.data.refreshAuthToken() theo cách thủ công nếu không có mã thông báo nào. Thao tác làm mới mã thông báo là thao tác không đồng bộ và không thể thực hiện ở chế độ nền, theo yêu cầu, trước các lệnh gọi đồng bộ.
| Cách sử dụng | Giá trị trả về |
|---|
ee.data.authenticateViaPrivateKey(privateKey, success, error, extraScopes, suppressDefaultScopes) | |
| Đối số | Loại | Thông tin chi tiết |
|---|
privateKey | AuthPrivateKey | Nội dung JSON của khoá riêng tư. |
success | Hàm, không bắt buộc | Hàm cần gọi nếu xác thực thành công. |
error | Hàm, không bắt buộc | Hàm cần gọi nếu quy trình xác thực không thành công, đã truyền thông báo lỗi. |
extraScopes | List<String>, không bắt buộc | Các phạm vi OAuth bổ sung cần yêu cầu. |
suppressDefaultScopes | Boolean, không bắt buộc | Khi đúng, chỉ những phạm vi được chỉ định trong opt_extraScopes mới được yêu cầu; các phạm vi mặc định sẽ không được yêu cầu trừ phi được chỉ định rõ ràng trong opt_extraScopes. |
Trừ phi có lưu ý khác, nội dung của trang này được cấp phép theo Giấy phép ghi nhận tác giả 4.0 của Creative Commons và các mẫu mã lập trình được cấp phép theo Giấy phép Apache 2.0. Để biết thông tin chi tiết, vui lòng tham khảo Chính sách trang web của Google Developers. Java là nhãn hiệu đã đăng ký của Oracle và/hoặc các đơn vị liên kết với Oracle.
Cập nhật lần gần đây nhất: 2025-07-26 UTC.
[null,null,["Cập nhật lần gần đây nhất: 2025-07-26 UTC."],[[["\u003cp\u003eEnables server-side authentication for Earth Engine API calls using a private key, suitable for non-browser environments.\u003c/p\u003e\n"],["\u003cp\u003eAuthentication happens automatically for asynchronous calls, but synchronous calls require manual token checks and refresh using \u003ccode\u003eee.data.getAuthToken()\u003c/code\u003e and \u003ccode\u003eee.data.refreshAuthToken()\u003c/code\u003e.\u003c/p\u003e\n"],["\u003cp\u003e\u003ccode\u003eee.data.authenticateViaPrivateKey()\u003c/code\u003e function facilitates this authentication process, accepting the private key and optional success/error callbacks, extra scopes, and a flag to suppress default scopes.\u003c/p\u003e\n"]]],[],null,["# ee.data.authenticateViaPrivateKey\n\n\u003cbr /\u003e\n\nConfigures server-side authentication of EE API calls through the Google APIs Node.js Client. Private key authentication is strictly for server-side API calls: for browser-based applications, use ee.data.authenticateViaOauth(). No user interaction (e.g. authentication popup) is necessary when using server-side authentication.\n\n\u003cbr /\u003e\n\nThis or another authentication method should be called before ee.initialize().\n\nThe auth token will be refreshed automatically when possible. You can safely assume that all async calls will be sent with the appropriate credentials. For synchronous calls, however, you should check for an auth token with ee.data.getAuthToken() and call ee.data.refreshAuthToken() manually if there is none. The token refresh operation is asynchronous and cannot be performed behind-the-scenes, on demand, prior to synchronous calls.\n\n| Usage | Returns |\n|------------------------------------------------------------------------------------------------------------------------|---------|\n| `ee.data.authenticateViaPrivateKey(privateKey, `*success* `, `*error* `, `*extraScopes* `, `*suppressDefaultScopes*`)` | |\n\n| Argument | Type | Details |\n|-------------------------|--------------------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `privateKey` | AuthPrivateKey | JSON content of private key. |\n| `success` | Function, optional | The function to call if authentication succeeded. |\n| `error` | Function, optional | The function to call if authentication failed, passed the error message. |\n| `extraScopes` | List\\\u003cString\\\u003e, optional | Extra OAuth scopes to request. |\n| `suppressDefaultScopes` | Boolean, optional | When true, only scopes specified in opt_extraScopes are requested; the default scopes are not not requested unless explicitly specified in opt_extraScopes. |"]]
