DataFilter

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

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 unii filter. Rodzaje filtrów, które mogą ograniczać wybór danych. filter może być tylko jednym z tych elementów:
developerMetadataLookup

object (DeveloperMetadataLookup)

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

string

Wybiera dane pasujące do określonego zakresu A1.
gridRange

object (GridRange)

Wybiera dane pasujące do zakresu opisanego przez GridRange.

DeveloperMetadataLookup

Wybiera DeveloperMetadata, które pasuje do wszystkich podanych pól. Jeśli na przykład podany jest tylko identyfikator metadanych, uwzględniane są DeveloperMetadata o tym konkretnym identyfikatorze. Jeśli określono klucz metadanych, pod uwagę brane będą wszystkie metadane dewelopera zawierające ten klucz. Jeśli określono klucz, widoczność i typ lokalizacji, uwzględniane są wszystkie metadane dewelopera z tym kluczem i widoczność powiązane z lokalizacją tego typu. Zazwyczaj wybiera to wszystkie metadanychi w DeveloperMetadata, które pasują do wszystkich podanych pól. Można podać dowolne pole lub dowolną 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 tych wpisów, które są powiązane z lokalizacjami określonego typu. Jeśli na przykład to pole ma wartość ROW, to wyszukiwanie uwzględnia tylko metadane dewelopera powiązane w wierszach. Jeśli pole pozostanie nieokreślone, uwzględniane będą wszystkie typy lokalizacji. Nie można ustawić tego pola jako SPREADSHEET, gdy locationMatchingStrategy ma wartość INTERSECTING lub gdy metadataLocation ma wartość inną niż lokalizacja arkusza kalkulacyjnego: metadane arkusza kalkulacyjnego nie mogą się nakładać na żadne inne metadane dewelopera. To pole musi też pozostać niewypełnione, gdy locationMatchingStrategy ma wartość EXACT.
metadataLocation

object (DeveloperMetadataLocation)

Ogranicza wybrane metadane dewelopera do wpisów powiązanych ze wskazaną lokalizacją. To pole jest zgodne z dokładnymi lokalizacjami albo ze wszystkimi przecinającymi się lokalizacjami zgodnie z określoną wartością locationMatchingStrategy.
locationMatchingStrategy

enum (DeveloperMetadataLocationMatchingStrategy)

Określa, jak to wyszukiwanie pasuje do lokalizacji. Jeśli to pole jest określone jako ścisłe, dopasowywane są tylko metadane dewelopera powiązane z dokładnie określoną lokalizacją. Jeśli w tym polu wybrano opcję PRZECINAJĄCE, dopasowywane są też metadane dewelopera powiązane z przecinaniem się lokalizacji. Jeśli pozostanie nieokreślona, to pole przyjmuje wartość domyślną INTERSECTING. Jeśli to pole jest określone, należy też określić metadataLocation.
metadataId

integer

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

string

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

string

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

enum (DeveloperMetadataVisibility)

Ogranicza wybrane metadane dewelopera do tych, które mają pasujący parametr DeveloperMetadata.visibility. Jeśli pozostanie nieokreślona, uwzględnione zostaną wszystkie metadane dewelopera widoczne w projekcie, z którego pochodzi żą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 określona lokalizacja powinna być dokładnie dopasowana. Jeśli np. w kolumnie 3 podano lokalizację, ta strategia dopasowywania będzie pasować tylko do metadanych dewelopera, które są powiązane z tym wierszem. Metadane powiązane z innymi lokalizacjami nie będą brane pod uwagę.
INTERSECTING_LOCATION Wskazuje, że określona lokalizacja powinna pasować zarówno do tej lokalizacji, jak i do wszystkich przylegających lokalizacji. Jeśli np. jako lokalizacja wskazano wiersz 3, ta strategia dopasowywania pasowałaby do metadanych dewelopera powiązanych z wierszem 3 oraz do metadanych powiązanych z lokalizacjami, które znajdują się w wierszu 3. Jeśli na przykład w kolumnie B były powiązane metadane dewelopera, ta strategia dopasowania będzie też pasować do tej lokalizacji, ponieważ kolumna B przecina wiersz 3.