Method: projects.assets.patch

アセットを更新します。更新オペレーションには、いくつかの制約があります。

  • 更新できるのは、アセットの titledescriptionstartTimeendTimeproperties フィールドのみです。
  • 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

string

アセットの名前です。name の形式は「projects/*/assets/**」です(例:「projects/earthengine-legacy/assets/users//」)。

リクエストの本文

リクエストの本文には、次の構造のデータが含まれます。

JSON 表現
{
  "asset": {
    "cloudStorageLocation": {
      "uris": [
        string
      ]
    },
    "featureViewAssetLocation": {
      "assetOptions": {
        object (FeatureViewOptions)
      }
    },
    "type": enum (Type),
    "name": string,
    "id": string,
    "updateTime": string,
    "properties": {
      "fields": {
        string: value,
        ...
      }
    },
    "startTime": string,
    "endTime": string,
    "geometry": {
      "fields": {
        string: value,
        ...
      }
    },
    "bands": [
      {
        "id": string,
        "dataType": {
          object (PixelDataType)
        },
        "grid": {
          object (PixelGrid)
        },
        "pyramidingPolicy": enum (PyramidingPolicy),
        "missingData": {
          object (MissingData)
        }
      }
    ],
    "sizeBytes": string,
    "featureCount": string,
    "quota": {
      "sizeBytes": string,
      "maxSizeBytes": string,
      "assetCount": string,
      "maxAssets": string
    },
    "tilesets": [
      {
        "id": string,
        "sources": [
          {
            object (ImageSource)
          }
        ],
        "dataType": enum (DataType),
        "crs": string
      }
    ]
  },
  "updateMask": string
}
フィールド
asset.type

enum (Type)

アセットのタイプ。

asset.id

string

アセットの ID。「projects/*/assets/」接頭辞のない name と同等です(例: 「users//」)。なお、これは表示専用です。別のオペレーションの入力として使用しないでください。代わりに name を使用してください。

asset.updateTime

string (Timestamp format)

アセットの最終更新日時。

RFC 3339 を使用します。生成された出力は常に Z 正規化され、小数点以下は 0、3、6、または 9 桁になります。「Z」以外のオフセットも使用できます。例: "2014-10-02T15:01:23Z""2014-10-02T15:01:23.045123456Z""2014-10-02T15:01:23+05:30"

asset.properties

object (Struct format)

アセットに関連付けられた Key-Value プロパティ。

asset.startTime

string (Timestamp format)

アセットに関連付けられたタイムスタンプ(ある場合)。たとえば、衛星画像が撮影された時刻などです。1 か月または 1 年間の平均値など、期間に対応するアセットの場合、このタイムスタンプはその期間の開始に対応します。

RFC 3339 を使用します。生成された出力は常に Z 正規化され、小数点以下は 0、3、6、または 9 桁になります。「Z」以外のオフセットも使用できます。例: "2014-10-02T15:01:23Z""2014-10-02T15:01:23.045123456Z""2014-10-02T15:01:23+05:30"

asset.endTime

string (Timestamp format)

期間に対応するアセット(1 か月または 1 年間の平均値など)の場合、このタイムスタンプは期間の終了時刻(除く)に対応します。

RFC 3339 を使用します。生成された出力は常に Z 正規化され、小数点以下は 0、3、6、または 9 桁になります。「Z」以外のオフセットも使用できます。例: "2014-10-02T15:01:23Z""2014-10-02T15:01:23.045123456Z""2014-10-02T15:01:23+05:30"

asset.geometry

object (Struct format)

アセットに関連付けられている空間フットプリント(GeoJSON ジオメトリ オブジェクトとして指定可能)(RFC 7946 を参照)。

asset.bands[]

object (ImageBand)

画像アセットのデータバンドに関する情報。画像以外のアセットの場合は省略されます。

asset.sizeBytes

string (int64 format)

リーフ アセット(画像など)のサイズ(バイト単位)。

asset.featureCount

string (int64 format)

アセット内の特徴の数(該当する場合)。

asset.quota

object (FolderQuota)

フォルダ アセットに関連付けられている割り当て情報(存在する場合)。ユーザー所有の最上位フォルダアセット(「users/*」や「projects/*」など)に対して返されます。

asset.tilesets[]

object (Tileset)

この画像を基盤とするタイルセット。Earth Engine が所有していないストレージからピクセルが取得される外部画像にのみ存在します。

updateMask

string (FieldMask format)

更新するアセットのフィールドを指定する更新マスク。

完全修飾フィールド名のカンマ区切りリスト。例: "user.displayName,photo"

共用体フィールド location。ラスタータイルが保存される場所と方法に関する情報。location は次のいずれかになります。
asset.cloudStorageLocation
(deprecated)

object (CloudStorageLocation)

非推奨です。代わりに image.importExternal を使用してください。詳しくは、https://developers.google.com/earth-engine/Earth_Engine_asset_from_cloud_geotiff をご覧ください。

asset.featureViewAssetLocation

object (FeatureViewLocation)

EE 内のこの FeatureView の場所。

レスポンスの本文

成功した場合、レスポンスの本文には EarthEngineAsset のインスタンスが含まれます。

認可スコープ

以下のいずれかの OAuth スコープが必要です。

  • https://www.googleapis.com/auth/earthengine
  • https://www.googleapis.com/auth/cloud-platform

詳細については、OAuth 2.0 Overview をご覧ください。