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/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

رقم تعريف مادة العرض مكافئ 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.title
(deprecated)

string

عنوان مادة العرض
asset.description
(deprecated)

string

وصف مادة العرض
asset.properties

object (Struct format)

سمات المفتاح/القيمة المرتبطة بمادة العرض
asset.startTime

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.endTime

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.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.gcsLocation
(deprecated)

object (GcsLocation)

تمّ الإيقاف. استخدِم image.importExternal بدلاً من ذلك. اطّلِع على https://developers.google.com/earth-engine/Earth_Engine_asset_from_cloud_geotiff لمزيد من التفاصيل.
asset.featureViewAssetLocation

object (FeatureViewLocation)

الموقع الجغرافي لعرض "الميزات" هذا في إسبانيا

نص الاستجابة

إذا كانت الاستجابة ناجحة، يحتوي نص الاستجابة على مثال EarthEngineAsset.

نطاقات التفويض

يتطلب أحد نطاقات OAuth التالية:

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

لمزيد من المعلومات، يُرجى الاطّلاع على OAuth 2.0 Overview.