Method: projects.assets.patch

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

  • 更新できるのは、アセットの 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/v1/{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)

アセットに関連付けられたキーと値のプロパティ。
asset.startTime

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.endTime

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.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"。
ラスター タイルの保存場所と保存方法に関する情報。相互に排他的なフィールドのリストは次のとおりです。レスポンスでは、これらのフィールドのいずれか 1 つが設定されます。
asset.cloudStorageLocation
(deprecated)

object (CloudStorageLocation)

非推奨です。代わりに ImportExternalImage を使用してください。詳細については、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 をご覧ください。