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)

アセットに関連付けられたキーと値のプロパティ。
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"。
ラスター タイルの保存場所と保存方法に関する情報。以下は、相互に排他的なフィールドのリストです。レスポンスで設定されるフィールドは最大で 1 つです。
asset.cloudStorageLocation
(deprecated)

object (CloudStorageLocation)

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

object (GcsLocation)

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