المرجع: البيانات الوصفية للمطوّر
البيانات الوصفية للمطوّر المرتبطة بموقع أو عنصر في جدول بيانات يمكن استخدام البيانات الوصفية للمطوِّرين لربط البيانات العشوائية بأجزاء مختلفة من جدول البيانات، وستظل البيانات مرتبطة بتلك البيانات في تلك المواقع أثناء تنقّلها أو تعديل جدول البيانات. على سبيل المثال، إذا تم ربط البيانات الوصفية لمطوِّر البرامج بالصف 5 ثم تم إدراج صف آخر أعلى الصف 5، ستظل تلك البيانات الوصفية الأصلية مرتبطة بالصف الذي تم ربطها به أولاً (ما هو الآن الصف 6). إذا تم حذف العنصر المرتبط، سيتم حذف البيانات الوصفية الخاصة به أيضًا.
تمثيل JSON |
---|
{ "metadataId": integer, "metadataKey": string, "metadataValue": string, "location": { object ( |
الحقول | |
---|---|
metadataId |
المعرِّف الفريد على مستوى جدول البيانات الذي يحدِّد البيانات الوصفية. يمكن تحديد المعرفات عند إنشاء البيانات الوصفية، وإلا سيتم إنشاء واحد وتعيينه عشوائيًا. يجب أن تكون القيمة موجبة. |
metadataKey |
مفتاح البيانات الوصفية. قد تكون هناك بيانات وصفية متعددة في جدول بيانات لها المفتاح نفسه. يجب أن تحتوي البيانات الوصفية للمطوِّر دائمًا على مفتاح محدّد. |
metadataValue |
البيانات المرتبطة بمفتاح بيانات التعريف |
location |
تمثّل هذه السمة الموقع الجغرافي المرتبط بالبيانات الوصفية. |
visibility |
إمكانية رؤية البيانات الوصفية. يجب أن يتم دائمًا تحديد إذن الوصول للبيانات الوصفية للمطوِّرين. |
DeveloperMetadataLocation
يشير ذلك المصطلح إلى مكان يمكن فيه ربط البيانات الوصفية في جدول بيانات.
تمثيل JSON |
---|
{ "locationType": enum ( |
الحقول | |
---|---|
locationType |
تمثّل هذه السمة نوع الموقع الجغرافي الذي يمثّله هذا العنصر. هذا الحقل للقراءة فقط. |
حقل الاتحاد location تشير هذه السمة إلى الموقع الجغرافي المرتبط بالبيانات الوصفية. يمكن أن يكون الحقل "location " واحدًا فقط مما يلي: |
|
spreadsheet |
True عندما تكون بيانات التعريف مرتبطة بجدول بيانات كامل. |
sheetId |
معرّف ورقة البيانات عندما تكون البيانات الوصفية مرتبطة بورقة كاملة. |
dimensionRange |
تمثِّل هذه السمة الصف أو العمود عند ربط البيانات الوصفية بإحدى السمات. يجب أن يمثل عنصر |
DeveloperMetadataLocationType
قائمة بأنواع المواقع الجغرافية التي قد ترتبط بها البيانات الوصفية لمطوِّري البرامج
عمليات التعداد | |
---|---|
DEVELOPER_METADATA_LOCATION_TYPE_UNSPECIFIED |
القيمة التلقائية. |
ROW |
البيانات الوصفية للمطوِّر المرتبطة بسمة صف كاملة |
COLUMN |
البيانات الوصفية للمطوّر المرتبطة بسمة عمود كاملة |
SHEET |
البيانات الوصفية للمطوِّر المرتبطة بورقة كاملة |
SPREADSHEET |
البيانات الوصفية للمطوِّر المرتبطة بجدول البيانات بالكامل |
DeveloperMetadataVisibility
قائمة بإمكانية ظهور بيانات التعريف المحتملة
عمليات التعداد | |
---|---|
DEVELOPER_METADATA_VISIBILITY_UNSPECIFIED |
القيمة التلقائية. |
DOCUMENT |
يمكن الوصول إلى البيانات الوصفية المرئية للمستند من أي مشروع مطور لديه إمكانية الوصول إلى المستند. |
PROJECT |
لا تكون البيانات الوصفية المرئية للمشروع مرئية ويمكن الوصول إليها إلا من خلال مشروع المطوّر الذي أنشأ البيانات الوصفية. |
الطُرق |
|
---|---|
|
يتم عرض البيانات الوصفية للمطوِّر التي تتضمّن المعرّف المحدّد. |
|
عرض جميع البيانات الوصفية للمطوِّر التي تتطابق مع DataFilter المحدّدة. |