ee.data.authenticateViaOauth
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 khách của các lệnh gọi EE API thông qua Thư viện ứng dụng Google API cho JavaScript. Thư viện sẽ tự động tải nếu chưa được tải trên trang. Người dùng sẽ được yêu cầu cấp cho ứng dụng (được xác định bằng clientId) quyền truy cập vào dữ liệu EE của họ nếu trước đó họ chưa làm như vậy.
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().
Xin lưu ý rằng nếu người dùng chưa cấp quyền truy cập cho ứng dụng được xác định bằng mã ứng dụng, thì theo mặc định, thao tác này sẽ cố gắng hiển thị một cửa sổ hộp thoại nhắc người dùng cấp quyền bắt buộc. Tuy nhiên, trình duyệt có thể chặn cửa sổ bật lên này. Để tránh điều này, hãy chỉ định lệnh gọi lại opt_onImmediateFailed và trong đó, hãy hiển thị một nút đăng nhập trên trang, sau đó gọi ee.data.authenticateViaPopup() từ trình xử lý sự kiện nhấp của nút này. Thao tác này sẽ ngăn trình duyệt chặn cửa sổ bật lên, vì cửa sổ này hiện là kết quả trực tiếp của một hành động của người dùng.
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 theo yêu cầu ở chế độ nền trước các lệnh gọi đồng bộ.
| Cách sử dụng | Giá trị trả về |
|---|
ee.data.authenticateViaOauth(clientId, success, error, extraScopes, onImmediateFailed, suppressDefaultScopes) | |
| Đối số | Loại | Thông tin chi tiết |
|---|
clientId | Chuỗi | Mã ứng dụng OAuth của ứng dụng hoặc giá trị rỗng để tắt các lệnh gọi đã xác thực. Bạn có thể lấy thông tin này thông qua Google Developers Console. Dự án phải có một nguồn gốc JavaScript tương ứng với miền nơi tập lệnh đang chạy. |
success | Chức năng | 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. Nếu quá trình xác thực ở chế độ immediate (ngay lập tức) (ở chế độ nền) không thành công và opt_onImmediateFailed được chỉ định, thì hàm đó sẽ được gọi thay vì opt_error. |
extraScopes | List<String>, không bắt buộc | Các phạm vi OAuth bổ sung cần yêu cầu. |
onImmediateFailed | Hàm, không bắt buộc | Hàm sẽ gọi nếu quá trình xác thực tự động diễn ra ngầm không thành công. Mặc định là ee.data.authenticateViaPopup(), được liên kết với các lệnh gọi lại đã truyền. |
suppressDefaultScopes | Boolean, không bắt buộc | Khi có giá trị true, 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-25 UTC.
[null,null,["Cập nhật lần gần đây nhất: 2025-07-25 UTC."],[[["\u003cp\u003eEnables authenticated access to Earth Engine data using your Google account via the Google APIs Client Library for JavaScript.\u003c/p\u003e\n"],["\u003cp\u003eRequires initialization before using Earth Engine functionalities and might prompt users for permission to access their Earth Engine data.\u003c/p\u003e\n"],["\u003cp\u003eAutomatically refreshes authentication tokens for asynchronous calls, but synchronous calls may require manual token refresh using \u003ccode\u003eee.data.getAuthToken()\u003c/code\u003e and \u003ccode\u003eee.data.refreshAuthToken()\u003c/code\u003e.\u003c/p\u003e\n"],["\u003cp\u003eProvides options for handling authentication failures, including specifying custom error callbacks and displaying an in-page login button to avoid browser popup blockers.\u003c/p\u003e\n"],["\u003cp\u003eAllows customization of OAuth scopes and client ID for specific application requirements.\u003c/p\u003e\n"]]],[],null,["# ee.data.authenticateViaOauth\n\n\u003cbr /\u003e\n\nConfigures client-side authentication of EE API calls through the Google APIs Client Library for JavaScript. The library will be loaded automatically if it is not already loaded on the page. The user will be asked to grant the application identified by clientId access to their EE data if they have not done so previously.\n\n\u003cbr /\u003e\n\nThis or another authentication method should be called before ee.initialize().\n\nNote that if the user has not previously granted access to the application identified by the client ID, by default this will try to pop up a dialog window prompting the user to grant the required permission. However, this popup can be blocked by the browser. To avoid this, specify the opt_onImmediateFailed callback, and in it render an in-page login button, then call ee.data.authenticateViaPopup() from the click event handler of this button. This stops the browser from blocking the popup, as it is now the direct result of a user action.\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.authenticateViaOauth(clientId, success, `*error* `, `*extraScopes* `, `*onImmediateFailed* `, `*suppressDefaultScopes*`)` | |\n\n| Argument | Type | Details |\n|-------------------------|--------------------------|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `clientId` | String | The application's OAuth client ID, or null to disable authenticated calls. This can be obtained through the Google Developers Console. The project must have a JavaScript origin that corresponds to the domain where the script is running. |\n| `success` | Function | The function to call if authentication succeeded. |\n| `error` | Function, optional | The function to call if authentication failed, passed the error message. If authentication in immediate (behind-the-scenes) mode fails and opt_onImmediateFailed is specified, that function is called instead of opt_error. |\n| `extraScopes` | List\\\u003cString\\\u003e, optional | Extra OAuth scopes to request. |\n| `onImmediateFailed` | Function, optional | The function to call if automatic behind-the-scenes authentication fails. Defaults to ee.data.authenticateViaPopup(), bound to the passed callbacks. |\n| `suppressDefaultScopes` | Boolean, optional | When true, only scopes specified in opt_extraScopes are requested; the default scopes are not requested unless explicitly specified in opt_extraScopes. |"]]
