Kimlik Doğrulama ve İlklendirme

İstemci kitaplığı aracılığıyla Earth Engine'e istek gönderebilmek için kimlik doğrulaması yapmanız ve Earth Engine istemcisini ilk kullanıma hazırlamak için elde edilen kimlik bilgilerini kullanmanız gerekir.

Earth Engine Kod Düzenleyici ve JavaScript

Kimlik doğrulama ve başlatma işlemleri Kod Düzenleyici'de otomatik olarak gerçekleştirilir. Kod Düzenleyici'nin sağ üst kısmındaki girişinizden istekleri bir Cloud projesi üzerinden yönlendirmeyi seçebilirsiniz.

JavaScript API'yi (Kod Düzenleyici dışında) kullanıyorsanız ee.data içindeki kimlik doğrulama yardımcılarından birini (ör. ee.data.authenticateViaPopup()) ve ardından bu örnekte gösterildiği gibi ee.initialize() yöntemini kullanın.

Python ve komut satırı

Earth Engine Python istemci kitaplığını kullanmadan önce kimlik doğrulama (kimliğinizi doğrulama) yapmanız ve Python istemcisini başlatmak için elde edilen kimlik bilgilerini kullanmanız gerekir. Kimlik doğrulama akışları, kimlik doğrulaması için Cloud projelerini kullanır. Bu akışlar, ücretli kullanımın yanı sıra ücretsiz (ücretsiz, ticari olmayan) kullanım için de kullanılır. Kimlik doğrulaması ve ilk kullanıma hazırlama için şu komutu çalıştırın:

    ee.Authenticate()
    ee.Initialize(project='my-project')

Bu işlem, öncelikle ortamınız için en iyi kimlik doğrulama modunu seçer ve komut dosyalarınızın erişimini onaylamanızı ister. Kimlik bilgileri zaten varsa otomatik olarak yeniden kullanılır. Yeni kimlik bilgileri oluşturmak için ee.Authenticate(force=True) komutunu çalıştırın.

Başlatma adımı, ee.Authenticate() üzerinden oluşturulan veya Google'ın varsayılan kimlik bilgileri olarak önceden mevcut olan geçerli kimlik bilgilerinin varlığını doğrular. Ardından, Python istemci kitaplığını arka uç sunucusunun desteklediği yöntemlerle başlatır. Sahibi olduğunuz veya kullanma izninizin olduğu bir proje sağlamanız gerekir. Projeyi kaydetmek ve Earth Engine API'yi etkinleştirmek için Cloud projesi kurulumu başlıklı makaleyi inceleyin. Bu proje, tüm Earth Engine işlemlerini çalıştırmak için kullanılacak.

Komut satırında eşdeğer çağrı earthengine authenticate şeklindedir. Kimlik bilgilerinin süresi dolmuşsa veya geçersizse earthengine authenticate --force komutunu çalıştırmanız gerekebilir. Komut satırı çağrıları her çağrıda başlatılır ve projeyi ayarlamak için --project bağımsız değişkenini kullanabilirsiniz.

earthengine set_project {my-project} komutunu çalıştırarak gelecekteki tüm çağrılar için bir proje de yapılandırabilirsiniz. Komut satırı ve ee.Initialize(), doğrudan bir proje belirtilmediğinde bunu kullanır. gcloud üzerinden kimlik doğrulama kullanılıyorsa (aşağıya bakın) gcloud auth application-default set-quota-project {my-project} tarafından ayarlanan proje son durum olarak kullanılır.

Kimlik doğrulama ayrıntıları

Earth Engine kimlik doğrulama akışlarının amacı, oturum açmış hesabınızdan bir güvenlik "jetonu" almaktır. Bu jeton, komut dosyalarınıza verilerinize erişim izni vermek için saklanabilir. Güvenlik nedeniyle, Google'ın kimlik doğrulama sistemi bu tür jetonları yalnızca güvenli hale getirilebilecek sistemlere iletir. Aşağıdaki teknik notlara bakın.

