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