DataFilter

Filtr określający, które 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 danych. filter może mieć tylko jedną z tych wartości:
developerMetadataLookup

object (DeveloperMetadataLookup)

Wybiera dane powiązane z metadanymi dewelopera spełniające kryteria opisane w tym dokumencie DeveloperMetadataLookup.

a1Range

string

Wybiera dane, które pasują do określonego zakresu A1.

gridRange

object (GridRange)

Wybiera dane, które pasują do zakresu opisanego w zasadzie GridRange.

DeveloperMetadataLookup

Wybiera DeveloperMetadata pasujące do wszystkich określonych pól. Jeśli np. określony jest tylko identyfikator metadanych, brana jest pod uwagę DeveloperMetadata z tym unikalnym identyfikatorem. 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. Ogólnie powoduje to zaznaczenie wszystkich metadanych dewelopera, które pasują do przecięcia 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 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. Tego pola nie można określić jako SPREADSHEET, gdy pole locationMatchingStrategy jest określone jako INTERSECTING lub gdy metadataLocation jest określona jako lokalizacja inna niż arkusz kalkulacyjny: metadane arkusza kalkulacyjnego nie mogą przecinać innych lokalizacji metadanych dewelopera. To pole musi też pozostać nieokreślone, jeśli pole locationMatchingStrategy jest określone jako ŚCISŁE.

metadataLocation

object (DeveloperMetadataLocation)

Ogranicza wybrane metadane dewelopera do tych wpisów powiązanych z określoną 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 wyszukiwanie jest zgodne z lokalizacją. Jeśli to pole zostanie określone jako ŚCISŁE, dopasowywane będą tylko metadane dewelopera powiązane z podaną dokładnie lokalizacją. Jeśli to pole ma wartość INTERSECTING, metadane dewelopera powiązane z przecinającymi się lokalizacjami również są dopasowywane. 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ą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ące 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 na przykład jako lokalizację wskazano wiersz 3, ta strategia dopasowywania pasowałaby tylko do metadanych dewelopera powiązanych również z wierszem 3. Metadane powiązane z innymi lokalizacjami nie będą brane pod uwagę.
INTERSECTING_LOCATION Wskazuje, że określona lokalizacja powinna pasować do tej lokalizacji, jak również 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.