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)

الطابع الزمني المرتبط بمادة العرض، إن وُجد، مثل الوقت الذي تم فيه التقاط صورة القمر الصناعي بالنسبة إلى مواد العرض التي تتوافق مع فترة زمنية، مثل القيم المتوسطة على مدار شهر أو عام، يتوافق هذا الطابع الزمني مع بداية تلك الفترة.

يستخدم المعيار 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.featureViewAssetLocation

object (FeatureViewLocation)

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

نص الاستجابة

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

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

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

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

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