docs: Minor formatting

google/cloud/bigquery_storage_v1/services/big_query_read/async_client.py

@@ -56,6 +56,7 @@
 
 class BigQueryReadAsyncClient:
  """BigQuery Read API.
+
  The Read API can be used to read data from BigQuery.
  """
 

google/cloud/bigquery_storage_v1/services/big_query_read/client.py

@@ -93,6 +93,7 @@ def get_transport_class(
 
 class BigQueryReadClient(metaclass=BigQueryReadClientMeta):
  """BigQuery Read API.
+
  The Read API can be used to read data from BigQuery.
  """
 

google/cloud/bigquery_storage_v1/services/big_query_read/transports/grpc.py

@@ -33,6 +33,7 @@ class BigQueryReadGrpcTransport(BigQueryReadTransport):
  """gRPC backend transport for BigQueryRead.
 
  BigQuery Read API.
+
  The Read API can be used to read data from BigQuery.
 
  This class defines the same methods as the primary client, so the

google/cloud/bigquery_storage_v1/services/big_query_read/transports/grpc_asyncio.py

@@ -34,6 +34,7 @@ class BigQueryReadGrpcAsyncIOTransport(BigQueryReadTransport):
  """gRPC AsyncIO backend transport for BigQueryRead.
 
  BigQuery Read API.
+
  The Read API can be used to read data from BigQuery.
 
  This class defines the same methods as the primary client, so the

google/cloud/bigquery_storage_v1/services/big_query_write/async_client.py

@@ -57,7 +57,9 @@
 
 class BigQueryWriteAsyncClient:
  """BigQuery Write API.
+
  The Write API can be used to write data to BigQuery.
+
  For supplementary information about the Write API, see:
 
  https://cloud.google.com/bigquery/docs/write-api

google/cloud/bigquery_storage_v1/services/big_query_write/client.py

@@ -94,7 +94,9 @@ def get_transport_class(
 
 class BigQueryWriteClient(metaclass=BigQueryWriteClientMeta):
  """BigQuery Write API.
+
  The Write API can be used to write data to BigQuery.
+
  For supplementary information about the Write API, see:
 
  https://cloud.google.com/bigquery/docs/write-api

google/cloud/bigquery_storage_v1/services/big_query_write/transports/grpc.py

@@ -33,7 +33,9 @@ class BigQueryWriteGrpcTransport(BigQueryWriteTransport):
  """gRPC backend transport for BigQueryWrite.
 
  BigQuery Write API.
+
  The Write API can be used to write data to BigQuery.
+
  For supplementary information about the Write API, see:
 
  https://cloud.google.com/bigquery/docs/write-api

google/cloud/bigquery_storage_v1/services/big_query_write/transports/grpc_asyncio.py

@@ -34,7 +34,9 @@ class BigQueryWriteGrpcAsyncIOTransport(BigQueryWriteTransport):
  """gRPC AsyncIO backend transport for BigQueryWrite.
 
  BigQuery Write API.
+
  The Write API can be used to write data to BigQuery.
+
  For supplementary information about the Write API, see:
 
  https://cloud.google.com/bigquery/docs/write-api

google/cloud/bigquery_storage_v1/types/arrow.py

@@ -36,6 +36,7 @@ class ArrowSchema(proto.Message):
  serialized to bytes using IPC:
 
  https://arrow.apache.org/docs/format/Columnar.html#serialization-and-interprocess-communication-ipc
+
  See code samples on how this message can be deserialized.
 
  Attributes:

google/cloud/bigquery_storage_v1/types/avro.py

@@ -73,12 +73,14 @@ class AvroSerializationOptions(proto.Message):
  Attributes:
  enable_display_name_attribute (bool):
  Enable displayName attribute in Avro schema.
+
  The Avro specification requires field names to
  be alphanumeric. By default, in cases when
  column names do not conform to these
  requirements (e.g. non-ascii unicode codepoints)
  and Avro is requested as an output format, the
  CreateReadSession call will fail.
+
  Setting this field to true, populates avro field
  names with a placeholder value and populates a
  "displayName" attribute for every avro field

google/cloud/bigquery_storage_v1/types/stream.py

@@ -155,6 +155,7 @@ class ReadSession(proto.Message):
  (e.g. All using the same ID for all sessions
  needed to complete a Spark SQL query is
  reasonable).
+
  Maximum length is 256 bytes.
  """
 

google/cloud/bigquery_storage_v1beta2/services/big_query_read/async_client.py

@@ -56,7 +56,9 @@
 
 class BigQueryReadAsyncClient:
  """BigQuery Read API.
+
  The Read API can be used to read data from BigQuery.
+
  New code should use the v1 Read API going forward, if they don't
  use Write API at the same time.
  """

google/cloud/bigquery_storage_v1beta2/services/big_query_read/client.py

@@ -93,7 +93,9 @@ def get_transport_class(
 
 class BigQueryReadClient(metaclass=BigQueryReadClientMeta):
  """BigQuery Read API.
+
  The Read API can be used to read data from BigQuery.
+
  New code should use the v1 Read API going forward, if they don't
  use Write API at the same time.
  """

google/cloud/bigquery_storage_v1beta2/services/big_query_read/transports/grpc.py

@@ -33,7 +33,9 @@ class BigQueryReadGrpcTransport(BigQueryReadTransport):
  """gRPC backend transport for BigQueryRead.
 
  BigQuery Read API.
+
  The Read API can be used to read data from BigQuery.
+
  New code should use the v1 Read API going forward, if they don't
  use Write API at the same time.
 

google/cloud/bigquery_storage_v1beta2/services/big_query_read/transports/grpc_asyncio.py

@@ -34,7 +34,9 @@ class BigQueryReadGrpcAsyncIOTransport(BigQueryReadTransport):
  """gRPC AsyncIO backend transport for BigQueryRead.
 
  BigQuery Read API.
+
  The Read API can be used to read data from BigQuery.
+
  New code should use the v1 Read API going forward, if they don't
  use Write API at the same time.
 

google/cloud/bigquery_storage_v1beta2/types/arrow.py

@@ -36,6 +36,7 @@ class ArrowSchema(proto.Message):
  serialized to bytes using IPC:
 
  https://arrow.apache.org/docs/format/Columnar.html#serialization-and-interprocess-communication-ipc
+
  See code samples on how this message can be deserialized.
 
  Attributes: