Method: projects.assets.patch

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

  • Apenas 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 redefinido.
  • É 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 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 vai resultar na substituição de todos os carimbos de data/hora e propriedades do recurso pelos valores em asset.

Solicitação HTTP

PATCH https://earthengine.googleapis.com/v1/{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 tem o 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//"). Isso é apenas para fins de exibição. Ele não deve ser usado como entrada para outra operação. Use name.
asset.updateTime

string (Timestamp format)

O horário da última modificação do recurso.

Usa o RFC 3339, em que a saída gerada é sempre normalizada em Z e usa dígitos fracionários 0, 3, 6 ou 9. Deslocamentos diferentes de "Z" 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, o horário 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 RFC 3339, em que a saída gerada é sempre normalizada em Z e usa dígitos fracionários 0, 3, 6 ou 9. Deslocamentos diferentes de "Z" 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 fim desse intervalo (exclusivo).

Usa o RFC 3339, em que a saída gerada é sempre normalizada em Z e usa dígitos fracionários 0, 3, 6 ou 9. Deslocamentos diferentes de "Z" 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 pegada espacial associada ao recurso, se houver, como um objeto de geometria GeoJSON (consulte RFC 7946).
asset.bands[]

object (ImageBand)

Informações sobre as faixas 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 de 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 da pasta, se houver. Retornado para recursos de pasta de nível superior pertencentes ao usuário (por exemplo, "users/*" ou "projects/*").
asset.tilesets[]

object (Tileset)

Os tilesets que fazem o backup dessa imagem. Presente apenas para imagens externas, cujos pixels são recuperados do armazenamento que não é propriedade do 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".
Campo de união location. Informações sobre onde e como os blocos de raster são armazenados. location pode ser apenas de um dos tipos a seguir:
asset.cloudStorageLocation
(deprecated)

object (CloudStorageLocation)

Obsoleto. Use image.importExternal. 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.

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.