Method: projects.assets.listAssets

يسرد أي مادة عرض حاوية، مثل مجلد أو مجموعة.

طلب HTTP

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

يستخدِم عنوان URL بنية تحويل ترميز 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.