Method: projects.assets.patch

Met à jour un élément. L'opération de mise à jour est soumise à un certain nombre de contraintes:

  • Seuls les champs title, description, startTime, endTime et properties du composant peuvent être mis à jour.
  • Nommer "properties" dans updateMask entraîne le remplacement de toutes les propriétés définies par l'utilisateur de l'asset par les propriétés de asset.
  • Si vous nommez "title", "description", "startTime" ou "endTime" dans updateMask et que vous ne fournissez pas de valeur dans asset, ce champ n'est pas défini.
  • Vous pouvez mettre à jour des propriétés individuelles en les nommant dans updateMask, comme "properties.my_property_name". La valeur de la propriété sera définie sur la valeur correspondante de asset.properties. Si aucune valeur correspondante n'est définie dans asset.properties, ou si une valeur est définie, mais qu'il s'agit d'une NullValue, la propriété est supprimée de l'asset.
  • Vous ne pouvez définir des valeurs de chaîne ou de nombre que pour les propriétés, ou les supprimer en spécifiant un NullValue.
  • Si vous fournissez un updateMask vide, les codes temporels et les propriétés de l'asset seront tous remplacés par les valeurs de asset.

Requête HTTP

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

L'URL utilise la syntaxe de transcodage gRPC.

Paramètres de chemin d'accès

Paramètres
asset.name

string

Nom de l'élément. name est au format "projects/*/assets/**" (par exemple, "projects/earthengine-legacy/assets/users//").

Corps de la requête

Le corps de la requête contient des données présentant la structure suivante :

Représentation 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
}
Champs
asset.type

enum (Type)

Type de l'asset.
asset.id

string

ID de l'élément. Équivaut à name sans le préfixe "projects/*/assets/" (par exemple, "users//"). Notez que cette option n'est utilisée qu'à des fins d'affichage. Il ne doit pas être utilisé comme entrée d'une autre opération. Utilisez plutôt name.
asset.updateTime

string (Timestamp format)

Heure de la dernière modification de l'élément.

Utilise la norme RFC 3339, où la sortie générée est toujours normalisée avec le suffixe Z et utilise 0, 3, 6 ou 9 chiffres décimaux. Les décalages autres que "Z" sont également acceptés. Exemples: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" ou "2014-10-02T15:01:23+05:30".
asset.properties

object (Struct format)

Propriétés clé/valeur associées à l'asset.
asset.startTime

string (Timestamp format)

Code temporel associé au composant, le cas échéant (par exemple, heure à laquelle une image satellite a été prise). Pour les composants qui correspondent à un intervalle de temps, comme les valeurs moyennes sur un mois ou une année, ce code temporel correspond au début de cet intervalle.

Utilise la norme RFC 3339, où la sortie générée est toujours normalisée avec le suffixe Z et utilise 0, 3, 6 ou 9 chiffres décimaux. Les décalages autres que "Z" sont également acceptés. Exemples: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" ou "2014-10-02T15:01:23+05:30".
asset.endTime

string (Timestamp format)

Pour les composants qui correspondent à un intervalle de temps, comme les valeurs moyennes sur un mois ou une année, cet horodatage correspond à la fin de cet intervalle (exclusif).

Utilise la norme RFC 3339, où la sortie générée est toujours normalisée avec le suffixe Z et utilise 0, 3, 6 ou 9 chiffres décimaux. Les décalages autres que "Z" sont également acceptés. Exemples: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" ou "2014-10-02T15:01:23+05:30".
asset.geometry

object (Struct format)

L'empreinte spatiale associée à l'élément, le cas échéant, sous la forme d'un objet de géométrie GeoJSON (voir RFC 7946).
asset.bands[]

object (ImageBand)

Informations sur les bandes de données du composant Image. omis pour les composants autres que des images.
asset.sizeBytes

string (int64 format)

Taille d'un élément de feuille (par exemple, une image) en octets.
asset.featureCount

string (int64 format)

Nombre d'éléments de l'asset, le cas échéant.
asset.quota

object (FolderQuota)

Informations sur le quota associées à l'élément de dossier, le cas échéant. Rendue pour les composants de dossier de premier niveau appartenant à l'utilisateur (par exemple, "users/*" ou "projects/*").
asset.tilesets[]

object (Tileset)

Les ensembles de tuiles qui sous-tendent cette image. Présent uniquement pour les images externes, dont les pixels sont récupérés à partir d'un stockage qui n'appartient pas à Earth Engine.
updateMask

string (FieldMask format)

Masque de mise à jour spécifiant les champs de l'asset à mettre à jour.

Il s'agit d'une liste de noms de champs complets séparés par une virgule. Exemple : "user.displayName,photo"
Champ d'union location. Informations sur l'emplacement et la méthode de stockage des tuiles raster. location ne peut être qu'un des éléments suivants :
asset.cloudStorageLocation
(deprecated)

object (CloudStorageLocation)

Obsolète. Utilisez image.importExternal à la place. Pour en savoir plus, consultez https://developers.google.com/earth-engine/Earth_Engine_asset_from_cloud_geotiff.
asset.featureViewAssetLocation

object (FeatureViewLocation)

Emplacement de cette FeatureView dans l'EE.

Corps de la réponse

Si la requête aboutit, le corps de la réponse contient une instance de EarthEngineAsset.

Champs d'application des autorisations

Nécessite l'un des champs d'application OAuth suivants :

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

Pour en savoir plus, consultez OAuth 2.0 Overview.