Method: projects.listAssets

किसी कंटेनर ऐसेट की सूची बनाता है, जैसे कि फ़ोल्डर या कलेक्शन.

एचटीटीपी अनुरोध

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

यूआरएल में 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" तय किया गया है, तो जवाब में उन सभी टॉप-लेवल फ़ोल्डर की सूची होगी जिनका मालिकाना हक, अनुरोध करने वाले उपयोगकर्ता के पास है.

अनुमति पाने के लिए, दिए गए संसाधन parent पर, IAM की इनमें से एक या उससे ज़्यादा अनुमतियों की ज़रूरत होती है:

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

क्वेरी पैरामीटर

पैरामीटर
pageSize

integer

हर पेज पर नतीजों की ज़्यादा से ज़्यादा संख्या. ऐसा हो सकता है कि सर्वर, अनुरोध की गई संख्या से कम ऐसेट दिखाए. अगर पेज साइज़ की वैल्यू सबमिट नहीं की जाती है, तो पेज का डिफ़ॉल्ट साइज़ EarthEngineAssetView पर निर्भर करता है. साथ ही, ज़्यादा पाबंदी वाले व्यू के लिए, ज़्यादा सीमाएं होती हैं.

pageToken

string

नतीजों के उस पेज की पहचान करने वाला टोकन जिसे सर्वर को दिखाना चाहिए. आम तौर पर, यह projects.listAssets वाले तरीके के पिछले कॉल से मिली ListAssetsResponse.next_page_token की वैल्यू होती है.

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 देखें.