İlgili sistemlerin türüne karşı hassasiyet nedeniyle, özel durumunuza bağlı olarak farklı ilerleme yolları vardır. Seçeneklerin çoğu auth_mode parametresiyle kontrol edilir: komut satırında ee.Authenticate(auth_mode=...) veya earthengine authenticate --auth_mode=... olarak.

Ortamınızda Google kimlik bilgileri zaten varsa ee.Authenticate() yöntemini çağırmanız gerekmeyebilir. Google Cloud sanal makineleri, App Engine ve diğer ortamlar kullanılabilir "ortam kimlik bilgileri" sağlar ve gcloud auth application-default login da bunları oluşturur.

Ancak uyumluluğu en üst düzeye çıkarmak için tüm komut dosyalarının başında ee.Authenticate() kullanılması önerilir. auth_mode parametresi olmadan çoğu durumda çalışacak şekilde tasarlanmıştır ancak varsayılan mod çalışmazsa aşağıdaki ayrıntıları uygulayın. Varsayılan mod aşağıdaki şekilde seçilir:

  • Google Colab not defterinde çalıştırılıyorsa colab
  • Colab dışındaki diğer Jupyter not defterlerinde çalıştırılıyorsa notebook
  • localhost (web tarayıcısı algılanırsa ve gcloud ikili programı yüklü değilse)
  • Aksi takdirde gcloud. Bu mod için gcloud'u yüklemeniz gerekir.

Hızlı referans kılavuzu ve tablosu

Bu karar kılavuzunda, ee.Authenticate() tarafından seçilen varsayılan modun çalışmaması durumunda kullanılabilecek seçenekler açıklanmaktadır. Örneğin, başka not defteri ortamlarında çalışıyorsanız notebook değerini açıkça belirtmeniz gerekebilir.

  • Yerel ortam.
    • "Yerel", kodu önünüzdeki makinede (daha doğrusu web tarayıcınızın çalıştığı makinede) bir Python kabuğunda veya Python not defterinde çalıştırdığınız anlamına gelir. Buna, hem Python'un hem de tarayıcının aynı (uzak) makinede olduğu uzak masaüstü durumları da dahildir.
    • auth_mode=localhost kullanmak en kolay yöntemdir ve gcloud yüklü değilse varsayılan olarak seçilir ancak komut dosyanız yalnızca yerel ortamlarda çalışır.
    • Hem auth_mode=gcloud hem de auth_mode=notebook kullanılabilir.
  • Uzak ortam.
    • "Uzak", tarayıcınızın bir (yerel) makinede olduğu ancak kodunuzun uzak bir iş istasyonu veya web tabanlı bir not defteri gibi başka bir yerde çalıştığı anlamına gelir.
    • Colab'deyseniz auth_mode=colab, diğer API'leri çağırmak için scopes değerini ayarlamanız gerekiyorsa gcloud kullanın.
    • gcloud'u hem uzak makineye hem de yerel makinenize yükleyebiliyorsanız auth_mode=gcloud komutunu kullanın.
    • Kimlik doğrulama projesi kullanabiliyorsanız (aşağıya bakın) auth_mode=notebook kullanın.
    • Aksi takdirde, bir proje kullanamıyorsanız veya gcloud'u yükleyemiyorsanız ya da Colab'i veya aynı makinede bir tarayıcıyı kullanamıyorsanız:
    • Proje oluşturma hakkında bir yöneticiyle (tekrar) görüşün. Örneğin:
      • Yöneticiden sizin için bir proje yapılandırmasını isteyin (Sahip, Düzenleyici veya OAuth Yapılandırma Düzenleyicisi olarak).
      • Alternatif olarak, yöneticiden size proje oluşturma izni vermesini isteyin.

Bu tabloda, her modun hangi özellik kombinasyonlarını desteklediği gösterilmektedir.

Yerel mi yoksa uzaktan mı? Proje Gerekli Ayarlanabilir Kapsamlar Yerel CLI Gerekli Proje Sahibi
localhost local Y E H H
colab uzaktan kumanda Y H H H
gcloud her ikisi de Y E H H
notebook her ikisi de Y E H Y

