Method: projects.assets.patch

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

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

HTTP-запрос

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

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

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

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

string

Имя актива. name имеет формат «projects/*/assets/**» (например, «projects/earthengine-legacy/assets/users/ / ").

Тело запроса

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

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
}
Поля
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.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 )

Устарело. Вместо этого используйте image.importExternal . Дополнительную информацию см. на странице 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 .

,

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

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

HTTP-запрос

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

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

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

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

string

Имя актива. name имеет формат «projects/*/assets/**» (например, «projects/earthengine-legacy/assets/users/ / ").

Тело запроса

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

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
}
Поля
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.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 )

Устарело. Вместо этого используйте image.importExternal . Дополнительную информацию см. на странице 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 .