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".
معلومات عن مكان تخزين مربّعات الصور النقطية وكيفية تخزينها في ما يلي قائمة بالحقول التي يستبعد كلٌّ منها الآخر. سيتم ضبط حقل واحد على الأكثر في الردّ:
asset.cloudStorageLocation
(deprecated)

object (CloudStorageLocation)

تمّ الإيقاف. استخدِم ImportExternalImage بدلاً من ذلك. راجِع https://developers.google.com/earth-engine/Earth_Engine_asset_from_cloud_geotiff لمزيد من التفاصيل.
asset.gcsLocation
(deprecated)

object (GcsLocation)

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

object (FeatureViewLocation)

موقع FeatureView هذا في Earth Engine
نهاية الحقول التي يستبعد كلٌّ منها الآخر

نص الاستجابة

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

نطاقات الأذونات

يجب توفير أحد نطاقات OAuth التالية:

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

لمزيد من المعلومات، راجِع OAuth 2.0 Overview.