כדי לשלוח בקשות ל-Earth Engine באמצעות ספריית לקוח, צריך לבצע אימות ולהשתמש בפרטי הכניסה שנוצרו כדי להפעיל את הלקוח של Earth Engine.
עורך הקוד של Earth Engine ו-JavaScript
האימות וההפעלה מטופלים באופן אוטומטי בכלי לעריכת קוד. אתם יכולים לבחור לנתב בקשות דרך פרויקט בענן מההתחברות שלכם בפינה השמאלית העליונה של עורך הקוד.
אם אתם משתמשים ב-JavaScript API (מחוץ לעורך הקוד), השתמשו באחד מעזרי האימות ב-ee.data (לדוגמה, ee.data.authenticateViaPopup()) ואחריו ב-ee.initialize(), כמו שמוצג בדוגמה הזו.
Python ושורת הפקודה
לפני שמשתמשים בספריית הלקוח של Earth Engine ב-Python, צריך לבצע אימות (לאמת את הזהות) ולהשתמש בפרטי הכניסה שנוצרו כדי להפעיל את לקוח Python. תהליכי האימות משתמשים בפרויקטים ב-Cloud כדי לבצע אימות, והם משמשים לשימוש ללא תשלום (חינמי, לא מסחרי) וגם לשימוש בתשלום. כדי לאמת ולאתחל, מריצים את הפקודה הבאה:
ee.Authenticate()
ee.Initialize(project='my-project')
הפקודה הזו תבחר את מצב האימות הכי טוב לסביבה שלכם, ותבקש מכם לאשר את הגישה לסקריפטים. אם כבר קיימים פרטי כניסה, המערכת משתמשת בהם באופן אוטומטי. כדי ליצור פרטי כניסה חדשים, צריך להריץ את הפקודה ee.Authenticate(force=True).
בשלב האתחול המערכת מוודאת שקיימים פרטי כניסה תקינים, שנוצרו באמצעות ee.Authenticate() או שקיימים מראש כפרטי הכניסה שמוגדרים כברירת מחדל ב-Google. לאחר מכן, היא מפעילה את ספריית הלקוח של Python באמצעות שיטות שנתמכות על ידי שרת בק-אנד. תצטרכו לספק פרויקט שבבעלותכם או שיש לכם הרשאות להשתמש בו. כדי לרשום את הפרויקט ולהפעיל את Earth Engine API, עיינו במאמר הגדרת פרויקט ב-Cloud. הפרויקט הזה ישמש להפעלת כל הפעולות של Earth Engine.
בשורת הפקודה, הקריאה המקבילה היא earthengine authenticate. אם תוקף פרטי הכניסה פג או שהם לא תקינים, יכול להיות שתצטרכו להריץ את הפקודה earthengine
authenticate --force. הפעלות של שורת הפקודה יאותחלו בכל קריאה, ואפשר להשתמש בארגומנט --project כדי להגדיר את הפרויקט.
אפשר גם להגדיר פרויקט לכל הקריאות העתידיות על ידי הפעלת earthengine
set_project {my-project}. שורת הפקודה ו-ee.Initialize() ישתמשו בפרויקט הזה בכל פעם שלא מצוין פרויקט באופן ישיר. אם משתמשים באימות באמצעות gcloud (ראו בהמשך), הפרויקט שמוגדר על ידי gcloud auth application-default
set-quota-project {my-project} ישמש כמקרה סופי.
פרטי האימות
המטרה של תהליכי האימות ב-Earth Engine היא לקבל "אסימון" אבטחה מהחשבון שאליו נכנסתם, שאפשר לאחסן כדי לתת לסקריפטים שלכם הרשאה לגשת לנתונים. מטעמי אבטחה, מערכת האימות של Google תעביר טוקנים כאלה רק למערכות שאפשר לאבטח – ראו את ההערות הטכניות בהמשך.
בגלל הרגישות של סוגי המערכות שמעורבות, יש דרכים שונות להמשיך בהתאם למצב הספציפי שלכם. רוב האפשרויות נשלטות על ידי הפרמטר auth_mode: בתור ee.Authenticate(auth_mode=...) או earthengine authenticate --auth_mode=... בשורת הפקודה.
שימו לב שאם פרטי הכניסה של Google כבר קיימים בסביבה שלכם, יכול להיות שלא תצטרכו להפעיל את ee.Authenticate() בכלל. מכונות וירטואליות של Google Cloud, App Engine וסביבות אחרות מספקות "פרטי כניסה סביבתיים" שמישים, וגם gcloud auth
application-default login ייצור אותם.
עם זאת, מומלץ להשתמש ב-ee.Authenticate() בתחילת כל הסקריפטים כדי להבטיח תאימות מקסימלית. בלי הפרמטר auth_mode, הוא אמור לפעול ברוב המצבים, אבל אם מצב ברירת המחדל לא פועל, צריך לפעול לפי הפרטים שבהמשך.
מצב ברירת המחדל נבחר באופן הבא:
-
colabאם מריצים ב-נוטבוק של Google Colab -
notebookאם מריצים ב-notebooks אחרים של Jupyter שלא שייכים ל-Colab -
localhostאם מזוהה דפדפן אינטרנט ולא מותקן קובץ בינארי של gcloud -
gcloud, אחרת. במצב הזה צריך להתקין את gcloud.
מדריך וטבלה להתמצאות מהירה
במדריך הזה מפורטות האפשרויות השונות למקרה שמצב ברירת המחדל שנבחר על ידי ee.Authenticate() לא עובד. לדוגמה, אם אתם מריצים בסביבות אחרות של Notebook, יכול להיות שתצטרכו לציין את notebook באופן מפורש.
- בסביבה המקומית.
- "מקומי" פירושו שאתם מריצים קוד במעטפת Python או ב-notebook של Python במכונה שלפניכם – או ליתר דיוק, באותה מכונה שבה פועל דפדפן האינטרנט שלכם. זה כולל מצבים של שולחן עבודה מרוחק שבהם גם Python וגם הדפדפן נמצאים באותה מכונה (מרוחקת).
- השימוש ב-
auth_mode=localhostהוא הכי קל, והוא ייבחר כברירת מחדל אם gcloud לא מותקן, אבל הסקריפט יעבוד רק בסביבות מקומיות. - גם
auth_mode=gcloudוגםauth_mode=notebookזמינים.
- סביבה מרוחקת.
- "מרוחק" פירושו שהדפדפן נמצא במכונה אחת (מקומית) אבל הקוד פועל במקום אחר, כמו תחנת עבודה מרוחקת או Notebook מבוסס-אינטרנט.
- אם אתם משתמשים ב-Colab, השתמשו ב-
auth_mode=colab. אם אתם צריכים להגדיר אתscopesכדי לקרוא לממשקי API אחרים, השתמשו ב-gcloud. - אם אפשר להתקין את gcloud גם במכונה המרוחקת וגם במכונה המקומית, משתמשים ב-
auth_mode=gcloud. - אם אתם יכולים להשתמש בפרויקט אימות (ראו בהמשך), השתמשו ב-
auth_mode=notebook. - אם אתם לא יכולים להשתמש בפרויקט, להתקין את gcloud, להשתמש ב-Colab או להשתמש בדפדפן באותו מחשב:
- לפנות לאדמין (שוב) כדי ליצור פרויקטים. לדוגמה:
- מבקשים מהאדמין להגדיר פרויקט (כבעלים, כעורכים או כעורכי הגדרות OAuth).
- אפשר גם לבקש מהאדמין לתת לכם הרשאות ליצירת פרויקט.
בטבלה הזו מפורטים שילובי התכונות שנתמכים בכל מצב.
| למשרות מקומיות או מרחוק? | נדרש פרויקט | היקפים שניתן להגדיר | צריך CLI מקומי | Project Owner | |
|---|---|---|---|---|---|
localhost |
local | Y | כן | לא | לא |
colab |
שלט רחוק | Y | לא | לא | לא |
gcloud |
שניהם | Y | כן | לא | לא |
notebook |
שניהם | Y | כן | לא | Y |
פרטי כניסה לחשבונות שירות ול-Compute Engine
ee.Initialize() ישתמש בפרטי הכניסה של Earth Engine (ש-ee.Authenticate() מאחסן ב-~/.config/earthengine/credentials) או יאחזר פרטי כניסה מ-google.auth.default(), אבל אם צריך, אפשר להעביר ארגומנט credentials= כדי להשתמש בפרטי כניסה ממקום אחר, תוך עקיפת ברירות המחדל האלה.
אם אתם מאמתים קוד Python שיפעל ללא השגחה, יכול להיות שתרצו לבצע אימות באמצעות חשבון שירות במקום חשבון משתמש. במסמכים האלה מוסבר איך להשתמש בחשבונות שירות עם Earth Engine. שיטות אחרות כוללות את authenticate_service_account במודול האימות של Colab, ואת השיטות שמתוארות במדריך של Cloud לאימות כחשבון שירות.
אם הקוד פועל במכונה וירטואלית של Compute Engine, נוצר חשבון שירות שמוגדר כברירת מחדל לסביבה, שבו ee.Initialize() ישתמש כברירת מחדל. אם פרויקט בענן שדרכו הופעל ה-VM לא רשום לשימוש ב-Earth Engine (מסחרי או לשימוש לא מסחרי), יכול להיות שתצטרכו לרשום את חשבון השירות לשימוש ב-Earth Engine.
פרטים על המצבים
auth_mode=colab. ee.Authenticate() תיצור או תשיג את פרטי הכניסה שנתמכים כברירת מחדל ב-Colab, על ידי הפעלת colab.auth.authenticate_user() במקרה הצורך. פרטי הכניסה תמיד משתמשים בהיקף cloud-platform, ואפשר להשתמש בהם גם כדי לשלוח קריאות לממשקי Cloud API אחרים.
auth_mode=gcloud. הפקודה הזו מעבירה את האימות לכלי gcloud, והיא זהה להרצת gcloud auth application-default login עם היקפי ההרשאות שמוגדרים כברירת מחדל ב-Earth Engine (earthengine, cloud-platform ו-drive) או עם היקפי ההרשאות בארגומנט scopes. מצב gcloud פועל גם במקרים מקומיים וגם במקרים מרוחקים.
הוראות מפורטות למצב gcloud (מקרים מקומיים ומרוחקים)
- מוודאים ש-gcloud מותקן במחשב המקומי.
- בטרמינל, מריצים את הפקודה
gcloud help. אם gcloud לא מותקן, פועלים לפי ההוראות האלה כדי להתקין את gcloud.
- בטרמינל, מריצים את הפקודה
- טרמינל של מכונה מקומית
- בטרמינל, מריצים את הפקודה
earthengine authenticate. - פלט הפקודה יציין שנעשה שימוש ב-gcloud כדי לאחזר את פרטי הכניסה.
- ייפתח חלון בדפדפן עם דף לבחירת חשבון. אם הדפדפן לא נפתח באופן אוטומטי, לוחצים על כתובת ה-URL.
- בטרמינל, מריצים את הפקודה
- דפדפן: בחירת חשבון
- בוחרים את החשבון שרוצים להשתמש בו לאימות.
- דפדפן: מסך הסכמה
- מציינים אם רוצים להעניק את היקפי ההרשאות המבוקשים ולוחצים על "אישור".
- דפדפן: מסך אישור
- בדפדפן יוצג דף שמאשר שאתם מאומתים, ובפקודה
earthengine authenticateבחלון הטרמינל ידווח "Successfully saved authorization token". - במקרים נדירים, דף האינטרנט יספק לכם קוד להדבקה בחזרה בסביבת Python.
- בדפדפן יוצג דף שמאשר שאתם מאומתים, ובפקודה
- ממשיכים בתהליך האתחול.
auth_mode=localhost. זהו תהליך דמוי gcloud למקרים שבהם gcloud לא מותקן. הוא מבצע את אותם השלבים כמו gcloud, אבל פועל רק במקרה המקומי. אפשר לציין מספר יציאה אופציונלי לאינטרנט, למשל localhost:8086, או להשתמש ב-localhost:0 כדי לבחור יציאה באופן אוטומטי. יציאת ברירת המחדל היא 8085.
auth_mode=notebook. זהו מצב לשימוש כללי שנועד לפעול במצבים מרוחקים שבהם שורות פקודה מקומיות לא זמינות. הוא מעביר אתכם לדף Notebook Authenticator, שבו תצטרכו לבחור או ליצור "פרויקט אימות" – פרטים נוספים ומדריך לפתרון בעיות מופיעים בהמשך. הפרויקט שמועבר אל ee.Initialize() לא חייב להתאים לזה – אפשר להשתמש באותו פרויקט לאימות כשעובדים בפרויקטים שונים ב-notebooks שונים. מומלץ להעביר פרויקט באופן מפורש אל ee.Initialize(), אבל פרויקט האימות ישמש כברירת מחדל.
הוראות מפורטות למצב Notebook
- דפדפן: Notebook
- בתא קוד של Notebook, מריצים את הקוד הבא כדי להתחיל תהליך אימות באמצעות מצב notebook.
לוחצים על הקישור בפלט של התא כדי לפתוח את דף Notebook Authenticator בכרטיסייה חדשה.import ee ee.Authenticate()
- בתא קוד של Notebook, מריצים את הקוד הבא כדי להתחיל תהליך אימות באמצעות מצב notebook.
- דפדפן: Notebook Authenticator
- מוודאים שחשבון המשתמש הנכון מופיע ברשימה.
- בוחרים פרויקט בענן של Google שישמש לאימות. אם אתם צריכים ליצור פרויקט חדש, מומלץ להשתמש במוסכמה למתן שמות "ee-xyz", כאשר xyz הוא שם המשתמש הרגיל שלכם ב-Earth Engine. (אם אתם לא יכולים לבחור או ליצור פרויקט ב-Cloud, עיינו בקטע פתרון הבעיות שבהמשך).
- לוחצים על "יצירת טוקן".
- דפדפן: בחירת חשבון
- יוצג דף לבחירת חשבון. לוחצים על חשבון המשתמש שרוצים לתת לו גישה מה-notebook.
- דפדפן: דף אזהרה
- מוצג דף אזהרה שמציין ש-Google לא יצרה את האפליקציה (כלומר, הקוד ב-notebook). כדי לאשר, לוחצים על "המשך".
- דפדפן: מסך הסכמה
- מציינים אם אתם מוכנים להעניק את היקפי ההרשאות המבוקשים ולוחצים על Continue.
- דפדפן: מסך קוד ההרשאה
- מעתיקים את קוד האימות של ההרשאה.
- דפדפן: Notebook
- עוברים חזרה לכרטיסייה של ה-notebook ומדביקים את קוד האימות בפלט של התא ב-notebook.
- פלט התא אמור להציג את ההודעה "Successfully saved authorization token."
- ממשיכים בתהליך האתחול.
במצב Notebook יש פרמטר quiet שמשתמשים בו לעיתים רחוקות: אם הוא מוגדר, הוא פועל "באופן לא אינטראקטיבי" ולא מבקש מכם להזין את קוד האימות וממתין שתעשו זאת.
במקום זאת, הוא נותן פקודה להפעלה כדי לשמור את הקוד.
פרויקטים של אימות
אתם צריכים להיות בעלים, עורכים או עורכי הגדרות OAuth בפרויקט האימות שמשמש במצב Notebook. במקרים רבים, במיוחד בצוותים קטנים יותר, פרויקט האימות שבו אתם משתמשים בדף Notebook Authenticator יכול להיות זהה לפרויקט הראשי שבו אתם משתמשים לעבודה אחרת.
משיקולי אבטחה, "הגדרת לקוח OAuth" בפרויקט האימות היא הגדרה חד-פעמית. אם אתם או משתמשים אחרים הגדרתם לקוח OAuth בפרויקט מסיבות אחרות, אי אפשר להסיר אותו ותופיע הודעת השגיאה "incompatible OAuth2 client configuration". תצטרכו להשתמש בפרויקט אחר לאימות, או להשתמש במצבים colab, localhost או gcloud שלמעלה.
פרטים על היקפי הרשאות
הגדרות ברירת המחדל של האימות ב-Earth Engine כוללות את כל ההיקפים הזמינים, כך שאפשר לדלג על הקטע הזה אם הגדרות ברירת המחדל עונות על הדרישות שלכם.
היקפי ההרשאות של Earth Engine: היקף ההרשאות של OAuth 2.0 מגדיר ומגביל את קבוצת המשאבים והפעולות שלאפליקציה מותר לגשת אליהם בשם המשתמש. כשמשתמשים ב-OAuth כדי לבצע אימות ב-Earth Engine, צריך לבקש אחד או יותר מהיקפי ההרשאות הבאים:
-
https://www.googleapis.com/auth/earthengine: גישת קריאה וכתיבה לנכסים ולמשאבים של Earth Engine. נדרשת כדי ליצור, לשנות או למחוק נכסים, לנהל הרשאות לנכסים ולהריץ משימות ייצוא. -
https://www.googleapis.com/auth/earthengine.readonly: גישה לקריאה בלבד לנכסי Earth Engine.
שני ההיקפים מאפשרים להריץ סקריפטים וחישובים (כמו הערכת ביטויים או רינדור של תצוגות מפה).
היקפי הרשאות של Google Cloud ו-Drive: אם השאילתות או הסקריפטים של Earth Engine מפנים לנתונים או לנכסים חיצוניים, פרטי הכניסה צריכים לכלול גם את היקפי ההרשאות המתאימים לשירותים האלה:
- Cloud Storage (GCS) (כשקוראים מקטגוריות של Cloud Storage או כותבים אליהן, למשל כשמטעינים קובצי GeoTIFF שעברו אופטימיזציה לענן (COG) או מייצאים פלט של משימות):
https://www.googleapis.com/auth/devstorage.full_controlhttps://www.googleapis.com/auth/devstorage.read_writehttps://www.googleapis.com/auth/devstorage.read_only
- BigQuery (BQ) (כשקוראים טבלאות או כותבים נתונים לייצוא ל-BigQuery):
https://www.googleapis.com/auth/bigquery
- Google Drive (כשניגשים לנתונים או מייצאים אותם ל-Google Drive):
https://www.googleapis.com/auth/drivehttps://www.googleapis.com/auth/drive.readonly
ב-Google Cloud יש גם היקפי הרשאות רחבים שכוללים את כל שירותי Google Cloud:
- Cloud Platform (גישה רחבה לשירותי Google Cloud, כולל Earth Engine, Cloud Storage ו-BigQuery. שימו לב ש-Google Drive הוא שירות נפרד של Workspace וההיקפים האלה לא חלים עליו):
https://www.googleapis.com/auth/cloud-platformhttps://www.googleapis.com/auth/cloud-platform.read-only
היקפי הרשאות שמוגדרים כברירת מחדל: היקפי ההרשאות שמוגדרים כברירת מחדל על ידי עורך הקוד של Earth Engine וספריות הלקוח (כמו ee.Authenticate()) כוללים את כל היקפי ההרשאות הבאים: earthengine, cloud-platform ו-drive (לפרטים נוספים, ראו למעלה).
לכן, צריך להתאים אישית את ההיקף (לדוגמה, באמצעות הפרמטר scopes ב-ee.Authenticate(scopes=[...])) רק אם יש לכם אילוצי אבטחה ספציפיים או כללי מדיניות של הארגון שמחייבים להגביל את ההרשאות.
פתרון בעיות
מה לעשות אם לא הצלחתי ליצור פרויקט בענן?
בחלק מהארגונים יש הגבלות על מי יכול ליצור פרויקטים בענן. אם מופיעה הודעת שגיאה בדף Notebook Authenticator כשמנסים ליצור פרויקט, אפשר לנסות את הפתרונות הבאים:
- נסו ליצור פרויקט ישירות כדי לוודא שיש לכם את ההרשאות הנדרשות.
- כדי לברר מהם התהליכים הזמינים ליצירת פרויקט, פנו לאדמין של הארגון.
- ליצור פרויקט מחשבון לא ארגוני, ולהוסיף את החשבון שאתם משתמשים בו לעבודה כבעלים של הפרויקט. הערה: בחלק מהארגונים יש מדיניות אבטחה שמונעת גישה ללקוחות OAuth מפרויקטים חיצוניים.
שגיאה: "Earth Engine API has not been used in project XXX before or it is disabled"
קודם כל, ודאו שהגדרתם פרויקט ב-ee.Initialize() או בשורת הפקודה (בפרויקטים שמוגדרים כברירת מחדל ב-Cloud וב-Colab, Earth Engine לא מופעל). בשלב השני, מוודאים ש-Earth Engine API מופעל בפרויקט.
שגיאה: "הפרויקט כולל הגדרת לקוח OAuth2 לא תואמת"
לפרויקטים בענן יכולה להיות רק הגדרה אחת של לקוח OAuth2. כדי לבדוק אם לפרויקט בענן יש הגדרת לקוח OAuth2, בודקים את מזהי הלקוח של OAuth 2.0 בדף Credentials. צריך לבחור פרויקט אחר בענן שכבר הוגדרה בו תצורה תואמת על ידי Notebook Authenticator, או לבחור או ליצור פרויקט בענן בלי לקוחות OAuth2. המאמת יגדיר את הפרויקט הזה באופן אוטומטי. לצערנו, מערכת OAuth לא מאפשרת למשתמשים למחוק הגדרות, ולכן צריך להשתמש בפרויקט אחר. הפרויקט הזה לא חייב להיות אותו פרויקט שמשמש לעבודות אחרות ב-Earth Engine. חשוב לדעת שהשגיאה הזו לא מתרחשת במצב Colab.
שגיאה: "gcloud failed. צריך לבדוק אם יש שגיאות למעלה ולהתקין את gcloud במקרה הצורך".
השגיאה הזו יכולה להופיע אם gcloud לא מותקן או לא נמצא ב-PATH. היא יכולה להתרחש גם אם קוראים ל-ee.Authenticate(auth_mode='gcloud') מתוך תא קוד של Notebook. במקום זאת, השתמשו ב-ee.Authenticate(), שמשתמש כברירת מחדל באימות במצב notebook. אם אתם לא מצליחים ליצור פרויקט, נסו את הפתרון שלמעלה.
מה קורה אם אין לי גישה למכונה מקומית כדי להתקין את gcloud?
אם אתם עובדים בסביבה אינטרנטית בלבד בלי גישה לטרמינל מקומי, ואתם עדיין צריכים להשתמש בטרמינל מרוחק, אתם יכולים להפעיל את כלי שורת הפקודה על ידי הפעלת מצב notebook באמצעות הפקודה earthengine
authenticate --auth_mode=notebook.
שגיאה 400: redirect_uri_mismatch
השגיאה הזו יכולה להופיע אם אתם מבצעים אימות במכונה מרוחקת בלי גישה לדפדפן אינטרנט. נסו להוסיף את --quiet אם אתם מריצים את earthengine authenticate משורת הפקודה, או את ee.Authenticate(quiet=True) אם אתם משתמשים בלקוח Python. כדי לעשות את זה, תצטרכו לבצע אימות באמצעות gcloud ממכשיר שיש לו גישה לדפדפן אינטרנט.
השגיאה: "Your application is authenticating by using local Application Default Credentials. ל-API earthengine.googleapis.com נדרש פרויקט מכסה, שלא מוגדר כברירת מחדל".
השגיאה הזו יכולה להתרחש כש-Earth Engine לא יכול לקבוע את מזהה הפרויקט. אם האפשרויות לפתרון בעיות ב-Google Cloud לא עובדות, נסו להריץ את earthengine set_project YOUR_PROJECT_ID או את gcloud
auth application-default set-quota-project YOUR_PROJECT_ID.
שגיאה: "חסרים היקפי הרשאות נדרשים עבור [Cloud Storage / BigQuery]"
השגיאה הזו מתרחשת כשבקשה של Earth Engine ניגשת למשאבים של Cloud Storage או BigQuery, אבל פרטי הכניסה שמשמשים לאתחול של Earth Engine לא כוללים את ההיקפים הנדרשים לשירות הזה (או את ההיקף cloud-platform, שכולל את כל שירותי Google Cloud). בדרך כלל זה קורה אם התאמתם אישית את הפרמטר scopes במהלך האימות (לדוגמה, אם סיפקתם רק היקפי הרשאות של Earth Engine ל-ee.Authenticate(scopes=[...])) או אם פרטי הכניסה הקיימים נוצרו בלי היקפי ההרשאות האלה.
יש שתי דרכים לפתור את הבעיה:
- אימות מחדש עם היקפי הרשאות שמוגדרים כברירת מחדל: פרטי הכניסה שמוגדרים כברירת מחדל ל-Earth Engine כוללים את היקף ההרשאות
cloud-platform, שכולל גם את Cloud Storage וגם את BigQuery. מאמתים מחדש באמצעות הגדרות ברירת המחדל:- ב-Python:
ee.Authenticate(force=True) - בשורת הפקודה:
earthengine authenticate --force
- ב-Python:
- לכלול את ההיקפים הנדרשים: אם הסביבה שלכם דורשת התאמה אישית של ההיקפים, ודאו שהרשימה
scopesכוללת אתhttps://www.googleapis.com/auth/cloud-platformאו את היקף השירות הספציפי (כמוhttps://www.googleapis.com/auth/devstorage.full_controlאוhttps://www.googleapis.com/auth/devstorage.read_onlyל-Cloud Storage, אוhttps://www.googleapis.com/auth/bigqueryל-BigQuery).
למידע נוסף על ההיקפים הזמינים, ראו פרטים על היקפים.
הערות טכניות
לסקרנים מבחינה טכנית: הצורך במנגנונים השונים האלה ליצירת פרטי כניסה נובע מהצורך להעביר פרטי כניסה לסביבה מוכרת ומהימנה. הנה דיון קצר במקרים השונים שצוינו למעלה.
- בעבר היה מצב
pasteשנתן לכם אסימון להדביק בכל מקום, אבל הוא נחשב למסוכן מדי והוא כבר לא זמין. -
colab:auth.authenticate_user()יבקש מכם לשתף את פרטי הכניסה עם לקוח האימות של Colab, סביבת ה-notebook עצמה. אחר כך אפשר לגשת אליהם דרךgoogle.auth.default()והם משמשים אתee.Initialize(). -
localhost: פרטי הכניסה מועברים מהדפדפן ליציאה במכונה המקומית. במצב כזה, האבטחה מקצה לקצה תלויה בכך שהמכונה המקומית לא נפרצה. לקוח האימות שיוצג הוא Earth Engine Authenticator. -
gcloud: משתמשים בתהליך--launch-browserשמתואר בחומר העזר של gcloud, וב---no-launch-browserאם נמצאים במכונה מרוחקת. לקוח האימות שבו משתמשים הוא Google Auth Library. -
notebook: אנחנו יוצרים לקוח אימות חדש במיוחד בשביל העבודה שלכם – כתובת האימייל שלכם תופיע בדף ההסכמה. הלקוח הזה מוגדר במצב "פיתוח", שהוא מקרה מיוחד שמאפשר שימוש באסימונים של מצב ההדבקה הישן. אנחנו צריכים להשתמש בפרויקט שלכם, כי אי אפשר לשתף לקוחות כאלה עם מספר גדול של משתמשים.