DataFilter

فیلتری که توصیف می‌کند چه داده‌هایی باید انتخاب شوند یا از یک درخواست بازگردانده شوند. برای اطلاعات بیشتر، به خواندن، نوشتن و جستجوی فراداده مراجعه کنید.

نمایش JSON 
{

  "developerMetadataLookup": {
    object (DeveloperMetadataLookup)
  },
  "a1Range": string,
  "gridRange": {
    object (GridRange)
  }
}
فیلدها
filter فیلد یونیون. انواع فیلترهایی که ممکن است داده‌های انتخاب شده را محدود کنند. filter می‌تواند فقط یکی از موارد زیر باشد:
developerMetadataLookup

object ( DeveloperMetadataLookup )

داده‌های مرتبط با فراداده‌های توسعه‌دهنده که با معیارهای شرح داده شده در این DeveloperMetadataLookup مطابقت دارند را انتخاب می‌کند.

a1Range

string

داده‌هایی را انتخاب می‌کند که با محدوده مشخص شده A1 مطابقت دارند.

gridRange

object ( GridRange )

داده‌هایی را انتخاب می‌کند که با محدوده‌ی توصیف‌شده توسط GridRange مطابقت دارند.

جستجوی توسعه‌دهندهفراداده

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 )

نحوه تطبیق این جستجو با مکان را تعیین می‌کند. اگر این فیلد به صورت EXACT مشخص شود، فقط فراداده‌های توسعه‌دهنده مرتبط با مکان دقیق مشخص‌شده تطبیق داده می‌شوند. اگر این فیلد به صورت 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 نشان می‌دهد که یک مکان مشخص شده باید با آن مکان دقیق و همچنین هر مکان متقاطع مطابقت داشته باشد. به عنوان مثال، اگر ردیف سه به عنوان یک مکان مشخص شده باشد، این استراتژی تطبیق، فراداده‌های توسعه‌دهنده مرتبط با ردیف سه و همچنین فراداده‌های مرتبط با مکان‌هایی که با ردیف سه تقاطع دارند را مطابقت می‌دهد. اگر، به عنوان مثال، فراداده‌های توسعه‌دهنده مرتبط با ستون B وجود داشته باشد، این استراتژی تطبیق نیز با آن مکان مطابقت خواهد داشت زیرا ستون B با ردیف سه تقاطع دارد.