DataFilter

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

object (DeveloperMetadataLookup)

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

a1Range

string

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

gridRange

object (GridRange)

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

Wyszukiwanie metadanych dewelopera

Wybiera DeveloperMetadata, który pasuje do wszystkich podanych pól. Jeśli na przykład określony jest tylko identyfikator metadanych, DeveloperMetadata ma ten unikalny identyfikator. Jeśli klucz metadanych jest określony, uwzględnia to wszystkie metadane dewelopera z tym kluczem. Jeśli podasz klucz, widoczność i typ lokalizacji, zostaną uwzględnione wszystkie metadane dewelopera z tym kluczem i widoczność powiązane z lokalizacją tego typu. Zasadniczo wybiera to wszystkie Metadane dewelopera pasujące do wszystkich pól określonych w polu. Możesz 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 powiązanych z lokalizacjami określonego typu. Jeśli na przykład wartość tego pola to ROW, wyszukiwanie bierze pod uwagę tylko metadane dewelopera powiązane z wierszami. Jeśli nie określisz wartości pola, uwzględniane są wszystkie typy lokalizacji. Nie można określić tego pola jako SPREADSHEET, gdy pole locationMatchingStrategy jest określone jako INTERSECTING lub metadataLocation jest określone jako lokalizacja inna niż arkusz kalkulacyjny: metadane arkusza kalkulacyjnego nie mogą przecinać żadnej innej lokalizacji metadanych dewelopera. W przypadku gdy pole locationMatchingStrategy ma wartość EXACT, to pole nie może być określone.

metadataLocation

object (DeveloperMetadataLocation)

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

locationMatchingStrategy

enum (DeveloperMetadataLocationMatchingStrategy)

Określa, w jaki sposób to wyszukiwanie dopasowuje lokalizację. Jeśli pole ma wartość EXACT, dopasowywane są tylko metadane dewelopera powiązane z określoną lokalizacją. Jeśli to pole jest ustawione na INTERSECTING, metadane dewelopera powiązane z przecinających się lokalizacjach również są dopasowywane. Jeśli nie określisz stanu, to pole przyjmuje domyślną wartość INTERSECTING. Jeśli określisz to pole, musisz 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ące 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ące DeveloperMetadata.visibility. Jeśli nie określono inaczej, wszystkie metadane dewelopera są widoczne dla projektu, z którego pochodzi żądanie.

Strategia dopasowywania metadanych metadanych dewelopera

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. wiersz 3 został określony jako lokalizacja, ta strategia dopasowania będzie dopasowana tylko do metadanych dewelopera powiązanych również z tym wierszem. Metadane powiązane z innymi lokalizacjami nie będą uwzględniane.
INTERSECTING_LOCATION Wskazuje, że określona lokalizacja powinna pasować dokładnie do tej lokalizacji oraz wszystkich należących do niej lokalizacji. Jeśli np. wiersz 3 został określony jako lokalizacja, ta dopasowana strategia pasowała do metadanych dewelopera w trzecim wierszu oraz do metadanych powiązanych z lokalizacjami, które krzyżują się między wierszem 3. Jeśli na przykład w kolumnie B były powiązane metadane dewelopera, ta strategia dopasowania będzie zgodna z lokalizacją, ponieważ kolumna B krzyżuje się z wierszem 3.