docs(bigquery): fix incorrect links to REST API in reference docs (#9436)

fixes issue #9429

Author: Gurov Ilya

bigquery/google/cloud/bigquery/client.py

@@ -284,7 +284,7 @@ def list_datasets(
             filter (str):
                 Optional. An expression for filtering the results by label.
                 For syntax, see
-                https://cloud.google.com/bigquery/docs/reference/rest/v2/datasets/list#filter.
+                https://cloud.google.com/bigquery/docs/reference/rest/v2/datasets/list#body.QUERY_PARAMETERS.filter
             max_results (int):
                 Optional. Maximum number of datasets to return.
             page_token (str):
@@ -1320,7 +1320,7 @@ def load_table_from_uri(
         """Starts a job for loading data into a table from CloudStorage.
 
         See
-        https://cloud.google.com/bigquery/docs/reference/rest/v2/jobs#configuration.load
+        https://cloud.google.com/bigquery/docs/reference/rest/v2/Job#jobconfigurationload
 
         Arguments:
             source_uris (Union[str, Sequence[str]]):
@@ -1858,7 +1858,7 @@ def copy_table(
         """Copy one or more tables to another table.
 
         See
-        https://cloud.google.com/bigquery/docs/reference/rest/v2/jobs#configuration.copy
+        https://cloud.google.com/bigquery/docs/reference/rest/v2/Job#jobconfigurationtablecopy
 
         Arguments:
             sources (Union[ \
@@ -1949,7 +1949,7 @@ def extract_table(
         """Start a job to extract a table into Cloud Storage files.
 
         See
-        https://cloud.google.com/bigquery/docs/reference/rest/v2/jobs#configuration.extract
+        https://cloud.google.com/bigquery/docs/reference/rest/v2/Job#jobconfigurationextract
 
         Arguments:
             source (Union[ \
@@ -2020,7 +2020,7 @@ def query(
         """Run a SQL query.
 
         See
-        https://cloud.google.com/bigquery/docs/reference/rest/v2/jobs#configuration.query
+        https://cloud.google.com/bigquery/docs/reference/rest/v2/Job#jobconfigurationquery
 
         Arguments:
             query (str):

bigquery/google/cloud/bigquery/dataset.py

@@ -207,7 +207,7 @@ class DatasetReference(object):
     """DatasetReferences are pointers to datasets.
 
     See
-    https://cloud.google.com/bigquery/docs/reference/rest/v2/datasets
+    https://cloud.google.com/bigquery/docs/reference/rest/v2/datasets#datasetreference
 
     Args:
         project (str): The ID of the project
@@ -346,7 +346,7 @@ class Dataset(object):
     """Datasets are containers for tables.
 
     See
-    https://cloud.google.com/bigquery/docs/reference/rest/v2/datasets
+    https://cloud.google.com/bigquery/docs/reference/rest/v2/datasets#resource-dataset
 
     Args:
         dataset_ref (Union[google.cloud.bigquery.dataset.DatasetReference, str]):

bigquery/google/cloud/bigquery/job.py

@@ -296,7 +296,7 @@ class ModelReference(object):
     """ModelReferences are pointers to models.
 
     See
-    https://cloud.google.com/bigquery/docs/reference/rest/v2/models
+    https://cloud.google.com/bigquery/docs/reference/rest/v2/models#modelreference
     """
 
     def __init__(self):

bigquery/google/cloud/bigquery/model.py

@@ -473,7 +473,7 @@ def cache_hit(self):
         """Query results served from cache.
 
         See
-        https://cloud.google.com/bigquery/docs/reference/rest/v2/jobs/query#cacheHit
+        https://cloud.google.com/bigquery/docs/reference/rest/v2/jobs/query#body.QueryResponse.FIELDS.cache_hit
 
         Returns:
             Optional[bool]:
@@ -487,7 +487,7 @@ def complete(self):
         """Server completed query.
 
         See
-        https://cloud.google.com/bigquery/docs/reference/rest/v2/jobs/query#jobComplete
+        https://cloud.google.com/bigquery/docs/reference/rest/v2/jobs/query#body.QueryResponse.FIELDS.job_complete
 
         Returns:
             Optional[bool]:
@@ -501,7 +501,7 @@ def errors(self):
         """Errors generated by the query.
 
         See
-        https://cloud.google.com/bigquery/docs/reference/rest/v2/jobs/query#errors
+        https://cloud.google.com/bigquery/docs/reference/rest/v2/jobs/query#body.QueryResponse.FIELDS.errors
 
         Returns:
             Optional[List[Mapping]]:
@@ -515,7 +515,7 @@ def job_id(self):
         """Job ID of the query job these results are from.
 
         See
-        https://cloud.google.com/bigquery/docs/reference/rest/v2/jobs/query#jobReference
+        https://cloud.google.com/bigquery/docs/reference/rest/v2/jobs/query#body.QueryResponse.FIELDS.job_reference
 
         Returns:
             str: Job ID of the query job.
@@ -527,7 +527,7 @@ def page_token(self):
         """Token for fetching next bach of results.
 
         See
-        https://cloud.google.com/bigquery/docs/reference/rest/v2/jobs/query#pageToken
+        https://cloud.google.com/bigquery/docs/reference/rest/v2/jobs/query#body.QueryResponse.FIELDS.page_token
 
         Returns:
             Optional[str]: Token generated on the server (None until set by the server).
@@ -539,7 +539,7 @@ def total_rows(self):
         """Total number of rows returned by the query.
 
         See
-        https://cloud.google.com/bigquery/docs/reference/rest/v2/jobs/query#totalRows
+        https://cloud.google.com/bigquery/docs/reference/rest/v2/jobs/query#body.QueryResponse.FIELDS.total_rows
 
         Returns:
             Optional[int}: Count generated on the server (None until set by the server).
@@ -553,7 +553,7 @@ def total_bytes_processed(self):
         """Total number of bytes processed by the query.
 
         See
-        https://cloud.google.com/bigquery/docs/reference/rest/v2/jobs/query#totalBytesProcessed
+        https://cloud.google.com/bigquery/docs/reference/rest/v2/jobs/query#body.QueryResponse.FIELDS.total_bytes_processed
 
         Returns:
             Optional[int]: Count generated on the server (None until set by the server).
@@ -567,7 +567,7 @@ def num_dml_affected_rows(self):
         """Total number of rows affected by a DML query.
 
         See
-        https://cloud.google.com/bigquery/docs/reference/rest/v2/jobs/query#numDmlAffectedRows
+        https://cloud.google.com/bigquery/docs/reference/rest/v2/jobs/query#body.QueryResponse.FIELDS.num_dml_affected_rows
 
         Returns:
             Optional[int]: Count generated on the server (None until set by the server).
@@ -581,7 +581,7 @@ def rows(self):
         """Query results.
 
         See
-        https://cloud.google.com/bigquery/docs/reference/rest/v2/jobs/query#rows
+        https://cloud.google.com/bigquery/docs/reference/rest/v2/jobs/query#body.QueryResponse.FIELDS.rows
 
         Returns:
             Optional[List[google.cloud.bigquery.table.Row]]:
@@ -594,7 +594,7 @@ def schema(self):
         """Schema for query results.
 
         See
-        https://cloud.google.com/bigquery/docs/reference/rest/v2/jobs/query#schema
+        https://cloud.google.com/bigquery/docs/reference/rest/v2/jobs/query#body.QueryResponse.FIELDS.schema
 
         Returns:
             Optional[List[SchemaField]]:

bigquery/google/cloud/bigquery/query.py

@@ -183,7 +183,7 @@ def return_type(self):
         time.
 
         See:
-        https://cloud.google.com/bigquery/docs/reference/rest/v2/routines#resource-routine
+        https://cloud.google.com/bigquery/docs/reference/rest/v2/routines#Routine.FIELDS.return_type
         """
         resource = self._properties.get(self._PROPERTY_TO_API_FIELD["return_type"])
         if not resource:
@@ -277,7 +277,7 @@ class RoutineArgument(object):
     """Input/output argument of a function or a stored procedure.
 
     See
-    https://cloud.google.com/bigquery/docs/reference/rest/v2/routines
+    https://cloud.google.com/bigquery/docs/reference/rest/v2/routines#argument
 
     Args:
         ``**kwargs`` (Dict):
@@ -317,7 +317,7 @@ def kind(self):
         ``ANY_TYPE``.
 
         See:
-        https://cloud.google.com/bigquery/docs/reference/rest/v2/routines#ArgumentKind
+        https://cloud.google.com/bigquery/docs/reference/rest/v2/routines#Argument.FIELDS.argument_kind
         """
         return self._properties.get(self._PROPERTY_TO_API_FIELD["kind"])
 
@@ -340,7 +340,7 @@ def data_type(self):
         of a variable, e.g., a function argument.
 
         See:
-        https://cloud.google.com/bigquery/docs/reference/rest/v2/StandardSqlDataType
+        https://cloud.google.com/bigquery/docs/reference/rest/v2/routines#Argument.FIELDS.data_type
         """
         resource = self._properties.get(self._PROPERTY_TO_API_FIELD["data_type"])
         if not resource:
@@ -400,7 +400,7 @@ class RoutineReference(object):
     """A pointer to a routine.
 
     See
-    https://cloud.google.com/bigquery/docs/reference/rest/v2/routines
+    https://cloud.google.com/bigquery/docs/reference/rest/v2/routines#routinereference
     """
 
     def __init__(self):

bigquery/google/cloud/bigquery/routine.py

@@ -51,10 +51,10 @@ class SchemaField(object):
         name (str): the name of the field.
 
         field_type (str): the type of the field. See
-            https://cloud.google.com/bigquery/docs/reference/rest/v2/tables#schema.fields.type
+            https://cloud.google.com/bigquery/docs/reference/rest/v2/tables#TableFieldSchema.FIELDS.type
 
-        mode (str): the mode of the field. See
-            https://cloud.google.com/bigquery/docs/reference/rest/v2/tables#schema.fields.mode
+        mode (str): the mode of the field.  See
+            https://cloud.google.com/bigquery/docs/reference/rest/v2/tables#TableFieldSchema.FIELDS.mode
 
         description (Optional[str]): description for the field.
 
@@ -103,7 +103,7 @@ def field_type(self):
         """str: The type of the field.
 
         See:
-        https://cloud.google.com/bigquery/docs/reference/rest/v2/tables#schema.fields.type
+        https://cloud.google.com/bigquery/docs/reference/rest/v2/tables#TableFieldSchema.FIELDS.type
         """
         return self._field_type
 
@@ -112,7 +112,7 @@ def mode(self):
         """str: The mode of the field.
 
         See:
-        https://cloud.google.com/bigquery/docs/reference/rest/v2/tables#schema.fields.mode
+        https://cloud.google.com/bigquery/docs/reference/rest/v2/tables#TableFieldSchema.FIELDS.mode
         """
         return self._mode
 

bigquery/google/cloud/bigquery/schema.py

@@ -184,7 +184,7 @@ class TableReference(object):
     """TableReferences are pointers to tables.
 
     See
-    https://cloud.google.com/bigquery/docs/reference/rest/v2/tables
+    https://cloud.google.com/bigquery/docs/reference/rest/v2/tables#tablereference
 
     Args:
         dataset_ref (google.cloud.bigquery.dataset.DatasetReference):
@@ -364,7 +364,7 @@ class Table(object):
     """Tables represent a set of rows whose values correspond to a schema.
 
     See
-    https://cloud.google.com/bigquery/docs/reference/rest/v2/tables
+    https://cloud.google.com/bigquery/docs/reference/rest/v2/tables#resource-table
 
     Args:
         table_ref (Union[google.cloud.bigquery.table.TableReference, str]):