Hizmet hesapları ve Compute Engine için kimlik bilgileri

ee.Initialize(), Earth Engine kimlik bilgilerini (ee.Authenticate(), ~/.config/earthengine/credentials içinde depolar) kullanır veya kimlik bilgilerini google.auth.default() üzerinden alır. Ancak gerekirse bu varsayılanları atlayarak başka bir yerden kimlik bilgilerini kullanmak için credentials= bağımsız değişkenini iletebilirsiniz.

Katılımsız çalışacak Python kodunun kimliğini doğruluyorsanız kullanıcı hesabı yerine hizmet hesabı ile kimlik doğrulaması yapmanız önerilir. Earth Engine ile hizmet hesaplarını kullanma hakkında bilgi edinmek için bu belgelere göz atın. Diğer yöntemler arasında Colab auth modülündeki authenticate_service_account ve Hizmet hesabı olarak kimlik doğrulama için Cloud kılavuzunda açıklanan yöntemler yer alır.

Kodunuz bir Compute Engine sanal makinesinde çalışıyorsa ortam için ee.Initialize() tarafından varsayılan olarak kullanılacak bir varsayılan hizmet hesabı oluşturulur. Sanal makinenin başlatıldığı Cloud projesi, Earth Engine (ticari veya ticari olmayan) ile kullanılmak üzere kayıtlı değilse Earth Engine'i kullanmak için hizmet hesabını kaydetmeniz gerekebilir.

Modlar hakkında ayrıntılı bilgi

auth_mode=colab. ee.Authenticate(), gerekirse colab.auth.authenticate_user() komutunu çalıştırarak Colab tarafından desteklenen varsayılan kimlik bilgilerini oluşturur veya alır. Kimlik bilgileri her zaman cloud-platform kapsamını kullanır ve diğer Cloud API'lerini çağırmak için de kullanılabilir.

auth_mode=gcloud. Bu, kimlik doğrulamayı gcloud aracına devreder ve varsayılan Earth Engine kapsamları (earthengine, cloud-platform ve drive) veya scopes bağımsız değişkenindeki kapsamlarla gcloud auth application-default login komutunu çalıştırmakla aynıdır. gcloud modu hem yerel hem de uzak durumlarda çalışır.

gcloud modu için adım adım talimatlar (yerel ve uzak durumlar)

  1. Yerel makinede gcloud'un yüklü olduğunu doğrulayın.
    • Terminalde gcloud help komutunu çalıştırın. gcloud yüklü değilse gcloud'u yüklemek için bu talimatları uygulayın.
  2. Yerel Makine Terminali
    • Terminalde earthengine authenticate komutunu çalıştırın.
    • Komut çıktısı, kimlik bilgilerini almak için gcloud'un kullanıldığını gösterir.
    • Hesap seçimi sayfasını içeren bir tarayıcı penceresi açılır. Tarayıcı otomatik olarak açılmazsa URL'yi tıklayın.
  3. Tarayıcı: Hesap Seçimi
    • Kimlik doğrulama için kullanmak istediğiniz hesabı seçin.
  4. Tarayıcı: Kullanıcı rızası ekranı
    • İstenen kapsamları vermeyi kabul ediyorsanız "İzin ver"i tıklayın.
  5. Tarayıcı: Onay Ekranı
    • Tarayıcıda, kimliğinizin doğrulandığını onaylayan bir sayfa gösterilir ve terminal pencerenizdeki earthengine authenticate komutu, "Yetkilendirme jetonu başarıyla kaydedildi" mesajını verir.
    • Nadir durumlarda, web sayfası size Python ortamına yapıştıracağınız bir kod verir.
  6. Başlatma işlemine devam edin.

auth_mode=localhost. Bu, gcloud'un yüklü olmadığı durumlarda gcloud benzeri bir akıştır. gcloud ile aynı adımları uygular ancak yalnızca yerel durum için çalışır. İsteğe bağlı olarak bir internet bağlantı noktası numarası (ör. localhost:8086) sağlayabilir veya bir bağlantı noktasını otomatik olarak seçmek için localhost:0 kullanabilirsiniz. Varsayılan bağlantı noktası 8085'tir.

