DataFilter

فلتر يصف البيانات التي يجب اختيارها أو عرضها من طلب معيّن

تمثيل JSON 
{

  // Union field filter can be only one of the following:
  "developerMetadataLookup": {
    object (DeveloperMetadataLookup)
  },
  "a1Range": string,
  "gridRange": {
    object (GridRange)
  }
  // End of list of possible types for union field filter.
}
الحقول
حقل الربط 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)

لتحديد كيفية مطابقة عملية البحث هذه للموقع الجغرافي في حال تحديد هذا الحقل على أنّه "دقيق"، لن تتم مطابقة سوى البيانات الوصفية للمطوّر المرتبطة بالموقع الجغرافي الدقيق المحدّد. إذا تم ضبط هذا الحقل على 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 يشير إلى أنّ الموقع الجغرافي المحدّد يجب أن يتطابق مع هذا الموقع الجغرافي بالضبط بالإضافة إلى أي مواقع جغرافية متداخلة. على سبيل المثال، إذا تم تحديد الصف الثالث كموقع جغرافي، ستطابق استراتيجية المطابقة هذه البيانات الوصفية للمطوّر المرتبطة بالصف الثالث بالإضافة إلى البيانات الوصفية المرتبطة بالمواقع الجغرافية التي تتقاطع مع الصف الثالث. على سبيل المثال، إذا كانت هناك بيانات وصفية للمطوّر مرتبطة بالعمود "ب"، ستتطابق استراتيجية المطابقة هذه أيضًا مع هذا الموضع لأنّ العمود "ب" يتقاطع مع الصف الثالث.