Method: projects.assets.patch

Atualiza um recurso. Há várias restrições na operação de atualização:

  • Somente os campos title, description, startTime, endTime e properties do recurso podem ser atualizados.
  • Nomear "properties" em updateMask faz com que todas as propriedades definidas pelo usuário do recurso sejam substituídas pelas propriedades em asset.
  • Nomear "title", "description", "startTime" ou "endTime" em updateMask e não fornecer um valor em asset faz com que esse campo seja desdefinido.
  • É possível atualizar propriedades individuais nomeando-as em updateMask, como "properties.my_property_name". O valor da propriedade será definido como o valor correspondente de asset.properties. Se não houver um valor correspondente em asset.properties ou se houver um valor, mas ele for um NullValue, a propriedade será excluída do recurso.
  • As propriedades só podem ser definidas como valores de string ou número ou excluídas especificando um NullValue.
  • Fornecer um updateMask vazio faz com que os carimbos de data/hora e as propriedades do recurso sejam substituídos pelos valores em asset.

Solicitação HTTP

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

O URL usa a sintaxe de transcodificação gRPC.

Parâmetros de caminho

Parâmetros
asset.name

string

O nome do recurso. name está no formato "projects/*/assets/**" (por exemplo, "projects/earthengine-legacy/assets/users//").

Corpo da solicitação

O corpo da solicitação contém dados com a seguinte estrutura:

Representação 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)

Tipo do recurso.
asset.id

string

O ID do recurso. Equivalente a name sem o prefixo "projects/*/assets/" (por exemplo, "users//"). Observação: isso é apenas para fins de exibição. Não deve ser usado como entrada para outra operação. Use name.
asset.updateTime

string (Timestamp format)

A hora da última modificação do recurso.

Usa o padrão RFC 3339, em que a saída gerada é sempre convertida em Z e tem 0, 3, 6 ou 9 dígitos fracionários. Além de "Z", outros ajustes também são aceitos. Exemplos: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" ou "2014-10-02T15:01:23+05:30".
asset.properties

object (Struct format)

Propriedades de chave/valor associadas ao recurso.
asset.startTime

string (Timestamp format)

O carimbo de data/hora associado ao recurso, se houver, por exemplo, a hora em que uma imagem de satélite foi tirada. Para recursos que correspondem a um intervalo de tempo, como valores médios em um mês ou ano, esse carimbo de data/hora corresponde ao início desse intervalo.

Usa o padrão RFC 3339, em que a saída gerada é sempre convertida em Z e tem 0, 3, 6 ou 9 dígitos fracionários. Além de "Z", outros ajustes também são aceitos. Exemplos: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" ou "2014-10-02T15:01:23+05:30".
asset.endTime

string (Timestamp format)

Para recursos que correspondem a um intervalo de tempo, como valores médios em um mês ou ano, esse carimbo de data/hora corresponde ao final desse intervalo (exclusivo).

Usa o padrão RFC 3339, em que a saída gerada é sempre convertida em Z e tem 0, 3, 6 ou 9 dígitos fracionários. Além de "Z", outros ajustes também são aceitos. Exemplos: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" ou "2014-10-02T15:01:23+05:30".
asset.geometry

object (Struct format)

A área espacial associada ao recurso, se houver, como um objeto de geometria GeoJSON (consulte RFC 7946).
asset.bands[]

object (ImageBand)

Informações sobre as bandas de dados do recurso de imagem. Omitido para recursos que não são de imagem.
asset.sizeBytes

string (int64 format)

O tamanho de um recurso folha (por exemplo, uma imagem) em bytes.
asset.featureCount

string (int64 format)

O número de recursos no recurso, se aplicável.
asset.quota

object (FolderQuota)

As informações de cota associadas ao recurso de pasta, se houver. Retornado para recursos de pasta de propriedade do usuário de nível superior (por exemplo, "users/*" ou "projects/*").
asset.tilesets[]

object (Tileset)

Os conjuntos de blocos que oferecem suporte a essa imagem. Presente apenas para imagens externas, cujos pixels são recuperados de um armazenamento que não pertence ao Earth Engine.
updateMask

string (FieldMask format)

A máscara de atualização que especifica quais campos do recurso serão atualizados.

É uma lista separada por vírgulas de nomes de campos totalmente qualificados. Exemplo: "user.displayName,photo".
Informações sobre onde e como os blocos raster são armazenados. A seguir, há uma lista de campos mutuamente exclusivos. No máximo, um dos campos será definido em uma resposta:
asset.cloudStorageLocation
(deprecated)

object (CloudStorageLocation)

Obsoleto. Use ImportExternalImage. Consulte https://developers.google.com/earth-engine/Earth_Engine_asset_from_cloud_geotiff para mais detalhes.
asset.featureViewAssetLocation

object (FeatureViewLocation)

O local desse FeatureView no EE.
Fim dos campos mutuamente exclusivos.

Corpo da resposta

Se a solicitação for bem-sucedida, o corpo da resposta conterá uma instância de EarthEngineAsset.

Escopos de autorização

Requer um dos seguintes escopos do OAuth:

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

Para mais informações, consulte OAuth 2.0 Overview.