Pengumuman: Semua project nonkomersial yang terdaftar untuk menggunakan Earth Engine sebelum
15 April 2025 harus
memverifikasi kelayakan nonkomersial untuk mempertahankan akses Earth Engine.
ee.data.authenticateViaPrivateKey
Tetap teratur dengan koleksi
Simpan dan kategorikan konten berdasarkan preferensi Anda.
Mengonfigurasi autentikasi sisi server panggilan EE API melalui Klien Node.js Google API. Autentikasi kunci pribadi khusus untuk panggilan API sisi server: untuk aplikasi berbasis browser, gunakan ee.data.authenticateViaOauth(). Tidak ada interaksi pengguna (misalnya, pop-up autentikasi) yang diperlukan saat menggunakan autentikasi sisi server.
Metode autentikasi ini atau metode autentikasi lainnya harus dipanggil sebelum ee.initialize().
Token autentikasi akan diperbarui secara otomatis jika memungkinkan. Anda dapat mengasumsikan dengan aman bahwa semua panggilan asinkron akan dikirim dengan kredensial yang sesuai. Namun, untuk panggilan sinkron, Anda harus memeriksa token autentikasi dengan ee.data.getAuthToken() dan memanggil ee.data.refreshAuthToken() secara manual jika tidak ada. Operasi penggantian token bersifat asinkron dan tidak dapat dilakukan di balik layar, sesuai permintaan, sebelum panggilan sinkron.
| Penggunaan | Hasil |
|---|
ee.data.authenticateViaPrivateKey(privateKey, success, error, extraScopes, suppressDefaultScopes) | |
| Argumen | Jenis | Detail |
|---|
privateKey | AuthPrivateKey | Konten JSON kunci pribadi. |
success | Fungsi, opsional | Fungsi yang akan dipanggil jika autentikasi berhasil. |
error | Fungsi, opsional | Fungsi yang akan dipanggil jika autentikasi gagal, meneruskan pesan error. |
extraScopes | List<String>, opsional | Cakupan OAuth tambahan yang akan diminta. |
suppressDefaultScopes | Boolean, opsional | Jika benar, hanya cakupan yang ditentukan dalam opt_extraScopes yang diminta; cakupan default tidak diminta kecuali jika ditentukan secara eksplisit dalam opt_extraScopes. |
Kecuali dinyatakan lain, konten di halaman ini dilisensikan berdasarkan Lisensi Creative Commons Attribution 4.0, sedangkan contoh kode dilisensikan berdasarkan Lisensi Apache 2.0. Untuk mengetahui informasi selengkapnya, lihat Kebijakan Situs Google Developers. Java adalah merek dagang terdaftar dari Oracle dan/atau afiliasinya.
Terakhir diperbarui pada 2025-07-26 UTC.
[null,null,["Terakhir diperbarui pada 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. |"]]
