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 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 odpowiadają kryteriom opisanym 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 podany jest klucz metadanych, uwzględniane są wszystkie metadane dewelopera z tym kluczem. Jeśli podasz klucz, widoczność i typ lokalizacji, zostaną uwzględnione wszystkie metadane dewelopera z tym kluczem i tą widocznością, które są 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 wpisów powiązanych z lokalizacjami określonego typu. Jeśli na przykład to pole jest określone jako ROW, wyszukiwanie uwzględnia tylko metadane dewelopera powiązane z wierszami. Jeśli to pole nie zostanie określone, zostaną uwzględnione wszystkie typy lokalizacji. Nie można ustawić tego pola jako SPREADSHEET, gdy locationMatchingStrategy jest ustawiony jako INTERSECTING lub gdy metadataLocation jest ustawiony jako lokalizacja inna niż arkusz kalkulacyjny: metadane arkusza kalkulacyjnego nie mogą się nakładać na żadne inne metadane dewelopera. To pole musi też pozostać niewypełnione, gdy parametr locationMatchingStrategy ma wartość EXACT.
metadataLocation

object (DeveloperMetadataLocation)

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

enum (DeveloperMetadataLocationMatchingStrategy)

Określa, jak to wyszukiwanie pasuje do lokalizacji. Jeśli to pole jest ustawione jako ścisłe, dopasowywane są tylko metadane dewelopera powiązane z dokładnie określoną lokalizacją. Jeśli w tym polu jest ustawiona wartość INTERSECTING, dopasowywane są też metadane dewelopera powiązane z przecinaniem się lokalizacji. Jeśli nie podasz żadnej opcji, domyślną wartością będzie INTERSECTING. Jeśli to pole jest określone, musisz też podać wartość metadataLocation.
metadataId

integer

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

string

Ogranicza wybrane metadane dewelopera do tych, które mają pasujące wartości DeveloperMetadata.metadata_key.
metadataValue

string

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

enum (DeveloperMetadataVisibility)

Ogranicza wybrane metadane dewelopera do tych, które mają pasujące wartości DeveloperMetadata.visibility. Jeśli nie podasz żadnych metadanych dewelopera, zostaną uwzględnione wszystkie metadane dewelopera widoczne dla projektu przesyłającego żądanie.

DeveloperMetadataLocationMatchingStrategy

Wyliczenie strategii dopasowywania lokalizacji metadanych dewelopera.

Wartości w polu enum
DEVELOPER_METADATA_LOCATION_MATCHING_STRATEGY_UNSPECIFIED Wartość domyślna. Nie należy używać tej wartości.
EXACT_LOCATION Wskazuje, że należy dopasować dokładną lokalizację. Jeśli np. w kolumnie 3 podano lokalizację, ta strategia dopasowywania będzie pasować tylko do metadanych dewelopera powiązanych z tym wierszem. Metadane powiązane z innymi lokalizacjami nie będą brane pod uwagę.
INTERSECTING_LOCATION Wskazuje, że określona lokalizacja powinna pasować do tej dokładnej lokalizacji oraz wszystkich lokalizacji, które się z nią pokrywają. Jeśli na przykład jako lokalizację podano wiersz 3, ta strategia dopasowywania będzie pasować do metadanych dewelopera powiązanych z wierszem 3, a także do metadanych powiązanych z lokalizacjami, które przecinają się z wierszem 3. Jeśli np. w kolumnie B były powiązane metadane dewelopera, ta strategia dopasowywania byłaby również zgodna z tą lokalizacją, ponieważ kolumna B przecina się z wierszem 3.