DataFilter

Filtre qui décrit les données à sélectionner ou à renvoyer à partir d'une requête. Pour en savoir plus, consultez Lire, écrire et rechercher des métadonnées.

Représentation JSON
{

  "developerMetadataLookup": {
    object (DeveloperMetadataLookup)
  },
  "a1Range": string,
  "gridRange": {
    object (GridRange)
  }
}
Champs
Champ d'union filter. Types de filtres pouvant limiter les données sélectionnées. filter ne peut être qu'un des éléments suivants :
developerMetadataLookup

object (DeveloperMetadataLookup)

Sélectionne les données associées aux métadonnées de développeur correspondant aux critères décrits par ce DeveloperMetadataLookup.

a1Range

string

Sélectionne les données qui correspondent à la plage A1 spécifiée.

gridRange

object (GridRange)

Sélectionne les données qui correspondent à la plage décrite par GridRange.

DeveloperMetadataLookup

Sélectionne DeveloperMetadata correspondant à tous les champs spécifiés. Par exemple, si seul un ID de métadonnées est spécifié, cela considère le DeveloperMetadata avec cet ID unique particulier. Si une clé de métadonnées est spécifiée, toutes les métadonnées de développeur associées à cette clé sont prises en compte. Si une clé, une visibilité et un type de localisation sont tous spécifiés, toutes les métadonnées de développeur ayant cette clé et cette visibilité associées à une localisation de ce type sont prises en compte. En général, cela sélectionne tous les DeveloperMetadata qui correspondent à l'intersection de tous les champs spécifiés. Vous pouvez spécifier n'importe quel champ ou combinaison de champs.

Représentation JSON
{
  "locationType": enum (DeveloperMetadataLocationType),
  "metadataLocation": {
    object (DeveloperMetadataLocation)
  },
  "locationMatchingStrategy": enum (DeveloperMetadataLocationMatchingStrategy),
  "metadataId": integer,
  "metadataKey": string,
  "metadataValue": string,
  "visibility": enum (DeveloperMetadataVisibility)
}
Champs
locationType

enum (DeveloperMetadataLocationType)

Limite les métadonnées de développeur sélectionnées aux entrées associées à des lieux du type spécifié. Par exemple, lorsque ce champ est spécifié comme ROW, cette recherche ne prend en compte que les métadonnées de développeur associées aux lignes. Si le champ n'est pas spécifié, tous les types de lieux sont pris en compte. Ce champ ne peut pas être spécifié comme SPREADSHEET lorsque locationMatchingStrategy est spécifié comme INTERSECTING ou lorsque metadataLocation est spécifié comme emplacement autre qu'une feuille de calcul. Les métadonnées de la feuille de calcul ne peuvent pas croiser l'emplacement d'autres métadonnées de développeur. Ce champ doit également être laissé non spécifié lorsque locationMatchingStrategy est défini sur EXACT.

metadataLocation

object (DeveloperMetadataLocation)

Limite les métadonnées de développeur sélectionnées aux entrées associées à l'emplacement spécifié. Ce champ correspond soit à des lieux exacts, soit à tous les lieux qui se croisent selon le locationMatchingStrategy spécifié.

locationMatchingStrategy

enum (DeveloperMetadataLocationMatchingStrategy)

Détermine comment cette recherche correspond à l'établissement. Si ce champ est défini sur "EXACT", seules les métadonnées de développement associées à l'emplacement exact spécifié sont mises en correspondance. Si ce champ est défini sur INTERSECTING, les métadonnées de développement associées aux emplacements qui se croisent sont également mises en correspondance. Si ce champ n'est pas spécifié, la valeur par défaut est INTERSECTING. Si ce champ est spécifié, un metadataLocation doit également l'être.

metadataId

integer

Limite les métadonnées de développeur sélectionnées à celles qui correspondent à un DeveloperMetadata.metadata_id.

metadataKey

string

Limite les métadonnées de développeur sélectionnées à celles qui correspondent à un DeveloperMetadata.metadata_key.

metadataValue

string

Limite les métadonnées de développeur sélectionnées à celles qui correspondent à un DeveloperMetadata.metadata_value.

visibility

enum (DeveloperMetadataVisibility)

Limite les métadonnées de développeur sélectionnées à celles qui correspondent à un DeveloperMetadata.visibility. Si aucune n'est spécifiée, toutes les métadonnées de développeur visibles par le projet demandeur sont prises en compte.

DeveloperMetadataLocationMatchingStrategy

Énumération des stratégies de mise en correspondance des emplacements des métadonnées de développement.

Enums
DEVELOPER_METADATA_LOCATION_MATCHING_STRATEGY_UNSPECIFIED Valeur par défaut. Cette valeur ne doit pas être utilisée.
EXACT_LOCATION Indique qu'un lieu spécifié doit correspondre exactement. Par exemple, si la ligne 3 est spécifiée comme emplacement, cette stratégie de correspondance ne correspondra qu'aux métadonnées de développeur également associées à la ligne 3. Les métadonnées associées à d'autres lieux ne seront pas prises en compte.
INTERSECTING_LOCATION Indique qu'un emplacement spécifié doit correspondre à cet emplacement exact ainsi qu'à tous les emplacements qui l'intersectent. Par exemple, si la troisième ligne est spécifiée comme emplacement, cette stratégie de correspondance associe les métadonnées de développeur associées à la troisième ligne ainsi que les métadonnées associées aux emplacements qui croisent la troisième ligne. Par exemple, si des métadonnées de développeur sont associées à la colonne B, cette stratégie de correspondance correspondra également à cet emplacement, car la colonne B croise la ligne 3.