REST Resource: spreadsheets.developerMetadata

المرجع: DeveloperMetadata

البيانات الوصفية للمطوّر المرتبطة بموقع جغرافي أو عنصر في جدول بيانات يمكن استخدام البيانات الوصفية للمطوّر لربط بيانات عشوائية بأجزاء مختلفة من جدول البيانات، وستظل مرتبطة بهذه المواضع أثناء التنقّل وتعديل جدول البيانات. على سبيل المثال، إذا كانت البيانات الوصفية للمطوّر مرتبطة بالصف 5 وتم إدراج صف آخر لاحقًا فوق الصف 5، ستظل البيانات الوصفية الأصلية مرتبطة بالصف الذي كان مرتبطًا به في البداية (الصف 6 الآن). في حال حذف العنصر المرتبط، يتم أيضًا حذف البيانات الوصفية المرتبطة به.

تمثيل JSON 
{
  "metadataId": integer,
  "metadataKey": string,
  "metadataValue": string,
  "location": {
    object (DeveloperMetadataLocation)
  },
  "visibility": enum (DeveloperMetadataVisibility)
}
الحقول
metadataId

integer

المعرّف الفريد على مستوى جدول البيانات الذي يحدّد البيانات الوصفية يمكن تحديد المعرّفات عند إنشاء البيانات الوصفية، وإلا سيتم إنشاء معرّف عشوائيًا وتحديده. يجب أن تكون موجبة.
metadataKey

string

مفتاح البيانات الوصفية قد تتوفّر بيانات وصفية متعدّدة في جدول بيانات يتضمّن المفتاح نفسه. يجب أن تحتوي البيانات الوصفية للمطوّر دائمًا على مفتاح محدّد.
metadataValue

string

البيانات المرتبطة بمفتاح البيانات الوصفية
location

object (DeveloperMetadataLocation)

الموقع الجغرافي الذي تم ربط البيانات الوصفية به
visibility

enum (DeveloperMetadataVisibility)

إذن الوصول إلى البيانات الوصفية يجب أن يكون مستوى ظهور البيانات الوصفية للمطوّر محدّدًا في كل الأوقات.

DeveloperMetadataLocation

موقع يمكن ربط البيانات الوصفية به في جدول بيانات.

تمثيل JSON 
{
  "locationType": enum (DeveloperMetadataLocationType),

  // Union field location can be only one of the following:
  "spreadsheet": boolean,
  "sheetId": integer,
  "dimensionRange": {
    object (DimensionRange)
  }
  // End of list of possible types for union field location.
}
الحقول
locationType

enum (DeveloperMetadataLocationType)

نوع الموقع الجغرافي الذي يمثّله هذا العنصر هذا الحقل للقراءة فقط.
حقل الربط location الموقع الجغرافي الذي يتم فيه ربط البيانات الوصفية يمكن أن يكون location واحدًا فقط مما يلي:
spreadsheet

boolean

صحيح عندما تكون البيانات الوصفية مرتبطة بجدول بيانات كامل.
sheetId

integer

معرّف الورقة عندما تكون البيانات الوصفية مرتبطة بورقة كاملة.
dimensionRange

object (DimensionRange)

يمثّل الصف أو العمود عندما تكون البيانات الوصفية مرتبطة بسمة. يجب أن يمثّل DimensionRange المحدّد صفًا أو عمودًا واحدًا، ولا يمكن أن يكون غير محدود أو يمتد على صفوف أو أعمدة متعددة.

DeveloperMetadataLocationType

قائمة بأنواع المواقع الجغرافية التي يمكن ربط البيانات الوصفية للمطوّر بها

عمليات التعداد
DEVELOPER_METADATA_LOCATION_TYPE_UNSPECIFIED القيمة التلقائية
ROW البيانات الوصفية للمطوّر المرتبطة بسمة صف بالكامل
COLUMN البيانات الوصفية لمطوّر البرامج المرتبطة بسمة عمود بالكامل
SHEET البيانات الوصفية للمطوّر المرتبطة بورقة بيانات كاملة
SPREADSHEET البيانات الوصفية لمطوّر البرامج المرتبطة بجدول البيانات بالكامل

DeveloperMetadataVisibility

قائمة بمستويات رؤية البيانات الوصفية المحتملة

عمليات التعداد
DEVELOPER_METADATA_VISIBILITY_UNSPECIFIED القيمة التلقائية
DOCUMENT يمكن الوصول إلى البيانات الوصفية المرئية للمستند من أي مشروع مطوّر لديه إذن الوصول إلى المستند.
PROJECT لا تظهر البيانات الوصفية المرئية للمشروع إلا لمشروع المطوّر الذي أنشأ البيانات الوصفية، ولا يمكن لأحد الوصول إليها إلا هذا المشروع.

الطُرق

get

 عرض بيانات التعريف للمطوّر باستخدام رقم التعريف المحدّد
لعرض جميع البيانات الوصفية للمطوّر التي تتطابق مع DataFilter المحدّد.