DataFilter

فلتر يصف البيانات التي يجب اختيارها أو إرجاعها من الطلب لمزيد من المعلومات، يُرجى الاطّلاع على قراءة البيانات الوصفية وكتابتها والبحث فيها.

تمثيل JSON 
{

  "developerMetadataLookup": {
    object (DeveloperMetadataLookup)
  },
  "a1Range": string,
  "gridRange": {
    object (GridRange)
  }
}
الحقول
حقل الدمج filter أنواع الفلاتر التي قد تحدّ من البيانات التي يتم اختيارها يمكن أن تكون filter إحدى القيم التالية فقط:
developerMetadataLookup

object (DeveloperMetadataLookup)

يختار هذا DeveloperMetadataLookup البيانات المرتبطة ببيانات المطوّر الوصفية التي تتطابق مع المعايير الموضّحة.
a1Range

string

يختار البيانات التي تطابق نطاق A1 المحدّد.
gridRange

object (GridRange)

يختار البيانات التي تتطابق مع النطاق الموصوف في GridRange.

DeveloperMetadataLookup

يختار DeveloperMetadata الذي يطابق جميع الحقول المحدّدة. على سبيل المثال، إذا تم تحديد معرّف بيانات وصفية فقط، سيتم اعتبار DeveloperMetadata مع هذا المعرّف الفريد المحدّد. في حال تحديد مفتاح بيانات وصفية، سيتم أخذ جميع البيانات الوصفية للمطوّرين التي تتضمّن هذا المفتاح في الاعتبار. في حال تحديد مفتاح ونوع إذن الوصول ونوع الموقع الجغرافي، سيتم أخذ جميع البيانات الوصفية للمطوّر التي تتضمّن هذا المفتاح وإذن الوصول والمرتبطة بموقع جغرافي من هذا النوع في الاعتبار. بشكل عام، يؤدي ذلك إلى اختيار جميع DeveloperMetadata التي تتطابق مع تقاطع جميع الحقول المحدّدة، ويمكن تحديد أي حقل أو مجموعة من الحقول.

تمثيل JSON 
{
  "locationType": enum (DeveloperMetadataLocationType),
  "metadataLocation": {
    object (DeveloperMetadataLocation)
  },
  "locationMatchingStrategy": enum (DeveloperMetadataLocationMatchingStrategy),
  "metadataId": integer,
  "metadataKey": string,
  "metadataValue": string,
  "visibility": enum (DeveloperMetadataVisibility)
}
الحقول
locationType

enum (DeveloperMetadataLocationType)

يقتصر على إدخالات البيانات الوصفية المحدّدة للمطوّر المرتبطة بمواقع جغرافية من النوع المحدّد. على سبيل المثال، عند تحديد هذا الحقل على أنّه ROW، لا يأخذ البحث في الاعتبار سوى بيانات المطوّر الوصفية المرتبطة بالصفوف. في حال ترك الحقل بدون تحديد، سيتم أخذ جميع أنواع المواقع الجغرافية في الاعتبار. لا يمكن تحديد قيمة هذا الحقل على أنّها SPREADSHEET عندما يتم تحديد locationMatchingStrategy على أنّه INTERSECTING أو عندما يتم تحديد metadataLocation على أنّه موقع جغرافي غير جدول بيانات. لا يمكن أن تتقاطع البيانات الوصفية لجدول البيانات مع أي موقع آخر للبيانات الوصفية للمطوّرين. يجب أيضًا ترك هذا الحقل بدون تحديد قيمة عندما يتم تحديد locationMatchingStrategy على أنّه EXACT.
metadataLocation

object (DeveloperMetadataLocation)

يقتصر على إدخالات البيانات الوصفية المحدّدة للمطوّر المرتبطة بالموقع الجغرافي المحدّد. يتطابق هذا الحقل إما مع المواقع الجغرافية الدقيقة أو مع جميع المواقع الجغرافية المتقاطعة وفقًا لـ locationMatchingStrategy المحدّدة.
locationMatchingStrategy

enum (DeveloperMetadataLocationMatchingStrategy)

تحدّد هذه السمة كيفية مطابقة عملية البحث للموقع الجغرافي. إذا تم تحديد هذا الحقل على أنّه EXACT، لن تتم مطابقة سوى البيانات الوصفية للمطوّر المرتبطة بالموقع الجغرافي المحدّد بالضبط. في حال تحديد هذا الحقل على INTERSECTING، تتم أيضًا مطابقة البيانات الوصفية للمطوّر المرتبطة بالمواقع الجغرافية المتقاطعة. إذا لم يتم تحديد هذه السمة، سيتم تلقائيًا ضبط القيمة على INTERSECTING. في حال تحديد هذا الحقل، يجب أيضًا تحديد metadataLocation.
metadataId

integer

يقتصر على البيانات الوصفية المحدّدة للمطوّر التي تتضمّن DeveloperMetadata.metadata_id مطابقًا.
metadataKey

string

يقتصر على البيانات الوصفية المحدّدة للمطوّر التي تتضمّن DeveloperMetadata.metadata_key مطابقًا.
metadataValue

string

يقتصر على البيانات الوصفية المحدّدة للمطوّر التي تتضمّن DeveloperMetadata.metadata_value مطابقًا.
visibility

enum (DeveloperMetadataVisibility)

يقتصر على البيانات الوصفية المحدّدة للمطوّر التي تتضمّن DeveloperMetadata.visibility مطابقًا. في حال عدم تحديدها، سيتم أخذ جميع البيانات الوصفية للمطوّرين التي يراها المشروع الذي يقدّم الطلب في الاعتبار.

DeveloperMetadataLocationMatchingStrategy

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

عمليات التعداد
DEVELOPER_METADATA_LOCATION_MATCHING_STRATEGY_UNSPECIFIED القيمة التلقائية يجب عدم استخدام هذه القيمة.
EXACT_LOCATION تشير إلى أنّه يجب مطابقة موقع جغرافي محدّد تمامًا. على سبيل المثال، إذا تم تحديد الصف الثالث كموقع جغرافي، لن تتطابق استراتيجية المطابقة هذه إلا مع البيانات الوصفية للمطوّر المرتبطة أيضًا بالصف الثالث. لن يتم أخذ البيانات الوصفية المرتبطة بمواقع جغرافية أخرى في الاعتبار.
INTERSECTING_LOCATION تشير إلى أنّ الموقع الجغرافي المحدّد يجب أن يتطابق مع هذا الموقع الجغرافي بالضبط بالإضافة إلى أي مواقع جغرافية متقاطعة. على سبيل المثال، إذا تم تحديد الصف الثالث كموقع جغرافي، ستطابق استراتيجية المطابقة هذه البيانات الوصفية للمطوّر المرتبطة بالصف الثالث، بالإضافة إلى البيانات الوصفية المرتبطة بالمواقع الجغرافية التي تتقاطع مع الصف الثالث. على سبيل المثال، إذا كانت هناك بيانات وصفية للمطوّر مرتبطة بالعمود "ب"، ستطابق استراتيجية المطابقة هذه أيضًا هذا الموقع الجغرافي لأنّ العمود "ب" يتقاطع مع الصف الثالث.