Duyuru:
15 Nisan 2025'ten önce Earth Engine'i kullanmak için kaydedilen tüm ticari olmayan projelerin Earth Engine erişimini sürdürmek için
ticari olmayan uygunluğu doğrulaması gerekir.
ee.data.authenticateViaOauth
Koleksiyonlar ile düzeninizi koruyun
İçeriği tercihlerinize göre kaydedin ve kategorilere ayırın.
JavaScript için Google API'leri İstemci Kitaplığı aracılığıyla EE API çağrılarının istemci tarafı kimlik doğrulamasını yapılandırır. Kitaplık sayfada henüz yüklenmemişse otomatik olarak yüklenir. Kullanıcıdan, daha önce yapmadıysa clientId ile tanımlanan uygulamaya EE verilerine erişim izni vermesi istenir.
Bu veya başka bir kimlik doğrulama yöntemi, ee.initialize() çağrılmadan önce çağrılmalıdır.
Kullanıcı, daha önce istemci kimliğiyle tanımlanan uygulamaya erişim izni vermediyse varsayılan olarak, kullanıcıdan gerekli izni vermesini isteyen bir iletişim kutusu açılmaya çalışılır. Ancak bu pop-up, tarayıcı tarafından engellenebilir. Bunu önlemek için opt_onImmediateFailed geri çağırmasını belirtin ve bu geri çağırmada sayfa içi giriş düğmesini oluşturun, ardından bu düğmenin tıklama etkinliği işleyicisinden ee.data.authenticateViaPopup() işlevini çağırın. Bu sayede, artık doğrudan bir kullanıcı işleminin sonucu olduğu için tarayıcının pop-up'ı engellemesi önlenir.
Yetkilendirme jetonu, mümkün olduğunda otomatik olarak yenilenir. Tüm asenkron çağrıların uygun kimlik bilgileriyle gönderileceğini güvenle varsayabilirsiniz. Ancak senkron çağrılar için ee.data.getAuthToken() ile bir kimlik doğrulama jetonu olup olmadığını kontrol etmeli ve yoksa ee.data.refreshAuthToken() işlevini manuel olarak çağırmalısınız. Jeton yenileme işlemi asenkron olduğundan senkronize çağrılardan önce isteğe bağlı olarak arka planda gerçekleştirilemez.
| Kullanım | İadeler |
|---|
ee.data.authenticateViaOauth(clientId, success, error, extraScopes, onImmediateFailed, suppressDefaultScopes) | |
| Bağımsız Değişken | Tür | Ayrıntılar |
|---|
clientId | Dize | Uygulamanın OAuth istemci kimliği veya kimliği doğrulanmış çağrıları devre dışı bırakmak için null. Bu bilgiler Google Developers Console üzerinden edinilebilir. Projenin, komut dosyasının çalıştığı alanla eşleşen bir JavaScript kaynağı olmalıdır. |
success | İşlev | Kimlik doğrulama başarılı olursa çağrılacak işlev. |
error | İşlev, isteğe bağlı | Kimlik doğrulama başarısız olduğunda çağrılacak işlev, hata mesajını iletti. Anında (arka planda) modda kimlik doğrulama başarısız olursa ve opt_onImmediateFailed belirtilirse opt_error yerine bu işlev çağrılır. |
extraScopes | List<String>, isteğe bağlı | İstenilecek ek OAuth kapsamları. |
onImmediateFailed | İşlev, isteğe bağlı | Otomatik arka plan kimlik doğrulaması başarısız olursa çağrılacak işlev. Varsayılan olarak, iletilen geri çağırmalara bağlı ee.data.authenticateViaPopup() kullanılır. |
suppressDefaultScopes | Boole değeri, isteğe bağlı | Doğru olduğunda yalnızca opt_extraScopes içinde belirtilen kapsamlar istenir. opt_extraScopes içinde açıkça belirtilmediği sürece varsayılan kapsamlar istenmez. |
Aksi belirtilmediği sürece bu sayfanın içeriği Creative Commons Atıf 4.0 Lisansı altında ve kod örnekleri Apache 2.0 Lisansı altında lisanslanmıştır. Ayrıntılı bilgi için Google Developers Site Politikaları'na göz atın. Java, Oracle ve/veya satış ortaklarının tescilli ticari markasıdır.
Son güncelleme tarihi: 2025-07-25 UTC.
[null,null,["Son güncelleme tarihi: 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. |"]]
