公告：凡是在
2025 年 4 月 15 日前註冊使用 Earth Engine 的非商業專案，都必須
驗證非商業用途資格，才能繼續存取 Earth Engine。
Method: projects.assets.create
透過集合功能整理內容
你可以依據偏好儲存及分類內容。
HTTP 要求
POST https://earthengine.googleapis.com/v1alpha/{parent=projects/*}/assets
這個網址使用 gRPC 轉碼語法。
路徑參數
| 參數 |
parent |
string
必要欄位。素材資源集合的父項 (例如「projects/*」)。
授權需要指定資源 parent 的下列 IAM 權限：
earthengine.assets.create
|
查詢參數
| 參數 |
assetId |
string
要建立的素材資源 ID。與名稱相同，但不含「projects/*/assets」(例如 users/[USER]/[ASSET])。
|
overwrite |
boolean
是否允許覆寫圖片素材資源。
|
要求主體
要求主體包含 EarthEngineAsset 的例項。
回應主體
如果成功，回應主體會包含新建立的 EarthEngineAsset 例項。
授權範圍
需要下列其中一種 OAuth 範圍：
https://www.googleapis.com/auth/earthengine
https://www.googleapis.com/auth/cloud-platform
詳情請參閱 OAuth 2.0 Overview。
除非另有註明，否則本頁面中的內容是採用創用 CC 姓名標示 4.0 授權，程式碼範例則為阿帕契 2.0 授權。詳情請參閱《Google Developers 網站政策》。Java 是 Oracle 和/或其關聯企業的註冊商標。
上次更新時間：2025-07-25 (世界標準時間)。
[null,null,["上次更新時間：2025-07-25 (世界標準時間)。"],[[["\u003cp\u003eCreates a new Earth Engine asset within a specified project.\u003c/p\u003e\n"],["\u003cp\u003eSupports creating folders, images, and image collections with specific requirements for each type.\u003c/p\u003e\n"],["\u003cp\u003eRequires authorization with appropriate IAM permissions or OAuth scopes.\u003c/p\u003e\n"],["\u003cp\u003eAllows specifying asset ID and optional overwriting of existing image assets.\u003c/p\u003e\n"],["\u003cp\u003eReturns the newly created EarthEngineAsset upon successful completion.\u003c/p\u003e\n"]]],[],null,["# Method: projects.assets.create\n\nCreates an asset.\n\nThe following asset types are createable: \\* `FOLDER`: No fields in `asset` may be specified. \\* `IMAGE`: To create a COG-backed asset, use `image.importExternal` instead. See \u003chttps://developers.google.com/earth-engine/Earth_Engine_asset_from_cloud_geotiff\u003e for more details. \\* `IMAGE_COLLECTION`: Only the fields `startTime`, `endTime`, and `properties` may be specified.\n\n### HTTP request\n\n`POST https://earthengine.googleapis.com/v1alpha/{parent=projects/*}/assets`\n\nThe URL uses [gRPC Transcoding](https://google.aip.dev/127) syntax.\n\n### Path parameters\n\n| Parameters ||\n|----------|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `parent` | `string` Required. The parent of the asset collection (e.g., \"projects/\\*\"). Authorization requires the following [IAM](https://cloud.google.com/iam/docs/) permission on the specified resource `parent`: - `earthengine.assets.create` |\n\n### Query parameters\n\n| Parameters ||\n|-------------|-----------------------------------------------------------------------------------------------------------------------------------|\n| `assetId` | `string` The ID of the asset to create. Equivalent to name but without the \"projects/\\*/assets\" (e.g., users/\\[USER\\]/\\[ASSET\\]). |\n| `overwrite` | `boolean` Whether to allow overwriting an image asset. |\n\n### Request body\n\nThe request body contains an instance of [EarthEngineAsset](/earth-engine/reference/rest/v1alpha/projects.assets#EarthEngineAsset).\n\n### Response body\n\nIf successful, the response body contains a newly created instance of [EarthEngineAsset](/earth-engine/reference/rest/v1alpha/projects.assets#EarthEngineAsset).\n\n### Authorization scopes\n\nRequires one of the following OAuth scopes:\n\n- `https://www.googleapis.com/auth/earthengine`\n- `\n https://www.googleapis.com/auth/cloud-platform`\n\nFor more information, see the [OAuth 2.0 Overview](/identity/protocols/OAuth2)."]]
