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/v1alpha/{asset.name=projects/*/assets/**}

この URL は gRPC Transcoding 構文を使用します。

パスパラメータ

パラメータ
asset.name

string

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

リクエストの本文

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

JSON 表現 
{
  "asset": {
    "cloudStorageLocation": {
      "uris": [
        string
      ]
    },
    "gcsLocation": {
      "uris": [
        string
      ]
    },
    "featureViewAssetLocation": {
      "assetOptions": {
        object (FeatureViewOptions)
      }
    },
    "type": enum (Type),
    "name": string,
    "id": string,
    "updateTime": string,
    "title": string,
    "description": 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,
      "maxAssetCount": 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.title
(deprecated)

string

アセットのタイトル。
asset.description
(deprecated)

string

アセットの説明。
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.gcsLocation
(deprecated)

object (GcsLocation)

非推奨です。代わりに 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 をご覧ください。