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 de l'élément peuvent être mis à jour.
  • Si vous nommez "properties" dans updateMask, toutes les propriétés de l'élément définies par l'utilisateur sont remplacées par les propriétés de asset.
  • Si vous nommez "title", "description", "startTime" ou "endTime" dans updateMask sans fournir de valeur dans asset, ce champ est désactivé.
  • 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é est définie sur la valeur correspondante de asset.properties. S'il n'existe aucune valeur correspondante dans asset.properties, ou s'il existe une valeur, mais qu'il s'agit d'une NullValue, la propriété est supprimée de l'élément.
  • Les propriétés ne peuvent être définies que sur des valeurs de chaîne ou numériques, ou supprimées en spécifiant un NullValue.
  • Si vous fournissez un updateMask vide, les horodatages et les propriétés de l'élément sont tous remplacés par les valeurs de asset.

Requête HTTP

PATCH https://earthengine.googleapis.com/v1/{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'élément.
asset.id

string

ID de l'élément. Équivalent à name sans le préfixe "projects/*/assets/" (par exemple, "users//"). Notez que cette option ne sert qu'à générer des rapports. Elle ne doit pas être utilisée comme entrée pour 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 utilise toujours le format UTC (indiqué par "Z" pour le temps universel coordonné) avec des secondes fractionnaires de 0, 3, 6 ou 9 chiffres décimaux. Des décalages horaires autres que "Z" (UTC) 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'élément.
asset.startTime

string (Timestamp format)

Horodatage associé à l'élément, le cas échéant (par exemple, l'heure à laquelle une image satellite a été prise). Pour les éléments qui correspondent à un intervalle de temps, tels que les valeurs moyennes sur un mois ou une année, cet horodatage correspond au début de cet intervalle.

Utilise la norme RFC 3339, où la sortie générée utilise toujours le format UTC (indiqué par "Z" pour le temps universel coordonné) avec des secondes fractionnaires de 0, 3, 6 ou 9 chiffres décimaux. Des décalages horaires autres que "Z" (UTC) 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 éléments qui correspondent à un intervalle de temps, tels que les valeurs moyennes sur un mois ou une année, cet horodatage correspond à la fin de cet intervalle (exclusive).

Utilise la norme RFC 3339, où la sortie générée utilise toujours le format UTC (indiqué par "Z" pour le temps universel coordonné) avec des secondes fractionnaires de 0, 3, 6 ou 9 chiffres décimaux. Des décalages horaires autres que "Z" (UTC) 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)

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 éléments non image.
asset.sizeBytes

string (int64 format)

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

string (int64 format)

Nombre de caractéristiques dans l'élément, le cas échéant.
asset.quota

object (FolderQuota)

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

object (Tileset)

Ensembles de tuiles qui prennent en charge cette image. Présent uniquement pour les images externes, dont les pixels sont récupérés à partir d'un espace de stockage qui n'appartient pas à Earth Engine.
updateMask

string (FieldMask format)

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

Il s'agit d'une liste de noms de champs complets séparés par une virgule. Exemple : "user.displayName,photo".
Informations sur l'emplacement et le mode de stockage des tuiles raster. Voici une liste de champs mutuellement exclusifs. Au maximum, un seul des champs sera défini dans une réponse :
asset.cloudStorageLocation
(deprecated)

object (CloudStorageLocation)

Obsolète. Utilisez plutôt ImportExternalImage. Pour en savoir plus, consultez la page https://developers.google.com/earth-engine/Earth_Engine_asset_from_cloud_geotiff.
asset.featureViewAssetLocation

object (FeatureViewLocation)

Emplacement de cette FeatureView dans EE.
Fin des champs mutuellement exclusifs.

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 niveaux d'accès OAuth suivants :

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

Pour plus d'informations, consultez la OAuth 2.0 Overview.