Method: projects.assets.patch

Aktualizuje zasób. Operacja aktualizacji podlega kilku ograniczeniom:

  • Można aktualizować tylko pola title, description, startTime, endTime i properties zasobu.
  • Nazwanie "properties" w sekcji updateMask powoduje zastąpienie wszystkich zdefiniowanych przez użytkownika właściwości zasobu właściwościami w sekcji updateMask.asset
  • Jeśli w polu updateMask podasz nazwę "title", "description", "startTime" lub "endTime", a w polu asset nie podasz wartości, to pole zostanie puste.
  • Możesz aktualizować poszczególne właściwości, nazywając je w updateMask, np. "properties.my_property_name". Wartość tej właściwości zostanie ustawiona na odpowiadającą wartość z elementu asset.properties. Jeśli w elementach asset.properties nie ma odpowiedniej wartości lub jeśli wartość jest, ale jest to NullValue, właściwość zostanie usunięta z komponentu.
  • Właściwości mogą być ustawiane tylko na wartości ciągu znaków lub liczby albo usuwane przez podanie wartości NullValue.
  • Podanie pustego elementu updateMask spowoduje zastąpienie wszystkich atrybutów i danych dotyczących sygnatury czasowej komponentu wartościami w elementach asset.

Żądanie HTTP

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

Adres URL używa składni transkodowania gRPC.

Parametry ścieżki

Parametry
asset.name

string

Nazwa zasobu. name ma format „projects/*/assets/**” (np. „projects/earthengine-legacy/assets/users//”).

Treść żądania

Treść żądania zawiera dane o następującej strukturze:

Zapis 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
}
Pola
asset.type

enum (Type)

Typ zasobu.

asset.id

string

Identyfikator zasobu. Odpowiednik name bez prefiksu „projects/*/assets/” (np. „users//”). Pamiętaj, że służy to tylko do wyświetlania. Nie należy go używać jako danych wejściowych do innej operacji. Zamiast niej użyj kolumny name.

asset.updateTime

string (Timestamp format)

Czas ostatniej modyfikacji zasobu.

Używa standardu RFC 3339, w którym wygenerowany wynik jest zawsze znormalizowany według normy Z i zawiera 0, 3, 6 lub 9 cyfr ułamkowych. Akceptowane są też przesunięcia inne niż „Z”. Przykłady: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" lub "2014-10-02T15:01:23+05:30".

asset.properties

object (Struct format)

Właściwości klucz-wartość powiązane z zasobem.

asset.startTime

string (Timestamp format)

Sygnatura czasowa powiązana z zasobem (jeśli występuje), np. czas wykonania zdjęcia satelitarnego. W przypadku zasobów odpowiadających intervalom czasowym, np. średnich wartości w ciągu miesiąca lub roku, ten znacznik czasu odpowiada początkowi tego przedziału.

Używa standardu RFC 3339, w którym wygenerowany wynik jest zawsze znormalizowany według normy Z i zawiera 0, 3, 6 lub 9 cyfr ułamkowych. Akceptowane są też przesunięcia inne niż „Z”. Przykłady: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" lub "2014-10-02T15:01:23+05:30".

asset.endTime

string (Timestamp format)

W przypadku zasobów odpowiadających intervalom czasowym, np. średnich wartości z miesiąca lub roku, ta sygnatura czasowa odpowiada końcowi tego przedziału (nie licząc go).

Używa standardu RFC 3339, w którym wygenerowany wynik jest zawsze znormalizowany według normy Z i zawiera 0, 3, 6 lub 9 cyfr ułamkowych. Akceptowane są też przesunięcia inne niż „Z”. Przykłady: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" lub "2014-10-02T15:01:23+05:30".

asset.geometry

object (Struct format)

Dane przestrzenne powiązane z zasobem (jeśli istnieją) jako obiekt geometrii GeoJSON (patrz RFC 7946).

asset.bands[]

object (ImageBand)

Informacje o pasmach danych komponentu z obrazem. W przypadku komponentów bez obrazu jest pomijany.

asset.sizeBytes

string (int64 format)

Rozmiar zasobu typu liść (np. obrazu) w bajtach.

asset.featureCount

string (int64 format)

Liczba funkcji w zasobie (w odpowiednich przypadkach).

asset.quota

object (FolderQuota)

Informacje o kwocie dostępnej na zasób folderu (jeśli są dostępne). Zwracane w przypadku zasobów folderu należącego do użytkownika na najwyższym poziomie (np. „users/*” lub „projects/*”).

asset.tilesets[]

object (Tileset)

Płytki obrazów, które stanowią podstawę tego obrazu. występuje tylko w przypadku obrazów zewnętrznych, których piksele są pobierane z miejsca przechowywania, które nie jest własnością Earth Engine;

updateMask

string (FieldMask format)

Maska aktualizacji określająca, które pola zasobu mają zostać zaktualizowane.

Jest to lista pełnych nazw pól rozdzielona przecinkami. Przykład: "user.displayName,photo".

Pole unii location. Informacje o tym, gdzie i jak są przechowywane płytki rastrowe. location może być tylko jednym z tych elementów:
asset.cloudStorageLocation
(deprecated)

object (CloudStorageLocation)

Rola wycofana. Zamiast tego użyj kolumny image.importExternal. Więcej informacji znajdziesz na stronie https://developers.google.com/earth-engine/Earth_Engine_asset_from_cloud_geotiff.

asset.featureViewAssetLocation

object (FeatureViewLocation)

Lokalizacja tej widoczności funkcji w Estonii.

Treść odpowiedzi

W przypadku powodzenia treść odpowiedzi obejmuje wystąpienie elementu EarthEngineAsset.

Zakresy autoryzacji

Wymaga jednego z tych zakresów OAuth:

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

Więcej informacji znajdziesz w OAuth 2.0 Overview.