공지사항: 2025년 4월 15일 전에 Earth Engine 사용을 위해 등록된 모든 비상업용 프로젝트는 Earth Engine 액세스를 유지하기 위해 비상업용 자격 요건을 인증해야 합니다.

이 페이지는 Cloud Translation API를 통해 번역되었습니다.

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/v1beta/{asset.name=projects/*/assets/**}

URL은 gRPC 트랜스코딩 문법을 사용합니다.

경로 매개변수

매개변수

매개변수
`asset.name`	`string` 저작물의 이름입니다. `name`의 형식은 'projects//assets/*'입니다(예: 'projects/earthengine-legacy/assets/users//').

asset.name

string

저작물의 이름입니다. name의 형식은 'projects/*/assets/**'입니다(예: 'projects/earthengine-legacy/assets/users//').

요청 본문

요청 본문에는 다음과 같은 구조의 데이터가 포함됩니다.

JSON 표현

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": {
    "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` 저작물의 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.properties`	`object (Struct format)` 저작물과 연결된 키/값 속성입니다.
`asset.startTime`	`string (Timestamp format)` 저작물과 연결된 타임스탬프(있는 경우)입니다(예: 위성 이미지가 촬영된 시간). 한 달 또는 1년 동안의 평균 값과 같이 시간 간격에 해당하는 애셋의 경우 이 타임스탬프는 해당 간격의 시작에 해당합니다. 생성된 출력은 항상 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)` 한 달 또는 1년 동안의 평균 값과 같이 시간 간격에 해당하는 애셋의 경우 이 타임스탬프는 해당 간격의 끝 (제외)에 해당합니다. 생성된 출력은 항상 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 도형 객체로 나타냅니다(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)` 이 이미지를 지원하는 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)` EE의 이 FeatureView 위치입니다.

응답 본문

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

승인 범위

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

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

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

Method: projects.assets.patch 컬렉션을 사용해 정리하기 내 환경설정을 기준으로 콘텐츠를 저장하고 분류하세요.