docs: add/reformat return types for cloud RAD docs (#1582)

leahecole · web-flow · commit 6efdce13cc3b · 2023-06-09T11:01:56.000-04:00
* docs: add/reformat return types for cloud RAD docs

* fix typos
diff --git a/google/cloud/bigquery/client.py b/google/cloud/bigquery/client.py
@@ -327,7 +327,8 @@ def get_service_account_email(
                 before using ``retry``.
 
         Returns:
-            str: service account email address
+            str:
+                service account email address
 
         Example:
 
@@ -1932,7 +1933,8 @@ def job_from_resource(
             resource (Dict): one job resource from API response
 
         Returns:
-            The job instance, constructed via the resource.
+            Union[job.CopyJob, job.ExtractJob, job.LoadJob, job.QueryJob, job.UnknownJob]:
+                The job instance, constructed via the resource.
         """
         config = resource.get("configuration", {})
         if "load" in config:
@@ -2064,7 +2066,8 @@ def get_job(
                 before using ``retry``.
 
         Returns:
-            Job instance, based on the resource returned by the API.
+            Union[job.LoadJob, job.CopyJob, job.ExtractJob, job.QueryJob, job.UnknownJob]:
+                Job instance, based on the resource returned by the API.
         """
         extra_params = {"projection": "full"}
 
@@ -3954,12 +3957,13 @@ def _schema_to_json_file_object(self, schema_list, file_obj):
         """
         json.dump(schema_list, file_obj, indent=2, sort_keys=True)
 
-    def schema_from_json(self, file_or_path: "PathType"):
+    def schema_from_json(self, file_or_path: "PathType") -> List[SchemaField]:
         """Takes a file object or file path that contains json that describes
         a table schema.
 
         Returns:
-            List of schema field objects.
+            List[SchemaField]:
+                List of :class:`~google.cloud.bigquery.schema.SchemaField` objects.
         """
         if isinstance(file_or_path, io.IOBase):
             return self._schema_from_json_file_object(file_or_path)
