Distinguish API helper docstrings.

Add links to relevant REST API docs.

Addresses:
#1820 (comment)

Author: tseaver

gcloud/logging/client.py

@@ -53,21 +53,34 @@ class Client(JSONClient):
 
     @property
     def logging_api(self):
-        """Helper for logging-related API calls."""
+        """Helper for logging-related API calls.
+
+        See:
+        https://cloud.google.com/logging/docs/api/ref_v2beta1/rest/v2beta1/entries
+        https://cloud.google.com/logging/docs/api/ref_v2beta1/rest/v2beta1/projects.logs
+        """
         if self._logging_api is None:
             self._logging_api = _LoggingAPI(self.connection)
         return self._logging_api
 
     @property
     def sinks_api(self):
-        """Helper for logging-related API calls."""
+        """Helper for log sink-related API calls.
+
+        See:
+        https://cloud.google.com/logging/docs/api/ref_v2beta1/rest/v2beta1/projects.sinks
+        """
         if self._sinks_api is None:
             self._sinks_api = _SinksAPI(self.connection)
         return self._sinks_api
 
     @property
     def metrics_api(self):
-        """Helper for logging-related API calls."""
+        """Helper for log metric-related API calls.
+
+        See:
+        https://cloud.google.com/logging/docs/api/ref_v2beta1/rest/v2beta1/projects.metrics
+        """
         if self._metrics_api is None:
             self._metrics_api = _MetricsAPI(self.connection)
         return self._metrics_api

gcloud/logging/connection.py

@@ -51,6 +51,10 @@ class Connection(base_connection.JSONConnection):
 class _LoggingAPI(object):
     """Helper mapping logging-related APIs.
 
+    See:
+    https://cloud.google.com/logging/docs/api/ref_v2beta1/rest/v2beta1/entries
+    https://cloud.google.com/logging/docs/api/ref_v2beta1/rest/v2beta1/projects.logs
+
     :type connection: :class:`gcloud.logging.connection.Connection`
     :param connection: the connection used to make API requests.
     """
@@ -164,6 +168,9 @@ def logger_delete(self, project, logger_name):
 class _SinksAPI(object):
     """Helper mapping sink-related APIs.
 
+    See:
+    https://cloud.google.com/logging/docs/api/ref_v2beta1/rest/v2beta1/projects.sinks
+
     :type connection: :class:`gcloud.logging.connection.Connection`
     :param connection: the connection used to make API requests.
     """
@@ -298,6 +305,9 @@ def sink_delete(self, project, sink_name):
 class _MetricsAPI(object):
     """Helper mapping sink-related APIs.
 
+    See:
+    https://cloud.google.com/logging/docs/api/ref_v2beta1/rest/v2beta1/projects.metrics
+
     :type connection: :class:`gcloud.logging.connection.Connection`
     :param connection: the connection used to make API requests.
     """