این صفحه به‌وسیله ‏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` مطابقت داشته باشد.

DeveloperMetadataLookup

DeveloperMetadata را انتخاب می کند که با تمام فیلدهای مشخص شده مطابقت دارد. به عنوان مثال، اگر فقط یک شناسه فراداده مشخص شده باشد، 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` مشخص می‌شود، این جستجو فقط ابرداده توسعه‌دهنده مرتبط با ردیف‌ها را در نظر می‌گیرد. اگر فیلد نامشخص باقی بماند، همه انواع مکان در نظر گرفته می شوند. زمانی که `locationMatchingStrategy` به‌عنوان INTERSECTING یا زمانی که `metadataLocation` به‌عنوان مکان غیرصفحه‌گسترده مشخص می‌شود، نمی‌تواند به‌عنوان `SPREADSHEET` مشخص شود: ابرداده‌های صفحه‌گسترده نمی‌توانند مکان‌های فراداده توسعه‌دهنده دیگری را قطع کنند. زمانی که `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` منطبق است محدود می‌کند. اگر نامشخص باقی بماند، همه ابرداده های توسعه دهنده قابل مشاهده برای پروژه درخواست کننده در نظر گرفته می شوند.

DeveloperMetadataLocationMatchingStrategy

شمارشی از استراتژی‌ها برای تطبیق مکان‌های ابرداده توسعه‌دهنده.

Enums
`DEVELOPER_METADATA_LOCATION_MATCHING_STRATEGY_UNSPECIFIED`	مقدار پیش فرض. این مقدار نباید استفاده شود.
`EXACT_LOCATION`	نشان می دهد که یک مکان مشخص شده باید دقیقا مطابقت داشته باشد. برای مثال، اگر ردیف سه به‌عنوان مکان مشخص می‌شد، این استراتژی تطبیق فقط با ابرداده‌های توسعه‌دهنده مرتبط با ردیف سه مطابقت دارد. فراداده مرتبط با مکان های دیگر در نظر گرفته نمی شود.
`INTERSECTING_LOCATION`	نشان می دهد که یک مکان مشخص شده باید دقیقاً با آن مکان و همچنین مکان های متقاطع مطابقت داشته باشد. برای مثال، اگر ردیف سه به‌عنوان مکان مشخص شود، این استراتژی تطبیق با ابرداده‌های توسعه‌دهنده مرتبط در ردیف سه و همچنین ابرداده‌های مرتبط با مکان‌هایی که ردیف سه را قطع می‌کنند مطابقت دارد. برای مثال، اگر ابرداده توسعه‌دهنده مرتبط با ستون B وجود داشته باشد، این استراتژی تطبیق با آن مکان نیز مطابقت دارد زیرا ستون B ردیف سه را قطع می‌کند.