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

metadataLocation

object (DeveloperMetadataLocation)

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

locationMatchingStrategy

enum (DeveloperMetadataLocationMatchingStrategy)

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