アセットを更新します。更新オペレーションには、いくつかの制約があります。
- 更新できるのは、アセットの
title
、description
、startTime
、endTime
、properties
フィールドのみです。 updateMask
で"properties"
という名前を付けると、アセットのすべてのユーザー定義プロパティがasset
のプロパティに置き換えられます。updateMask
で"title"
、"description"
、"startTime"
、または"endTime"
という名前を付け、asset
で値を指定しない場合、そのフィールドは設定されません。- 個々のプロパティを更新するには、
updateMask
で名前を指定します(例:"properties.my_property_name"
)。プロパティの値は、asset.properties
の対応する値に設定されます。asset.properties
に対応する値がない場合、または値があってもNullValue
の場合、プロパティはアセットから削除されます。 - プロパティには文字列値または数値のみを設定できます。また、
NullValue
を指定して削除することもできます。 - 空の
updateMask
を指定すると、アセットのタイムスタンプとプロパティがすべてasset
の値に置き換えられます。
HTTP リクエスト
PATCH https://earthengine.googleapis.com/v1beta/{asset.name=projects/*/assets/**}
この URL は gRPC Transcoding 構文を使用します。
パスパラメータ
パラメータ | |
---|---|
asset.name |
アセットの名前です。 |
リクエストの本文
リクエストの本文には、次の構造のデータが含まれます。
JSON 表現 |
---|
{ "asset": { "cloudStorageLocation": { "uris": [ string ] }, "featureViewAssetLocation": { "assetOptions": { object ( |
フィールド | |
---|---|
asset.type |
アセットのタイプ。 |
asset.id |
アセットの ID。「projects/*/assets/」接頭辞のない |
asset.updateTime |
アセットの最終更新日時。 RFC 3339 を使用します。生成された出力は常に Z 正規化され、小数点以下は 0、3、6、または 9 桁になります。「Z」以外のオフセットも使用できます。例: |
asset.properties |
アセットに関連付けられた Key-Value プロパティ。 |
asset.startTime |
アセットに関連付けられたタイムスタンプ(ある場合)。たとえば、衛星画像が撮影された時刻などです。1 か月または 1 年間の平均値など、期間に対応するアセットの場合、このタイムスタンプはその期間の開始に対応します。 RFC 3339 を使用します。生成された出力は常に Z 正規化され、小数点以下は 0、3、6、または 9 桁になります。「Z」以外のオフセットも使用できます。例: |
asset.endTime |
期間に対応するアセット(1 か月または 1 年間の平均値など)の場合、このタイムスタンプは期間の終了時刻(除く)に対応します。 RFC 3339 を使用します。生成された出力は常に Z 正規化され、小数点以下は 0、3、6、または 9 桁になります。「Z」以外のオフセットも使用できます。例: |
asset.geometry |
アセットに関連付けられている空間フットプリント(GeoJSON ジオメトリ オブジェクトとして指定可能)(RFC 7946 を参照)。 |
asset.bands[] |
画像アセットのデータバンドに関する情報。画像以外のアセットの場合は省略されます。 |
asset.sizeBytes |
リーフ アセット(画像など)のサイズ(バイト単位)。 |
asset.featureCount |
アセット内の特徴の数(該当する場合)。 |
asset.quota |
フォルダ アセットに関連付けられている割り当て情報(存在する場合)。ユーザー所有の最上位フォルダアセット(「users/*」や「projects/*」など)に対して返されます。 |
asset.tilesets[] |
この画像を基盤とするタイルセット。Earth Engine が所有していないストレージからピクセルが取得される外部画像にのみ存在します。 |
updateMask |
更新するアセットのフィールドを指定する更新マスク。 完全修飾フィールド名のカンマ区切りリスト。例: |
共用体フィールド location 。ラスタータイルが保存される場所と方法に関する情報。location は次のいずれかになります。 |
|
asset.cloudStorageLocation |
非推奨です。代わりに |
asset.featureViewAssetLocation |
EE 内のこの FeatureView の場所。 |
レスポンスの本文
成功した場合、レスポンスの本文には EarthEngineAsset
のインスタンスが含まれます。
認可スコープ
以下のいずれかの OAuth スコープが必要です。
https://www.googleapis.com/auth/earthengine
https://www.googleapis.com/auth/cloud-platform
詳細については、OAuth 2.0 Overview をご覧ください。