Fixed doc strings

elibixby · elibixby · commit a5b3bd8547da · 2015-06-19T11:06:25.000-07:00
diff --git a/bigquery/samples/export_data_to_cloud_storage.py b/bigquery/samples/export_data_to_cloud_storage.py
@@ -22,12 +22,16 @@ def export_table(service, cloud_storage_path,
                  projectId, datasetId, tableId,
                  num_retries=5):
     """
-    service: initialized and authorized bigquery
-    google-api-client object,
-    cloud_storage_path: fully qualified
-    path to a Google Cloud Storage location,
-    e.g. gs://mybucket/myfolder/
-    returns: an extract job resource representing the
+    Starts an export job
+
+    Args:
+        service: initialized and authorized bigquery
+        google-api-client object,
+        cloud_storage_path: fully qualified
+        path to a Google Cloud Storage location,
+        e.g. gs://mybucket/myfolder/
+
+    Returns: an extract job resource representing the
     job, see https://cloud.google.com/bigquery/docs/reference/v2/jobs
     """
     # Generate a unique job_id so retries
diff --git a/bigquery/samples/load_data_by_post.py b/bigquery/samples/load_data_by_post.py
@@ -23,11 +23,16 @@
 # [START make_post]
 def make_post(http, schema, data, projectId, datasetId, tableId):
     """
-    http: an authorized httplib2 client,
-    schema: a valid bigquery schema,
-    see https://cloud.google.com/bigquery/docs/reference/v2/tables,
-    data: valid JSON to insert into the table
-    returns: an http.request object
+    Creates an http POST request for loading data into
+    a bigquery table
+
+    Args:
+        http: an authorized httplib2 client,
+        schema: a valid bigquery schema,
+        see https://cloud.google.com/bigquery/docs/reference/v2/tables,
+        data: valid JSON to insert into the table
+
+    Returns: an http.request object
     """
     url = ('https://www.googleapis.com/upload/bigquery/v2/projects/' +
            projectId + '/jobs')
diff --git a/bigquery/samples/load_data_from_csv.py b/bigquery/samples/load_data_from_csv.py
@@ -21,13 +21,17 @@
 def load_table(service, source_schema, source_csv,
                projectId, datasetId, tableId, num_retries=5):
     """
-    service: an initialized and authorized bigquery
-    google-api-client object
-    source_schema: a valid bigquery schema,
-    see https://cloud.google.com/bigquery/docs/reference/v2/tables
-    source_csv: the fully qualified Google Cloud Storage location of
-    the data to load into your table
-    returns: a bigquery load job, see 
+    Starts a job to load a bigquery table from CSV
+
+    Args:
+        service: an initialized and authorized bigquery
+        google-api-client object
+        source_schema: a valid bigquery schema,
+        see https://cloud.google.com/bigquery/docs/reference/v2/tables
+        source_csv: the fully qualified Google Cloud Storage location of
+        the data to load into your table
+
+    Returns: a bigquery load job, see
     https://cloud.google.com/bigquery/docs/reference/v2/jobs#configuration.load
     """
 
