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-normalized เสมอ และใช้ตัวเลขทศนิยม 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)

การประทับเวลาที่เชื่อมโยงกับชิ้นงาน หากมี เช่น เวลาถ่ายภาพจากดาวเทียม สําหรับเนื้อหาที่สอดคล้องกับช่วงเวลา เช่น ค่าเฉลี่ยในช่วง 1 เดือนหรือ 1 ปี การประทับเวลานี้จะสอดคล้องกับช่วงเริ่มต้นของช่วงเวลานั้น

ใช้ RFC 3339 ซึ่งเอาต์พุตที่สร้างขึ้นจะเป็นรูปแบบ Z-normalized เสมอ และใช้ตัวเลขทศนิยม 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)

สําหรับเนื้อหาที่สอดคล้องกับช่วงเวลา เช่น ค่าเฉลี่ยในช่วง 1 เดือนหรือ 1 ปี การประทับเวลานี้จะสอดคล้องกับช่วงสิ้นสุดของช่วงเวลานั้น (ไม่รวม)

ใช้ RFC 3339 ซึ่งเอาต์พุตที่สร้างขึ้นจะเป็นรูปแบบ Z-normalized เสมอ และใช้ตัวเลขทศนิยม 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