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 .

Поиск метаданных разработчика

Выбирает 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 пересекает третью строку.