Method: projects.assets.patch

Actualiza un activo. Existen varias restricciones en la operación de actualización:

  • Solo se pueden actualizar los campos title, description, startTime, endTime y properties del recurso.
  • Si asignas el nombre "properties" en updateMask, todas las propiedades definidas por el usuario del activo se reemplazarán por las propiedades de asset.
  • Si asignas el nombre "title", "description", "startTime" o "endTime" en updateMask y no proporcionas un valor en asset, ese campo no se establecerá.
  • Para actualizar propiedades individuales, puedes asignarles un nombre en updateMask, como "properties.my_property_name". El valor de la propiedad se establecerá en el valor correspondiente de asset.properties. Si no hay un valor correspondiente en asset.properties o si hay un valor, pero es un NullValue, la propiedad se borrará del activo.
  • Las propiedades solo se pueden establecer en valores de cadena o número, o bien borrarse si se especifica un NullValue.
  • Si proporcionas un updateMask vacío, las marcas de tiempo y las propiedades del recurso se reemplazarán por los valores de asset.

Solicitud HTTP

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

La URL usa la sintaxis de la transcodificación gRPC.

Parámetros de ruta de acceso

Parámetros
asset.name

string

El nombre del elemento. name tiene el formato "projects/*/assets/**" (p.ej., "projects/earthengine-legacy/assets/users//").

Cuerpo de la solicitud

El cuerpo de la solicitud contiene datos con la siguiente estructura:

Representación 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
}
Campos
asset.type

enum (Type)

Es el tipo de activo.
asset.id

string

El ID del activo. Es equivalente a name sin el prefijo "projects/*/assets/" (p.ej., "users//"). Ten en cuenta que esto es solo para fines de visualización. No se debe usar como entrada para otra operación. Usa name en su lugar.
asset.updateTime

string (Timestamp format)

Es la hora de la última modificación del activo.

Usa RFC 3339, en el que el resultado generado siempre se normalizará en Z y usará 0, 3, 6 o 9 dígitos fraccionarios. También se aceptan compensaciones distintas de "Z". Ejemplos: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" o "2014-10-02T15:01:23+05:30".
asset.properties

object (Struct format)

Propiedades clave-valor asociadas con el activo.
asset.startTime

string (Timestamp format)

Es la marca de tiempo asociada con el recurso, si corresponde, p.ej., la hora en la que se tomó una imagen satelital. En el caso de los recursos que corresponden a un intervalo de tiempo, como los valores promedio durante un mes o un año, esta marca de tiempo corresponde al inicio de ese intervalo.

Usa RFC 3339, en el que el resultado generado siempre se normalizará en Z y usará 0, 3, 6 o 9 dígitos fraccionarios. También se aceptan compensaciones distintas de "Z". Ejemplos: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" o "2014-10-02T15:01:23+05:30".
asset.endTime

string (Timestamp format)

En el caso de los recursos que corresponden a un intervalo de tiempo, como los valores promedio durante un mes o un año, esta marca de tiempo corresponde al final de ese intervalo (exclusivo).

Usa RFC 3339, en el que el resultado generado siempre se normalizará en Z y usará 0, 3, 6 o 9 dígitos fraccionarios. También se aceptan compensaciones distintas de "Z". Ejemplos: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" o "2014-10-02T15:01:23+05:30".
asset.geometry

object (Struct format)

La huella espacial asociada con el activo, si la hay, como un objeto de geometría GeoJSON (consulta RFC 7946).
asset.bands[]

object (ImageBand)

Información sobre las bandas de datos del recurso de imagen Se omite para los recursos que no son de imagen.
asset.sizeBytes

string (int64 format)

Es el tamaño de un recurso de nivel inferior (p.ej., una imagen) en bytes.
asset.featureCount

string (int64 format)

Es la cantidad de componentes del recurso, si corresponde.
asset.quota

object (FolderQuota)

La información de cuota asociada con el activo de la carpeta, si corresponde Se muestra para los recursos de carpetas de nivel superior que pertenecen al usuario (p.ej., "users/*" o "projects/*").
asset.tilesets[]

object (Tileset)

Los conjuntos de mosaicos que respaldan esta imagen Solo está presente para las imágenes externas, cuyos píxeles se recuperan del almacenamiento que no es propiedad de Earth Engine.
updateMask

string (FieldMask format)

La máscara de actualización que especifica qué campos del activo se deben actualizar.

Esta es una lista separada por comas de los nombres de campos totalmente calificados. Ejemplo: "user.displayName,photo".
Campo de unión location. Información sobre dónde y cómo se almacenan las tarjetas de ráster. Las direcciones (location) solo pueden ser una de las siguientes opciones:
asset.cloudStorageLocation
(deprecated)

object (CloudStorageLocation)

Obsoleta. Usa image.importExternal en su lugar. Consulta https://developers.google.com/earth-engine/Earth_Engine_asset_from_cloud_geotiff para obtener más detalles.
asset.featureViewAssetLocation

object (FeatureViewLocation)

La ubicación de este FeatureView en EE.UU.

Cuerpo de la respuesta

Si se ejecuta de forma correcta, el cuerpo de la respuesta contiene una instancia de EarthEngineAsset.

Alcances de autorización

Se necesita uno de los siguientes permisos de OAuth:

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

Para obtener más información, consulta OAuth 2.0 Overview.