docs: clarify the api_method arg for client.query() (googleapis#2277)

shollyman · web-flow · commit 8a13c12905ff · 2025-09-04T11:25:49.000-07:00
* docs: clarify the api_method arg for client.query()
diff --git a/google/cloud/bigquery/client.py b/google/cloud/bigquery/client.py
@@ -3519,7 +3519,8 @@ def query(
                 specified here becomes the default ``job_retry`` for
                 ``result()``, where it can also be specified.
             api_method (Union[str, enums.QueryApiMethod]):
-                Method with which to start the query job.
+                Method with which to start the query job.  By default,
+                the jobs.insert API is used for starting a query.
 
                 See :class:`google.cloud.bigquery.enums.QueryApiMethod` for
                 details on the difference between the query start methods.
