REST Resource: spreadsheets.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

True عندما تكون بيانات التعريف مرتبطة بجدول بيانات كامل.
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 المحدّدة.