Method: projects.assets.listAssets

هر دارایی کانتینری مانند پوشه یا مجموعه را فهرست می کند.

درخواست HTTP

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

URL از دستور GRPC Transcoding استفاده می کند.

پارامترهای مسیر

پارامترها
parent

string

مورد نیاز. نام دارایی کانتینری که باید فهرست شود. parent از قالب "projects/*" یا "projects/*/assets/**" (به عنوان مثال، "projects/[PROJECT]" یا "projects/earthengine-legacy/assets/users/[USER]/[ASSET]" است. همه دارایی‌های متعلق به کاربر در حال حاضر تحت پروژه "میراث زمینی" قرار دارند (به عنوان مثال، "پروژه‌ها/جنبه-میراث/دارایی/کاربران/فو/بار"). همه دارایی های دیگر تحت پروژه "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 .