Merge branch 'main' into release-please--branches--main

Author: chalmerlowe

google/cloud/bigquery/client.py

@@ -328,6 +328,15 @@ def get_service_account_email(
     ) -> str:
         """Get the email address of the project's BigQuery service account
 
+        Example:
+
+        .. code-block:: python
+
+            from google.cloud import bigquery
+            client = bigquery.Client()
+            client.get_service_account_email()
+            # returns an email similar to: [email protected]
+
         Note:
             This is the service account that BigQuery uses to manage tables
             encrypted by a key in KMS.
@@ -345,13 +354,6 @@ def get_service_account_email(
             str:
                 service account email address
 
-        Example:
-
-            >>> from google.cloud import bigquery
-            >>> client = bigquery.Client()
-            >>> client.get_service_account_email()
-            [email protected]
-
         """
         if project is None:
             project = self.project
@@ -629,9 +631,19 @@ def create_dataset(
     ) -> Dataset:
         """API call: create the dataset via a POST request.
 
+
         See
         https://cloud.google.com/bigquery/docs/reference/rest/v2/datasets/insert
 
+        Example:
+
+        .. code-block:: python
+
+            from google.cloud import bigquery
+            client = bigquery.Client()
+            dataset = bigquery.Dataset('my_project.my_dataset')
+            dataset = client.create_dataset(dataset)
+
         Args:
             dataset (Union[ \
                 google.cloud.bigquery.dataset.Dataset, \
@@ -658,14 +670,6 @@ def create_dataset(
         Raises:
             google.cloud.exceptions.Conflict:
                 If the dataset already exists.
-
-        Example:
-
-            >>> from google.cloud import bigquery
-            >>> client = bigquery.Client()
-            >>> dataset = bigquery.Dataset('my_project.my_dataset')
-            >>> dataset = client.create_dataset(dataset)
-
         """
         dataset = self._dataset_from_arg(dataset)
         if isinstance(dataset, DatasetReference):