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 على أنّه EXACT.

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