Method: projects.assets.patch

Actualiza un recurso. 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 se nombra "properties" en updateMask, se reemplazarán todas las propiedades definidas por el usuario del recurso por las propiedades en asset.
  • Si se nombra "title", "description", "startTime" o "endTime" en updateMask y no se proporciona un valor en asset, ese campo se anulará.
  • Es posible actualizar propiedades individuales nombrándolas 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 recurso.
  • Las propiedades solo se pueden establecer en valores de cadena o numéricos, o bien se pueden borrar si se especifica un NullValue.
  • Si se proporciona un updateMask vacío, se reemplazarán las marcas de tiempo y las propiedades del recurso por los valores en asset.

Solicitud HTTP

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

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

Parámetros de ruta

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 recurso.
asset.id

string

El ID del recurso. Equivalente a name sin el prefijo "projects/*/assets/" (p.ej., "users//"). Ten en cuenta que esto solo está destinado a 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 recurso.

Usa el formato RFC 3339, en el que el resultado generado siempre usará la normalización Z y los dígitos fraccionarios 0, 3, 6 o 9. También se aceptan otras compensaciones que no sean “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)

Son las propiedades de clave/valor asociadas con el recurso.
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 el formato RFC 3339, en el que el resultado generado siempre usará la normalización Z y los dígitos fraccionarios 0, 3, 6 o 9. También se aceptan otras compensaciones que no sean “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 (exclusive).

Usa el formato RFC 3339, en el que el resultado generado siempre usará la normalización Z y los dígitos fraccionarios 0, 3, 6 o 9. También se aceptan otras compensaciones que no sean “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)

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

object (ImageBand)

Es la 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 hoja (p.ej., una imagen) en bytes.
asset.featureCount

string (int64 format)

Es la cantidad de atributos en el recurso, si corresponde.
asset.quota

object (FolderQuota)

Es la información de cuota asociada con el recurso de carpeta, si corresponde. Se muestra para los recursos de carpeta de nivel superior que son propiedad del usuario (p.ej., "users/*" o "projects/*").
asset.tilesets[]

object (Tileset)

Son 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)

Es la máscara de actualización que especifica qué campos del recurso se deben actualizar.

Esta es una lista separada por comas de los nombres de campos completamente calificados. Ejemplo: "user.displayName,photo".
Es la información sobre dónde y cómo se almacenan los mosaicos ráster. La siguiente es una lista de campos mutuamente excluyentes. Como máximo, se establecerá uno de los campos en una respuesta:
asset.cloudStorageLocation
(deprecated)

object (CloudStorageLocation)

Obsoleta. Usa ImportExternalImage 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)

Es la ubicación de esta FeatureView en EE.
Fin de los campos mutuamente excluyentes.

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.