Method: projects.assets.patch

Обновляет актив. На операцию обновления накладывается ряд ограничений:

  • Изменять можно только поля title , description , startTime , endTime и properties объекта.
  • Присвоение имени переменной "properties" в updateMask приводит к замене всех определяемых пользователем свойств ресурса свойствами, указанными в asset .
  • Если в поле updateMask указать значения полей "title" , "description" , "startTime" или "endTime" , а в поле asset не указать значение, это приведет к тому, что соответствующее поле останется незаполненным.
  • Можно обновлять отдельные свойства, указывая их имена в updateMask , например, "properties.my_property_name" . Значение свойства будет установлено на соответствующее значение из asset.properties . Если в asset.properties нет соответствующего значения, или если значение есть, но оно равно NullValue , свойство будет удалено из актива.
  • Свойствам можно присваивать только строковые или числовые значения, а также удалять их, указывая NullValue .
  • Если указать пустой updateMask все метки времени и свойства ресурса будут заменены значениями из asset .

HTTP-запрос

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

В URL-адресе используется синтаксис транскодирования gRPC .

Параметры пути

Параметры
asset.name

string

name ресурса имеет формат "projects/*/assets/**" (например, "projects/earthengine-legacy/assets/users/") / ").

Текст запроса

Тело запроса содержит данные следующей структуры:

JSON-представление 
{
  "asset": {
    "cloudStorageLocation": {
      "uris": [
        string
      ]
    },
    "gcsLocation": {
      "uris": [
        string
      ]
    },
    "featureViewAssetLocation": {
      "assetOptions": {
        object (FeatureViewOptions)
      }
    },
    "type": enum (Type),
    "name": string,
    "id": string,
    "updateTime": string,
    "title": string,
    "description": 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,
      "maxAssetCount": string
    },
    "tilesets": [
      {
        "id": string,
        "sources": [
          {
            object (ImageSource)
          }
        ],
        "dataType": enum (DataType),
        "crs": string
      }
    ]
  },
  "updateMask": string
}
Поля
asset.type

enum ( Type )

Тип актива.

asset.id

string

Идентификатор ресурса. Эквивалентно name без префикса "projects/*/assets/" (например, "users/"). / Обратите внимание, что это предназначено только для отображения. Не следует использовать это в качестве входных данных для другой операции. Используйте вместо этого name .

asset.updateTime

string ( Timestamp format)

Время последнего изменения актива.

Используется RFC 3339, согласно которому генерируемый вывод всегда будет Z-нормализован и будет содержать 0, 3, 6 или 9 дробных знаков. Допускаются также смещения, отличные от "Z". Примеры: "2014-10-02T15:01:23Z" , "2014-10-02T15:01:23.045123456Z" или "2014-10-02T15:01:23+05:30" .

asset.title
(deprecated)

string

Название актива.

asset.description
(deprecated)

string

Описание актива.

asset.properties

object ( Struct format)

Ключевые/значные свойства, связанные с активом.

asset.startTime

string ( Timestamp format)

Временная метка, связанная с активом, если таковая имеется, например, время получения спутникового снимка. Для активов, соответствующих временному интервалу, например, средним значениям за месяц или год, эта временная метка соответствует началу этого интервала.

Используется RFC 3339, согласно которому генерируемый вывод всегда будет Z-нормализован и будет содержать 0, 3, 6 или 9 дробных знаков. Допускаются также смещения, отличные от "Z". Примеры: "2014-10-02T15:01:23Z" , "2014-10-02T15:01:23.045123456Z" или "2014-10-02T15:01:23+05:30" .

asset.endTime

string ( Timestamp format)

Для активов, соответствующих определенному временному интервалу, например, средним значениям за месяц или год, эта временная метка соответствует концу этого интервала (исключая его).

Используется RFC 3339, согласно которому генерируемый вывод всегда будет Z-нормализован и будет содержать 0, 3, 6 или 9 дробных знаков. Допускаются также смещения, отличные от "Z". Примеры: "2014-10-02T15:01:23Z" , "2014-10-02T15:01:23.045123456Z" или "2014-10-02T15:01:23+05:30" .

asset.geometry

object ( Struct format)

Пространственная область, связанная с объектом, если таковая имеется, представлена ​​в виде геометрического объекта GeoJSON (см. RFC 7946).

asset.bands[]

object ( ImageBand )

Информация о полосах данных графического ресурса. Опущено для ресурсов, не являющихся изображениями.

asset.sizeBytes

string ( int64 format)

Размер конечного ресурса (например, изображения) в байтах.

asset.featureCount

string ( int64 format)

Количество элементов в активе, если таковое имеется.

asset.quota

object ( FolderQuota )

Информация о квоте, связанная с ресурсом папки, если таковая имеется. Возвращается для ресурсов папок верхнего уровня, принадлежащих пользователям (например, "users/*" или "projects/*").

asset.tilesets[]

object ( Tileset )

Наборы тайлов, лежащие в основе этого изображения. Присутствуют только для внешних изображений, пиксели которых извлекаются из хранилища, не принадлежащего Earth Engine.

updateMask

string ( FieldMask format)

Маска обновления, указывающая, какие поля актива следует обновить.

Это список полных имен полей, разделенных запятыми. Пример: "user.displayName,photo" .

location поля объединения. Информация о том, где и как хранятся растровые тайлы. location может принимать только одно из следующих значений:
asset.cloudStorageLocation
(deprecated)

object ( CloudStorageLocation )

Устарело. Используйте ImportExternalImage вместо него. Подробнее см. https://developers.google.com/earth-engine/Earth_Engine_asset_from_cloud_geotiff .

asset.gcsLocation
(deprecated)

object ( GcsLocation )

Устарело. Используйте ImportExternalImage вместо него. Подробнее см. https://developers.google.com/earth-engine/Earth_Engine_asset_from_cloud_geotiff .

asset.featureViewAssetLocation

object ( FeatureViewLocation )

Местоположение этого FeatureView в EE.

Ответный текст

В случае успеха тело ответа будет содержать экземпляр объекта EarthEngineAsset .

Области полномочий

Требуется один из следующих диапазонов аутентификации OAuth:

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

Для получения более подробной информации см.OAuth 2.0 Overview .