Method: projects.assets.patch

애셋을 업데이트합니다. 업데이트 작업에는 다음과 같은 여러 제약 조건이 있습니다.

  • 애셋의 title, description, startTime, endTime, properties 필드만 업데이트할 수 있습니다.
  • updateMask에서 "properties"를 지정하면 애셋의 모든 사용자 정의 속성이 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

애셋의 ID입니다. 'projects/*/assets/' 접두어를 제외한 name과 동일합니다 (예: 'users//'). 이 값은 표시 목적으로만 사용됩니다. 다른 작업의 입력으로 사용해서는 안 됩니다. 대신 name을 사용하세요.
asset.updateTime

string (Timestamp format)

애셋의 마지막 수정 시간입니다.

생성된 출력은 항상 Z-정규화되고 소수점 이하 0, 3, 6 또는 9자리인 RFC 3339를 사용합니다. '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)

애셋과 연결된 타임스탬프입니다(예: 위성 이미지가 촬영된 시간). 월 또는 연도의 평균 값과 같이 시간 간격에 해당하는 애셋의 경우 이 타임스탬프는 해당 간격의 시작에 해당합니다.

생성된 출력은 항상 Z-정규화되고 소수점 이하 0, 3, 6 또는 9자리인 RFC 3339를 사용합니다. 'Z' 이외의 오프셋도 허용됩니다. 예를 들면 "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" 또는 "2014-10-02T15:01:23+05:30"입니다.
asset.endTime

string (Timestamp format)

월 또는 연도의 평균 값과 같이 시간 간격에 해당하는 애셋의 경우 이 타임스탬프는 해당 간격의 끝 (제외)에 해당합니다.

생성된 출력은 항상 Z-정규화되고 소수점 이하 0, 3, 6 또는 9자리인 RFC 3339를 사용합니다. '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 geometry 객체로 표시됩니다(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".
래스터 타일이 저장되는 위치와 방법에 대한 정보입니다. 다음은 상호 배타적인 필드 목록입니다. 응답에서 필드가 최대 하나만 설정됩니다.
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)

EE에서 이 FeatureView의 위치입니다.
상호 배타적인 필드의 끝입니다.

응답 본문

성공한 경우 응답 본문에 EarthEngineAsset의 인스턴스가 포함됩니다.

승인 범위

다음 OAuth 범위 중 하나가 필요합니다.

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

자세한 내용은 OAuth 2.0 Overview를 참조하세요.