@@ -85,32 +85,74 @@ message StructuredQuery {
85
85
// Unspecified. This value must not be used.
86
86
OPERATOR_UNSPECIFIED = 0 ;
87
87
88
- // Less than. Requires that the field come first in `order_by`.
88
+ // The given `field` is less than the given `value`.
89
+ //
90
+ // Requires:
91
+ //
92
+ // * That `field` come first in `order_by`.
89
93
LESS_THAN = 1 ;
90
94
91
- // Less than or equal. Requires that the field come first in `order_by`.
95
+ // The given `field` is less than or equal to the given `value`.
96
+ //
97
+ // Requires:
98
+ //
99
+ // * That `field` come first in `order_by`.
92
100
LESS_THAN_OR_EQUAL = 2 ;
93
101
94
- // Greater than. Requires that the field come first in `order_by`.
102
+ // The given `field` is greater than the given `value`.
103
+ //
104
+ // Requires:
105
+ //
106
+ // * That `field` come first in `order_by`.
95
107
GREATER_THAN = 3 ;
96
108
97
- // Greater than or equal. Requires that the field come first in
98
- // `order_by`.
109
+ // The given `field` is greater than or equal to the given `value`.
110
+ //
111
+ // Requires:
112
+ //
113
+ // * That `field` come first in `order_by`.
99
114
GREATER_THAN_OR_EQUAL = 4 ;
100
115
101
- // Equal .
116
+ // The given `field` is equal to the given `value`. .
102
117
EQUAL = 5 ;
103
118
104
- // Contains. Requires that the field is an array.
119
+ // The given `field` is not equal to the given `value`.
120
+ //
121
+ // Requires:
122
+ //
123
+ // * No other `NOT_EQUAL`, `NOT_IN`, `IS_NOT_NULL`, or `IS_NOT_NAN`.
124
+ // * That `field` comes first in the `order_by`.
125
+ NOT_EQUAL = 6 ;
126
+
127
+ // The given `field` is an array that contains the given `value`.
105
128
ARRAY_CONTAINS = 7 ;
106
129
107
- // In. Requires that `value` is a non-empty ArrayValue with at most 10
108
- // values.
130
+ // The given `field` is equal to at least one value in the given array.
131
+ //
132
+ // Requires:
133
+ //
134
+ // * That `value` is a non-empty `ArrayValue` with at most 10 values.
135
+ // * No other `IN` or `ARRAY_CONTAINS_ANY`. (-- or `NOT_IN` --)
109
136
IN = 8 ;
110
137
111
- // Contains any. Requires that the field is an array and
112
- // `value` is a non-empty ArrayValue with at most 10 values.
138
+ // The given `field` is an array that contains any of the values in the
139
+ // given array.
140
+ //
141
+ // Requires:
142
+ //
143
+ // * That `value` is a non-empty `ArrayValue` with at most 10 values.
144
+ // * No other `IN` or `ARRAY_CONTAINS_ANY`. (-- or `NOT_IN` --)
113
145
ARRAY_CONTAINS_ANY = 9 ;
146
+
147
+ // The value of the `field` is not in the given array.
148
+ //
149
+ // Requires:
150
+ //
151
+ // * That `value` is a non-empty `ArrayValue` with at most 10 values.
152
+ // * No other `IN`, `ARRAY_CONTAINS_ANY`, `NOT_IN`, `NOT_EQUAL`,
153
+ // `IS_NOT_NULL`, or `IS_NOT_NAN`.
154
+ // * That `field` comes first in the `order_by`.
155
+ NOT_IN = 10 ;
114
156
}
115
157
116
158
// The field to filter by.
0 commit comments