Add properties for new job statistics

bigquery/google/cloud/bigquery/job.py

@@ -1418,6 +1418,21 @@ def num_dml_affected_rows(self):
         query_stats = self._query_statistics()
         return query_stats.get('numDmlAffectedRows')
 
+    @property
+    def undeclared_query_paramters(self):
+        """Return undeclared query parameters from job statistics, if present.
+
+        See:
+        https://cloud.google.com/bigquery/docs/reference/rest/v2/jobs#statistics.query.undeclaredQueryParamters
+
+        :rtype: list of dict
+        :returns: mappings describing the undeclared parameters, or an empty
+                  list if the query has not yet completed.
+        """
+        query_stats = self._query_statistics()
+        undeclared = query_stats.get('undeclaredQueryParamters', ())
+        return [copy.deepcopy(parameter) for parameter in undeclared]
+
     def query_results(self):
         """Construct a QueryResults instance, bound to this job.
 

bigquery/tests/unit/test_job.py

@@ -1831,6 +1831,41 @@ def test_num_dml_affected_rows(self):
         query_stats['numDmlAffectedRows'] = num_rows
         self.assertEqual(job.num_dml_affected_rows, num_rows)
 
+    def test_undeclared_query_paramters(self):
+        undeclared = [{
+            "name": 'my_scalar',
+            "parameterType": {
+                "type": 'STRING',
+            },
+        }, {
+            "name": 'my_array',
+            "parameterType": {
+                "type": 'ARRAY',
+                "arrayType": 'INT64',
+            },
+        }, {
+            "name": 'my_struct',
+            "parameterType": {
+                "type": 'STRUCT',
+                "structTypes": [{
+                    "name": 'count',
+                    "type": 'INT64',
+                }],
+            },
+        }]
+        client = _Client(self.PROJECT)
+        job = self._make_one(self.JOB_NAME, self.QUERY, client)
+        self.assertEqual(job.undeclared_query_paramters, [])
+
+        statistics = job._properties['statistics'] = {}
+        self.assertEqual(job.undeclared_query_paramters, [])
+
+        query_stats = statistics['query'] = {}
+        self.assertEqual(job.undeclared_query_paramters, [])
+
+        query_stats['undeclaredQueryParamters'] = undeclared
+        self.assertEqual(job.undeclared_query_paramters, undeclared)
+
     def test_query_results(self):
         from google.cloud.bigquery.query import QueryResults