Document that app code should not pass 'dataset_id' to 'Key.__init__'.

tseaver · tseaver · commit 720fdc90fe60 · 2014-10-27T14:14:26.000-04:00
Only the 'helpers.key_from_protobuf' factory should pass it. Fixes #293.
diff --git a/gcloud/datastore/key.py b/gcloud/datastore/key.py
@@ -24,7 +24,9 @@ def __init__(self, path=None, namespace=None, dataset_id=None):
 
         :type dataset_id: string
         :param dataset: The dataset ID assigned by back-end for the key.
-                        Leave as None for newly-created keys.
+                        Application code should leave this field None;
+                        expected to be set only by
+                        :func:`gcloud.datastore.helprs.key_from_protobuf`.
         """
         self._path = path or [{'kind': ''}]
         self._namespace = namespace
