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/v1beta/{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 เสมอ และใช้ตัวเลขเศษส่วน 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 เสมอ และใช้ตัวเลขเศษส่วน 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 เสมอ และใช้ตัวเลขเศษส่วน 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"
ข้อมูลเกี่ยวกับตำแหน่งและวิธีจัดเก็บไทล์แรสเตอร์ รายการช่องที่แยกกันมีดังนี้ ระบบจะตั้งค่าช่องอย่างน้อย 1 ช่องในการตอบกลับ
asset.cloudStorageLocation
(deprecated)

object (CloudStorageLocation)

เลิกใช้งานแล้ว ให้ใช้ ImportExternalImage แทน ดูรายละเอียดเพิ่มเติมได้ที่ 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.