addressing feedback from @Jeff-Meadows:

- moved password argument to end of argument list
- updated param doc to be correct in the event of no password
- updated param doc to notify that this is a premium feature

Author: Frencil

boxsdk/object/item.py

@@ -159,7 +159,7 @@ def move(self, parent_folder):
         }
         return self.update_info(data)
 
-    def get_shared_link(self, access=None, etag=None, unshared_at=None, password=None, allow_download=None, allow_preview=None):
+    def get_shared_link(self, access=None, etag=None, unshared_at=None, allow_download=None, allow_preview=None, password=None):
         """Get a shared link for the item with the given access permissions.
 
         :param access:
@@ -176,8 +176,6 @@ def get_shared_link(self, access=None, etag=None, unshared_at=None, password=Non
             and has permission to set expiration dates.
         :type unshared_at:
             :class:`datetime.date` or None
-        :param password:
-            The password required to view this link. If no password is specified, the default password will be used.
         :type password:
             `unicode` or None
         :param allow_download:
@@ -190,6 +188,9 @@ def get_shared_link(self, access=None, etag=None, unshared_at=None, password=Non
             If this parameter is None, the default setting will be used.
         :type allow_preview:
             `bool` or None
+        :param password:
+            The password required to view this link. If no password is specified then no password will be set.
+            Please notice that this is a premium feature, which might not be available to your app.
         :returns:
             The URL of the shared link.
         :rtype:
@@ -205,16 +206,16 @@ def get_shared_link(self, access=None, etag=None, unshared_at=None, password=Non
         if unshared_at is not None:
             data['shared_link']['unshared_at'] = unshared_at.isoformat()
 
-        if password is not None:
-            data['shared_link']['password'] = password
-
         if allow_download is not None or allow_preview is not None:
             data['shared_link']['permissions'] = permissions = {}
             if allow_download is not None:
                 permissions['can_download'] = allow_download
             if allow_preview is not None:
                 permissions['can_preview'] = allow_preview
 
+        if password is not None:
+            data['shared_link']['password'] = password
+
         item = self.update_info(data, etag=etag)
         return item.shared_link['url']