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

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

object (DeveloperMetadataLocation)

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

enum (DeveloperMetadataLocationMatchingStrategy)

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