تمت ترجمة هذه الصفحة بواسطة Cloud Translation API‏.

DataFilter

تمثيل JSON
DeveloperMetadataLookup
- تمثيل JSON
DeveloperMetadataLocationMatchingStrategy

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

تمثيل JSON

تمثيل 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`. }

{

  // 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`.

البحث عن بيانات وصفية لمطوّري البرامج

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

تمثيل JSON

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

{
  "locationType": enum (DeveloperMetadataLocationType),
  "metadataLocation": {
    object (DeveloperMetadataLocation)
  },
  "locationMatchingStrategy": enum (DeveloperMetadataLocationMatchingStrategy),
  "metadataId": integer,
  "metadataKey": string,
  "metadataValue": string,
  "visibility": enum (DeveloperMetadataVisibility)
}

الحقول
`locationType`	`enum (DeveloperMetadataLocationType)` يحصر البيانات الوصفية المحددة لمطوّر البرامج على الإدخالات المرتبطة بالمواقع من النوع المحدد. على سبيل المثال، عندما يتم تحديد هذا الحقل على أنه `ROW`، يراعي هذا البحث البيانات الوصفية لمطوّر البرامج المرتبطة بالصفوف فقط. إذا لم يتم تحديد الحقل، فسيتم اعتبار جميع أنواع المواقع. لا يمكن تحديد هذا الحقل كـ `SPREADSHEET` عند تحديد `locationMatchingStrategy` كتقاطع أو عندما يتم تحديد `metadataLocation` باعتباره موقعًا غير جدول البيانات: لا يمكن أن تتقاطع البيانات الوصفية لجداول البيانات مع أي موقع بيانات وصفية آخر لمطور البرامج. ويجب أيضًا ترك هذا الحقل بدون تحديد عند تحديد `locationMatchingStrategy` على أنه "صحيح".
`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` متطابقة. في حال ترك هذا الحقل بدون تحديد، ستتم مراعاة جميع البيانات الوصفية للمطوّرين الظاهرة في الطلب.

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

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

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