Method: projects.assets.patch

Aktualizuje zasób. Operacja aktualizacji podlega kilku ograniczeniom:

  • Można aktualizować tylko pola title, description, startTime, endTime i properties zasobu.
  • Wymienienie "properties" w updateMask spowoduje zastąpienie wszystkich właściwości zdefiniowanych przez użytkownika w zasobie właściwościami w asset.
  • Wymienienie "title", "description", "startTime" lub "endTime" w updateMask i niepodanie wartości w asset spowoduje usunięcie tego pola.
  • Można aktualizować poszczególne właściwości, wymieniając je w updateMask, np. "properties.my_property_name". Wartość właściwości zostanie ustawiona na odpowiednią wartość z asset.properties. Jeśli w asset.properties nie ma odpowiedniej wartości lub jeśli jest wartość, ale jest to NullValue, właściwość zostanie usunięta z zasobu.
  • Właściwości można ustawiać tylko na wartości typu string lub number albo usuwać, określając NullValue.
  • Podanie pustego updateMask spowoduje zastąpienie sygnatur czasowych i właściwości zasobu wartościami w 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 jest to przeznaczone tylko do wyświetlania. Nie należy go używać jako danych wejściowych do innej operacji. Zamiast tego użyj name.
asset.updateTime

string (Timestamp format)

Czas ostatniej modyfikacji zasobu.

Korzysta ze standardu RFC 3339, w którym wygenerowane dane wyjściowe są zawsze znormalizowane do formatu Z i zawierają 0, 3, 6 lub 9 cyfr po przecinku. 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 istnieje), np. czas wykonania zdjęcia satelitarnego. W przypadku zasobów odpowiadających przedziałowi czasu, takich jak średnie wartości z miesiąca lub roku, ta sygnatura czasowa odpowiada początkowi tego przedziału.

Korzysta ze standardu RFC 3339, w którym wygenerowane dane wyjściowe są zawsze znormalizowane do formatu Z i zawierają 0, 3, 6 lub 9 cyfr po przecinku. 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 przedziałowi czasu, takich jak średnie wartości z miesiąca lub roku, ta sygnatura czasowa odpowiada końcowi tego przedziału (wyłącznie).

Korzysta ze standardu RFC 3339, w którym wygenerowane dane wyjściowe są zawsze znormalizowane do formatu Z i zawierają 0, 3, 6 lub 9 cyfr po przecinku. 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)

Ślad przestrzenny powiązany z zasobem (jeśli istnieje) jako obiekt geometrii GeoJSON (patrz RFC 7946).
asset.bands[]

object (ImageBand)

Informacje o pasmach danych komponentu z obrazem. Pomijane w przypadku zasobów innych niż obrazy.
asset.sizeBytes

string (int64 format)

Rozmiar zasobu liścia (np. obrazu) w bajtach.
asset.featureCount

string (int64 format)

Liczba elementów w zasobie (jeśli dotyczy).
asset.quota

object (FolderQuota)

Informacje o limicie powiązane z zasobem folderu (jeśli istnieją). Zwracane w przypadku zasobów folderów najwyższego poziomu należących do użytkownika (np. „users/*” lub „projects/*”).
asset.tilesets[]

object (Tileset)

Zestawy kafelków obsługujące ten obraz. Występuje tylko w przypadku obrazów zewnętrznych, których piksele są pobierane z pamięci masowej nienależącej do Earth Engine.
updateMask

string (FieldMask format)

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

Jest to rozdzielana przecinkami lista pełnych nazw pól. Przykład: "user.displayName,photo".
Informacje o tym, gdzie i jak są przechowywane kafelki rastrowe. Oto lista pól, które się wzajemnie wykluczają. W odpowiedzi zostanie ustawione co najwyżej jedno z tych pól:
asset.cloudStorageLocation
(deprecated)

object (CloudStorageLocation)

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

object (FeatureViewLocation)

Lokalizacja tego widoku FeatureView w EE.
Koniec pól, które się wzajemnie wykluczają.

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.