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 المحدد.