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 משתמשת בתחביר של Transcoding של 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. אפשר להשתמש גם בשינויים (offsets) אחרים מלבד '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)

חותמת הזמן המשויכת לנכס, אם יש כזו, למשל השעה שבה צולמה תמונה לווינית. בנכסים שתואמים למרווח זמן מסוים, כמו ערכים ממוצעים לאורך חודש או שנה, חותמת הזמן הזו תואמת לתחילת המרווח הזה.

הפורמט הזה משתמש ב-RFC 3339, שבו הפלט שנוצר תמיד יהיה מנורמלי לפי Z וישמש בספרות עשרוניות של 0, 3, 6 או 9. אפשר להשתמש גם בשינויים (offsets) אחרים מלבד 'Z'. דוגמאות: "2014-10-02T15:01:23Z", ‏ "2014-10-02T15:01:23.045123456Z" או "2014-10-02T15:01:23+05:30".
asset.endTime

string (Timestamp format)

בנכסים שתואמים למרווח זמן מסוים, כמו ערכים ממוצעים לאורך חודש או שנה, חותמת הזמן הזו תואמת לסוף מרווח הזמן הזה (לא כולל).

הפורמט הזה משתמש ב-RFC 3339, שבו הפלט שנוצר תמיד יהיה מנורמלי לפי Z וישמש בספרות עשרוניות של 0, 3, 6 או 9. אפשר להשתמש גם בשינויים (offsets) אחרים מלבד '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)

המיקום של תצוגת המאפיינים הזו ב-EE.

גוף התשובה

אם הפעולה מצליחה, גוף התגובה מכיל מופע של EarthEngineAsset.

היקפי הרשאה

נדרש אחד מהיקפי ההרשאות הבאים של OAuth:

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

מידע נוסף זמין בOAuth 2.0 Overview.