auth_mode=notebook. Bu, yerel komut satırlarının kullanılamadığı uzak durumlarda çalışmak üzere tasarlanmış genel amaçlı bir moddur. Bu komut sizi Notebook Authenticator sayfasına yönlendirir. Burada bir "kimlik doğrulama projesi" seçmeniz veya oluşturmanız gerekir. Ayrıntılar ve sorun giderme kılavuzu için aşağıya bakın. ee.Initialize() işlevine iletilen proje, bununla eşleşmek zorunda değildir. Farklı not defterlerinde farklı projeler üzerinde çalışırken kimlik doğrulama için aynı projeyi kullanabilirsiniz. ee.Initialize() için bir projeyi açıkça iletmeniz önerilir ancak varsayılan olarak kimlik doğrulama projesi kullanılır.

Not defteri modu için adım adım talimatlar

  1. Tarayıcı: Notebook
    1. "Not defteri" modunu kullanarak bir kimlik doğrulama akışı başlatmak için not defteri kod hücresinde aşağıdaki kodu çalıştırın. 
      import ee
ee.Authenticate()
       Hücre çıkışındaki bağlantıyı tıklayarak yeni bir sekmede Notebook Authenticator sayfasını açın.
  2. Tarayıcı: Notebook Authenticator
    1. Doğru kullanıcı hesabının listelendiğini doğrulayın.
    2. Kimlik doğrulama için kullanılacak bir Google Cloud projesi seçin. Yeni bir proje oluşturmanız gerekiyorsa "ee-xyz" adlandırma kuralını kullanmanızı öneririz. Burada xyz, her zamanki Earth Engine kullanıcı adınızdır. (Bir Cloud projesi seçemiyor veya oluşturamıyorsanız aşağıdaki sorun giderme bölümüne bakın.)
    3. Generate Token'ı (Jeton Oluştur) tıklayın.
  3. Tarayıcı: Hesap Seçimi
    • Hesap seçimi sayfası gösterilir. Not defterinden erişim izni vermek istediğiniz kullanıcı hesabını tıklayın.
  4. Tarayıcı: Uyarı sayfası
    • Google'ın uygulamayı (not defterindeki kod) oluşturmadığını belirten bir uyarı sayfası gösterilir. Onaylamak için Devam'ı tıklayın.
  5. Tarayıcı: Kullanıcı rızası ekranı
    • İstenen kapsamları vermek isteyip istemediğinizi belirtin ve Devam'ı tıklayın.
  6. Tarayıcı: Yetkilendirme Kodu Ekranı
    • Yetkilendirme doğrulama kodunu kopyalayın.
  7. Tarayıcı: Notebook
    • Not defteri sekmesine geri dönün ve doğrulama kodunu not defteri hücresi çıkışına yapıştırın.
    • Hücre çıkışında "Successfully saved authorization token." (Yetkilendirme jetonu başarıyla kaydedildi.) ifadesi gösterilmelidir.
  8. Başlatma işlemine devam edin.

Notebook modunda nadiren kullanılan bir quiet parametresi vardır: Bu parametre ayarlanırsa "etkileşimli olmayan" şekilde çalışır ve kimlik doğrulama kodunu girmenizi istemez ve beklemez. Bunun yerine, kodu kaydetmek için çalıştırılacak bir komut verir.

Kimlik doğrulama projeleri

Not defteri modunda kullanılan kimlik doğrulama projesinde Sahip, Düzenleyici veya OAuth Yapılandırma Düzenleyicisi olmanız gerekir. Çoğu durumda, özellikle daha küçük ekiplerde, Notebook Authenticator sayfasında kullandığınız kimlik doğrulama projesi, diğer işler için kullandığınız birincil projeyle aynı olabilir.

