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)

مستوى رؤية البيانات الوصفية يجب أن يكون للبيانات الوصفية لمطوّر البرامج دائمًا مستوى رؤية محدد.

موقع البيانات الوصفية لمطوّر البرامج

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

تمثيل 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 المحدّدة صفًا أو عمودًا واحدًا، ويجب ألا تكون غير محدودة أو أن تمتد إلى صفوف أو أعمدة متعددة.

نوع البيانات الوصفية لمطوّر البرامج

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

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

مستوى رؤية البيانات الوصفية لمطوّر البرامج

تعدد للمشاهدات المحتملة للبيانات الوصفية.

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

الطُرق

get

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