Method: projects.assets.patch

    • Only specific fields like title, description, startTime, endTime, and properties can be updated for an asset.

    • The updateMask field specifies which fields to update, and naming "properties" in it replaces all user-defined properties.

    • Individual properties can be updated by naming them in the updateMask using the format "properties.my_property_name".

    • Properties can be set to string or number values, or deleted using a NullValue .

    • An empty updateMask will replace the asset's timestamps and all properties with values from the asset field.

    Updates an asset. There are a number of constraints on the update operation:

    • Only the title , description , startTime , endTime , and properties fields of the asset can be updated.
    • Naming "properties" in updateMask results in all user-defined properties of the asset being replaced by the properties in asset .
    • Naming "title" , "description" , "startTime" or "endTime" in updateMask and not providing a value in asset results in that field becoming unset.
    • It is possible to update individual properties by naming them in updateMask , like "properties.my_property_name" . The property's value will be set to the corresponding value from asset.properties . If there is no corresponding value in asset.properties , or if there is a value but it is a NullValue , the property will be deleted from the asset.
    • Properties can be set only to string or number values, or deleted by specifying a NullValue .
    • Supplying an empty updateMask will result in the asset's timestamps and properties all being replaced by the values in asset .

    HTTP request

    PATCH https://earthengine.googleapis.com/v1alpha/{asset.name=projects/*/assets/**}

    The URL uses gRPC Transcoding syntax.

    Path parameters

    Parameters
    asset.name

    string

    The name of the asset. name is of the format "projects/*/assets/**" (e.g. "projects/earthengine-legacy/assets/users/ / ").

    Request body

    The request body contains data with the following structure:

    JSON representation 
     { 
 "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 
 }
    Fields
    asset.type

    enum ( Type )

    The type of the asset.

    asset.id

    string

    The ID of the asset. Equivalent to name without the "projects/*/assets/" prefix (e.g. "users/ / "). Note that this is intended for display purposes only. It should not be used as an input to another operation. Use name instead.

    asset.updateTime

    string ( Timestamp format)

    The last-modified time of the asset.

    Uses RFC 3339, where generated output will always be Z-normalized and uses 0, 3, 6 or 9 fractional digits. Offsets other than "Z" are also accepted. Examples: "2014-10-02T15:01:23Z" , "2014-10-02T15:01:23.045123456Z" or "2014-10-02T15:01:23+05:30" .

    asset.title
    (deprecated)

    string

    The title of the asset.

    asset.description
    (deprecated)

    string

    The description of the asset.

    asset.properties

    object ( Struct format)

    Key/value properties associated with the asset.

    asset.startTime

    string ( Timestamp format)

    The timestamp associated with the asset, if any, e.g. the time at which a satellite image was taken. For assets that correspond to an interval of time, such as average values over a month or year, this timestamp corresponds to the start of that interval.

    Uses RFC 3339, where generated output will always be Z-normalized and uses 0, 3, 6 or 9 fractional digits. Offsets other than "Z" are also accepted. Examples: "2014-10-02T15:01:23Z" , "2014-10-02T15:01:23.045123456Z" or "2014-10-02T15:01:23+05:30" .

    asset.endTime

    string ( Timestamp format)

    For assets that correspond to an interval of time, such as average values over a month or year, this timestamp corresponds to the end of that interval (exclusive).

    Uses RFC 3339, where generated output will always be Z-normalized and uses 0, 3, 6 or 9 fractional digits. Offsets other than "Z" are also accepted. Examples: "2014-10-02T15:01:23Z" , "2014-10-02T15:01:23.045123456Z" or "2014-10-02T15:01:23+05:30" .

    asset.geometry

    object ( Struct format)

    The spatial footprint associated with the asset, if any, as a GeoJSON geometry object (see RFC 7946).

    asset.bands[]

    object ( ImageBand )

    Information about the data bands of the image asset. Omitted for non-image assets.

    asset.sizeBytes

    string ( int64 format)

    The size of a leaf asset (e.g. an image) in bytes.

    asset.featureCount

    string ( int64 format)

    The number of features in the asset, if applicable.

    asset.quota

    object ( FolderQuota )

    The quota information associated with the folder asset, if any. Returned for top-level user-owned folder assets (e.g. "users/*" or "projects/*").

    asset.tilesets[]

    object ( Tileset )

    The tilesets backing this image. Only present for external images, whose pixels are retrieved from storage not owned by Earth Engine.

    updateMask

    string ( FieldMask format)

    The update mask specifying which fields of the asset to update.

    This is a comma-separated list of fully qualified names of fields. Example: "user.displayName,photo" .

    Union field location . Information about where and how the raster tiles are stored. location can be only one of the following:
    asset.cloudStorageLocation
    (deprecated)

    object ( CloudStorageLocation )

    Deprecated. Use image.importExternal instead. See https://developers.google.com/earth-engine/Earth_Engine_asset_from_cloud_geotiff for more details.

    asset.gcsLocation
    (deprecated)

    object ( GcsLocation )

    Deprecated. Use image.importExternal instead. See https://developers.google.com/earth-engine/Earth_Engine_asset_from_cloud_geotiff for more details.

    asset.featureViewAssetLocation

    object ( FeatureViewLocation )

    The location of this FeatureView in EE.

    Response body

    If successful, the response body contains an instance of EarthEngineAsset .

    Authorization scopes

    Requires one of the following OAuth scopes:

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

    For more information, see the OAuth 2.0 Overview .
    Create a Mobile Website
    View Site in Mobile | Classic
    Share by: