feat: change query parameter to query_or_table in read_gbq (#127)

Thank you for opening a Pull Request! Before submitting your PR, there are a few things you can do to make sure it goes smoothly:
- [ ] Make sure to open an issue as a [bug/issue](https://togithub.com/googleapis/python-bigquery-dataframes/issues/new/choose) before writing your code!  That way we can discuss the change, evaluate designs, and agree on the general idea
- [ ] Ensure the tests and linter pass
- [ ] Code coverage does not decrease (if any source code was changed)
- [ ] Appropriate docs were updated (if necessary)

Fixes #<issue_number_goes_here> 🦕

Author: ashleyxuu

bigframes/pandas/__init__.py

@@ -290,16 +290,16 @@ def read_json(
 
 
 def read_gbq(
-    query: str,
+    query_or_table: str,
     *,
     index_col: Iterable[str] | str = (),
     col_order: Iterable[str] = (),
     max_results: Optional[int] = None,
 ) -> bigframes.dataframe.DataFrame:
-    _set_default_session_location_if_possible(query)
+    _set_default_session_location_if_possible(query_or_table)
     return global_session.with_default_session(
         bigframes.session.Session.read_gbq,
-        query,
+        query_or_table,
         index_col=index_col,
         col_order=col_order,
         max_results=max_results,

bigframes/session/__init__.py

@@ -262,17 +262,17 @@ def close(self):
 
     def read_gbq(
         self,
-        query: str,
+        query_or_table: str,
         *,
         index_col: Iterable[str] | str = (),
         col_order: Iterable[str] = (),
         max_results: Optional[int] = None,
         # Add a verify index argument that fails if the index is not unique.
     ) -> dataframe.DataFrame:
         # TODO(b/281571214): Generate prompt to show the progress of read_gbq.
-        if _is_query(query):
+        if _is_query(query_or_table):
             return self._read_gbq_query(
-                query,
+                query_or_table,
                 index_col=index_col,
                 col_order=col_order,
                 max_results=max_results,
@@ -283,7 +283,7 @@ def read_gbq(
             # deterministic query so we can avoid serializing if we have a
             # unique index.
             return self._read_gbq_table(
-                query,
+                query_or_table,
                 index_col=index_col,
                 col_order=col_order,
                 max_results=max_results,

third_party/bigframes_vendored/pandas/io/gbq.py

@@ -11,7 +11,7 @@
 class GBQIOMixin:
     def read_gbq(
         self,
-        query: str,
+        query_or_table: str,
         *,
         index_col: Iterable[str] | str = (),
         col_order: Iterable[str] = (),
@@ -69,7 +69,7 @@ def read_gbq(
             [5 rows x 3 columns]
 
         Args:
-            query (str):
+            query_or_table (str):
                 A SQL string to be executed or a BigQuery table to be read. The
                 table must be specified in the format of
                 `project.dataset.tablename` or `dataset.tablename`.