Güvenlik endişeleri nedeniyle, kimlik doğrulama projesindeki "OAuth istemci yapılandırması" tek seferlik bir kurulumdur. Siz veya diğer kullanıcılar başka nedenlerle projede bir OAuth istemcisi oluşturduysanız bu istemci kaldırılamaz ve "uyumsuz OAuth2 istemci yapılandırması" hatası gösterilir. Kimlik doğrulama için farklı bir proje kullanmanız veya yukarıdaki colab, localhost ya da gcloud modlarını kullanmanız gerekir.

Kapsamlarla ilgili ayrıntılar

Earth Engine'in varsayılan kimlik doğrulama ayarları, mevcut tüm kapsamları içerir. Bu nedenle, varsayılan ayarlar gereksinimlerinizi karşılıyorsa bu bölümü atlayabilirsiniz.

Earth Engine kapsamları: OAuth 2.0 kapsamı, bir uygulamanın kullanıcı adına erişmesine izin verilen kaynak ve işlem grubunu tanımlar ve kısıtlar. Earth Engine'da kimlik doğrulaması yapmak için OAuth kullandığınızda aşağıdaki kapsamlardan birini veya daha fazlasını istemeniz gerekir:

  • https://www.googleapis.com/auth/earthengine: Earth Engine öğelerine ve kaynaklarına okuma ve yazma erişimi. Öğe oluşturma, değiştirme veya silme, öğe izinlerini yönetme ve dışa aktarma görevlerini çalıştırma için gereklidir.
  • https://www.googleapis.com/auth/earthengine.readonly: Earth Engine öğelerine salt okunur erişim.

Her iki kapsam da komut dosyalarının yürütülmesine ve hesaplamaların (ör. ifadeleri değerlendirme veya harita görselleştirmelerini oluşturma) çalıştırılmasına olanak tanır.

