DataFilter

Filtr określający, jakie dane powinny zostać wybrane lub zwrócone z żądania.

Zapis 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.
}
Pola
Pole sumy filter. Rodzaje filtrów, które mogą ograniczać zakres wybranych danych. filter może być tylko jedną z tych wartości:
developerMetadataLookup

object (DeveloperMetadataLookup)

Wybiera dane powiązane z metadanymi dewelopera, które spełniają kryteria opisane w zasadzie DeveloperMetadataLookup.

a1Range

string

Wybiera dane, które pasują do podanego zakresu A1.

gridRange

object (GridRange)

Wybiera dane pasujące do zakresu opisanego w polu GridRange.

DeveloperMetadataLookup

Wybiera ciąg DeveloperMetadata, który pasuje do wszystkich podanych pól. Jeśli na przykład określony jest tylko identyfikator metadanych, uwzględniany jest element DeveloperMetadata z tym konkretnym identyfikatorem. Jeśli określisz klucz metadanych, uwzględnione zostaną wszystkie metadane dewelopera z tym kluczem. Jeśli określony jest klucz, widoczność i typ lokalizacji, uwzględniane są wszystkie metadane dewelopera z tym kluczem i widocznością, które są powiązane z lokalizacją tego typu. Ogólnie rzecz biorąc, powoduje to zaznaczenie wszystkich metadanych DeveloperMetadata, które pasują do elementów wspólnych wszystkich określonych pól. Można określić dowolne pole lub kombinację pól.

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

enum (DeveloperMetadataLocationType)

Ogranicza wybrane metadane dewelopera do wpisów, które są powiązane z lokalizacjami określonego typu. Jeśli na przykład to pole jest określone jako ROW, wyszukiwanie weźmie pod uwagę tylko metadane dewelopera powiązane w wierszach. Jeśli to pole jest nieokreślone, uwzględniane są wszystkie typy lokalizacji. Tego pola nie można określić jako SPREADSHEET, gdy locationMatchingStrategy jest określony jako INTERSECT lub gdy metadataLocation jest określony jako lokalizacja poza arkuszem kalkulacyjnym: metadane arkusza kalkulacyjnego nie mogą przecinać żadnych innych lokalizacji metadanych dewelopera. To pole musi też być nieokreślone, gdy pole locationMatchingStrategy jest określone jako EXACT.

metadataLocation

object (DeveloperMetadataLocation)

Ogranicza wybrane metadane dewelopera do wpisów powiązanych z określoną lokalizacją. To pole pasuje do dokładnych lokalizacji lub do wszystkich przecinających się lokalizacji zgodnie z określonym locationMatchingStrategy.

locationMatchingStrategy

enum (DeveloperMetadataLocationMatchingStrategy)

Określa, w jaki sposób wyszukiwanie pasuje do lokalizacji. Jeśli pole jest określone jako DOKŁADNE, dopasowywane są tylko metadane dewelopera powiązane z podaną lokalizacją. Jeśli pole ma wartość INTERSECTING, dopasowywane są też metadane dewelopera powiązane z przecinającymi się lokalizacjami. Jeśli pozostawisz nieokreślone, to pole przyjmuje wartość domyślną wynoszącą INTERSECTING. Jeśli to pole jest określone, musisz też podać pole metadataLocation.

metadataId

integer

Ogranicza wybrane metadane dewelopera do tych, które mają pasujący element DeveloperMetadata.metadata_id.

metadataKey

string

Ogranicza wybrane metadane dewelopera do tych, które mają pasujący element DeveloperMetadata.metadata_key.

metadataValue

string

Ogranicza wybrane metadane dewelopera do tych, które mają pasujący element DeveloperMetadata.metadata_value.

visibility

enum (DeveloperMetadataVisibility)

Ogranicza wybrane metadane dewelopera do tych, które mają pasujący element DeveloperMetadata.visibility. Jeśli pozostawisz nieokreślone, uwzględniane są wszystkie metadane dewelopera widoczne w projekcie, który wysłał żądanie.

DeveloperMetadataLocationMatchingStrategy

Lista strategii dopasowywania lokalizacji metadanych dewelopera.

Wartości w polu enum
DEVELOPER_METADATA_LOCATION_MATCHING_STRATEGY_UNSPECIFIED Wartość domyślna. Tej wartości nie można używać.
EXACT_LOCATION Wskazuje, że podana lokalizacja powinna zostać dopasowana dokładnie. Jeśli na przykład wiersz trzeci został określony jako lokalizacja, ta strategia dopasowania dopasuje tylko metadane dewelopera powiązane także w wierszu trzecim. Metadane powiązane z innymi lokalizacjami nie zostaną uwzględnione.
INTERSECTING_LOCATION Wskazuje, że określona lokalizacja powinna odpowiadać dokładnie tej lokalizacji, a także wszystkim przylegającym do niej lokalizacjom. Jeśli na przykład wiersz trzeci zostanie określony jako lokalizacja, strategia dopasowania będzie pasować do metadanych dewelopera powiązanych z wierszem trzecim oraz metadanych powiązanych z lokalizacjami, które przecinają wiersz 3. Jeśli np. z kolumną B powiązano metadane dewelopera, ta strategia dopasowania też do niej pasuje, ponieważ kolumna B przecina wiersz 3.