Method: projects.assets.listAssets

הצגת רשימה של נכסי מאגר, כמו תיקייה או אוסף.

בקשת HTTP

GET https://earthengine.googleapis.com/v1alpha/{parent=projects/*/assets/**}:listAssets

כתובת ה-URL משתמשת בתחביר של Transcoding של gRPC.

פרמטרים של נתיב

פרמטרים
parent

string

חובה. השם של נכס הקונטיינר שרוצים להציג ברשימה. parent צריך להיות בפורמט 'projects/*' או 'projects/*/assets/**' (למשל, "projects/[PROJECT]" או "projects/earthengine-legacy/assets/users/[USER]/[ASSET]"). כל הנכסים שבבעלות המשתמשים נמצאים כרגע בפרויקט earthengine-legacy (למשל, "projects/earthengine-legacy/assets/users/foo/bar"). כל שאר הנכסים נמצאים בפרויקט earthengine-public (למשל, "projects/earthengine-public/assets/LANDSAT"). אם מציינים את הערך 'projects/earthengine-legacy', התשובה תכלול רשימה של כל התיקיות ברמה העליונה שבבעלות המשתמש המבקש.

כדי לקבל הרשאה, נדרשת אחת או יותר מההרשאות הבאות של IAM במשאב שצוין parent:

  • earthengine.assets.get
  • earthengine.assets.list

פרמטרים של שאילתה

פרמטרים
pageSize

integer

המספר המקסימלי של תוצאות בדף. יכול להיות שהשרת יחזיר פחות נכסים ממה שביקשת. אם לא מציינים ערך, ברירת המחדל של גודל הדף תלויה ב-EarthEngineAssetView, עם מגבלות גבוהות יותר בתצוגות מגבילות יותר.

pageToken

string

אסימון שמזהה דף תוצאות שהשרת אמור להציג. בדרך כלל זהו הערך של ListAssetsResponse.next_page_token שהוחזר מהקריאה הקודמת לשיטה assets.listAssets.

filter

string

אם הוא מופיע, הוא מציין מסנן. המסננים חלים רק על נכסי ImageCollection, והמערכת מתעלמת מהם לגבי נכסי Folder.

השדות startTime, endTime והחברים ב-properties מזוהים. הפונקציה המותאמת אישית intersects(str) זמינה, ומאפשרת סינון לפי גיאומטריה.

דוגמה למסנן תאריך:

"startTime>\"2020-01-01T00:00:00+00:00\" AND
endTime<\"2020-02-01T00:00:00+00:00\""

דוגמה למסנן נכסים:

"properties.CLOUDY_PIXEL_PERCENTAGE<30"

דוגמה למסנן גיאומטריה:

"intersects(\"{'type':'Point','coordinates':[1,2]}\")"
"intersects(\"{\\\"type\\\":\\\"Point\\\",\\\"coordinates\\\":[1,2]}\")"

למידע נוסף על שפת המסנן, אפשר לעיין במאמר https://google.aip.dev/160.

view

enum (EarthEngineAssetView)

מציין אילו חלקים של המשאב EarthEngineAsset צריכים להוחזר בתגובה. רלוונטי רק לנכסי ImageCollection. כל האלמנטים של נכסי Folder יקודרו בתצוגה BASIC, ללא קשר לערך של השדה הזה.

גוף הבקשה

גוף הבקשה חייב להיות ריק.

גוף התשובה

אם הפעולה מצליחה, גוף התגובה מכיל מופע של ListAssetsResponse.

היקפי הרשאה

נדרש אחד מהיקפי ההרשאות הבאים של OAuth:

  • https://www.googleapis.com/auth/earthengine
  • https://www.googleapis.com/auth/earthengine.readonly
  • https://www.googleapis.com/auth/cloud-platform
  • https://www.googleapis.com/auth/cloud-platform.read-only

מידע נוסף זמין בOAuth 2.0 Overview.