Google Cloud ve Drive kapsamları: Earth Engine sorgularınız veya komut dosyalarınız harici verilere ya da öğelere referans veriyorsa kimlik bilgileriniz bu hizmetler için uygun kapsamları da içermelidir:

  • Cloud Storage (GCS) (Cloud Storage paketlerinden okuma veya paketlere yazma yaparken, örneğin Cloud Optimized GeoTIFF'leri (COG) yüklerken veya görev çıktılarını dışa aktarırken):
    • https://www.googleapis.com/auth/devstorage.full_control
    • https://www.googleapis.com/auth/devstorage.read_write
    • https://www.googleapis.com/auth/devstorage.read_only
  • BigQuery (BQ) (tabloları okurken veya dışa aktarma işlemlerini BigQuery'ye yazarken):
    • https://www.googleapis.com/auth/bigquery
  • Google Drive (Google Drive'a erişirken veya veri aktarırken):
    • https://www.googleapis.com/auth/drive
    • https://www.googleapis.com/auth/drive.readonly

Google Cloud, tüm Google Cloud hizmetlerini kapsayan geniş kapsamlar da sunar:

  • Cloud Platform (Earth Engine, Cloud Storage ve BigQuery'yi kapsayan Google Cloud hizmetlerine geniş erişim; Google Drive'ın ayrı bir Workspace hizmeti olduğunu ve bu kapsamlara dahil olmadığını unutmayın):
    • https://www.googleapis.com/auth/cloud-platform
    • https://www.googleapis.com/auth/cloud-platform.read-only

Varsayılan kapsamlar: Hem Earth Engine Kod Düzenleyici hem de istemci kitaplıkları (ör. ee.Authenticate()) tarafından yapılandırılan varsayılan kapsamlar, şu kapsamların tümünü içerir: earthengine, cloud-platform ve drive (ayrıntılar için yukarıya bakın). Bu nedenle, kapsam özelleştirme (örneğin, ee.Authenticate(scopes=[...]) içinde scopes parametresini kullanma) yalnızca izinlerin sınırlandırılmasını gerektiren belirli güvenlik kısıtlamalarınız veya kuruluş politikalarınız varsa gereklidir.

Sorun giderme

Cloud projesi oluşturamıyorsam ne yapmalıyım?

Bazı kuruluşlar, kimlerin Cloud projesi oluşturabileceğini kontrol eder. Proje oluşturmaya çalışırken Notebook Authenticator sayfasında hata alırsanız deneyebileceğiniz birkaç yöntem vardır:

  1. Gerekli izinlere sahip olup olmadığınızı doğrulamak için doğrudan proje oluşturmayı deneyin.
  2. Proje oluşturmak için hangi süreçlerin mevcut olduğunu öğrenmek üzere kuruluşunuzun yöneticisiyle görüşün.
  3. Kuruluş dışı bir hesaptan proje oluşturun ve iş için kullandığınız hesabı projenin sahibi olarak ekleyin. Not: Bazı kuruluşların, harici projelerden OAuth istemcilerine erişimi engelleyen güvenlik politikaları vardır.

Hata: "Earth Engine API, XXX projesinde daha önce kullanılmadı veya devre dışı bırakıldı"

Öncelikle ee.Initialize() üzerinde veya komut satırında bir proje yapılandırdığınızdan emin olun (Cloud ve Colab tarafından sağlanan varsayılan projelerde Earth Engine etkinleştirilmez). İkinci olarak, projenizde Earth Engine API'nin etkinleştirildiğinden emin olun.

Hata: "Projede uyumsuz bir OAuth2 istemci yapılandırması var"

Cloud projelerinde yalnızca bir OAuth2 istemci yapılandırması olabilir. Bir bulut projesinde OAuth2 istemci yapılandırması olup olmadığını kontrol etmek için Kimlik Bilgileri sayfasındaki OAuth 2.0 istemci kimliklerine bakabilirsiniz. Notebook Authenticator tarafından yapılandırılmış uyumlu bir yapılandırmaya sahip başka bir Cloud projesi seçmeniz veya OAuth2 istemcisi olmayan bir Cloud projesi seçmeniz ya da oluşturmanız gerekir. Kimlik doğrulayıcı, bu projeyi otomatik olarak yapılandırır. Maalesef OAuth sistemi, kullanıcıların yapılandırmaları silmesine izin vermediğinden farklı bir proje kullanmanız gerekir. Bu projenin, diğer Earth Engine çalışmaları için kullanılan projeyle aynı olması gerekmez. Bu hatanın Colab modunda oluşmadığını unutmayın.

Hata: "gcloud başarısız oldu. Lütfen yukarıda hata olup olmadığını kontrol edin ve gerekirse gcloud'u yükleyin."

gcloud yüklü değilse veya PATH'inizde yoksa bu hatayla karşılaşabilirsiniz. Bu hata, bir not defteri kod hücresinden ee.Authenticate(auth_mode='gcloud') işlevini çağırdığınızda da ortaya çıkabilir. Bunun yerine, varsayılan olarak not defteri modu kimlik doğrulamasını kullanan ee.Authenticate() komutunu kullanın. Proje oluşturamıyorsanız yukarıdaki çözüme bakın.

gcloud'u yüklemek için yerel bir makineye erişimim yoksa ne yapmalıyım?

Yerel terminale erişiminiz olmadan yalnızca web ortamında çalışıyorsanız ve yine de uzak terminal kullanmanız gerekiyorsa earthengine authenticate --auth_mode=notebook komutunu çalıştırarak not defteri modunu tetikleyip komut satırı aracını başlatabilirsiniz.

400 hatası: redirect_uri_mismatch

Bir web tarayıcısına erişimi olmayan uzak bir makinede kimlik doğrulaması yapıyorsanız bu hatayı alabilirsiniz. Komut satırından earthengine authenticate çalıştırıyorsanız --quiet, Python istemcisini kullanıyorsanız ee.Authenticate(quiet=True) eklemeyi deneyin. Bu işlem için web tarayıcısına erişimi olan bir makineden gcloud ile kimlik doğrulamanız gerekir.

Hata: "Uygulamanız, yerel Uygulama Varsayılan Kimlik Bilgileri'ni kullanarak kimlik doğrulaması yapıyor. earthengine.googleapis.com API, varsayılan olarak ayarlanmayan bir kota projesi gerektirir."

Bu hata, Earth Engine proje kimliğinizi belirleyemediğinde ortaya çıkabilir. Google Cloud sorun giderme seçenekleri işe yaramazsa earthengine set_project YOUR_PROJECT_ID veya gcloud auth application-default set-quota-project YOUR_PROJECT_ID komutunu çalıştırmayı deneyin.

Hata: "[Cloud Storage / BigQuery] için gerekli kapsamlar eksik"

Bu hata, bir Earth Engine isteği Cloud Storage veya BigQuery kaynaklarına eriştiğinde ancak Earth Engine'i başlatmak için kullanılan kimlik bilgileri, ilgili hizmet için gerekli kapsamları (veya tüm Google Cloud hizmetlerini kapsayan cloud-platform kapsamını) içermediğinde ortaya çıkar. Bu durum genellikle kimlik doğrulama sırasında scopes parametresini özelleştirdiyseniz (örneğin, ee.Authenticate(scopes=[...]) için yalnızca Earth Engine kapsamları sağladıysanız) veya mevcut kimlik bilgileri bu kapsamlar olmadan oluşturulduysa meydana gelir.

Bu sorunu çözmenin iki yolu vardır:

  • Varsayılan kapsamlarla yeniden kimlik doğrulama: Earth Engine için varsayılan kimlik bilgileri, hem Cloud Storage hem de BigQuery'yi kapsayan cloud-platform kapsamını içerir. Varsayılan ayarları kullanarak yeniden kimlik doğrulama:
    • Python'da: ee.Authenticate(force=True)
    • Komut satırında: earthengine authenticate --force
  • Gerekli kapsamları ekleyin: Ortamınızda kapsamların özelleştirilmesi gerekiyorsa scopes listenizin https://www.googleapis.com/auth/cloud-platform veya belirli hizmet kapsamını (ör. Cloud Storage için https://www.googleapis.com/auth/devstorage.full_control ya da https://www.googleapis.com/auth/devstorage.read_only, BigQuery için https://www.googleapis.com/auth/bigquery) içerdiğinden emin olun.

Kullanılabilir kapsamlar hakkında daha fazla bilgi için Kapsamlarla ilgili ayrıntılar başlıklı makaleyi inceleyin.

Teknik notlar

Teknik ayrıntıları merak edenler için: Farklı kimlik bilgisi oluşturma mekanizmalarına duyulan ihtiyaç, kimlik bilgilerinin bilinen ve güvenilir bir ortama aktarılması gerekliliğinden kaynaklanır. Yukarıdaki farklı durumları kısaca ele alalım.

  • Eskiden, herhangi bir yere yapıştırabileceğiniz bir jeton veren paste modu vardı. Bu mod çok riskli olduğu için artık kullanılamıyor.
  • colab: auth.authenticate_user(), kimlik bilgilerini "Colab" kimlik doğrulama istemcisiyle (not defteri ortamının kendisi) paylaşmanızı ister. Bu veriler daha sonra google.auth.default() üzerinden kullanılabilir ve ee.Initialize() tarafından kullanılır.
  • localhost: Kimlik bilgileri, tarayıcıdan yerel makinenizdeki bir bağlantı noktasına iletilir. Bu durumda uçtan uca güvenlik, yerel makinenizin güvenliğinin ihlal edilmemiş olmasına bağlıdır. Göreceğiniz kimlik doğrulama istemcisi "Earth Engine Authenticator"dır.
  • gcloud: Bu, gcloud referansında açıklanan --launch-browser akışını ve uzak bir makinedeyse --no-launch-browser kullanır. Kullanılan kimlik doğrulama istemcisi "Google Auth Library"dir.
  • notebook: Çalışmanıza özel yeni bir kimlik doğrulama istemcisi oluştururuz. İzin sayfasında e-posta adresinizi görürsünüz. Bu istemci, eski yapıştırma modu jetonlarına izin veren özel bir durum olan "geliştirme" moduna ayarlanmıştır. Bu tür istemciler çok sayıda kullanıcıyla paylaşılamadığından bu işlem için kendi projenizi kullanmanız gerekir.