Support for "none python" parameters used in the put_object method

facebook.py

@@ -111,7 +111,7 @@ def get_connections(self, id, connection_name, **args):
  """Fetchs the connections for given object."""
  return self.request(id + "/" + connection_name, args)
 
- def put_object(self, parent_object, connection_name, **data):
+ def put_object(self, parent_object, connection_name, post_args=None, **data):
  """Writes the given object to the graph, connected to the given parent.
 
  For example,
@@ -128,6 +128,25 @@ def put_object(self, parent_object, connection_name, **data):
  See http://developers.facebook.com/docs/api#publishing for all
  of the supported writeable objects.
 
+ Some parameters that can be sent to the Facebook API can not be passed
+ to the method using kwargs, for example 'fb:explicitly_shared'. These
+ needs to be set using the post_args argument dict. If the same key is
+ used both in the post_arg dict and passed in as a kwarg, the kwarg will
+ take precedence.
+
+ Usage example,
+
+ graph.put_object(
+ "me",
+ "nyccookbook:cook",
+ recipe="http://www.sugarmedia.com/nyccookbook/cookie.html",
+ post_args={"fb:explicitly_shared": True}
+ )
+
+ will share the object as a post as described in the docs. See
+ https://developers.facebook.com/docs/opengraph/guides/explicit-sharing/
+ for details.
+
  Certain write operations require extended permissions. For
  example, publishing to a user's feed requires the
  "publish_actions" permission. See
@@ -136,8 +155,11 @@ def put_object(self, parent_object, connection_name, **data):
 
  """
  assert self.access_token, "Write operations require an access token"
+ if post_args is None:
+ post_args = {}
+ post_args.update(data)
  return self.request(parent_object + "/" + connection_name,
- post_args=data)
+ post_args=post_args)
 
  def put_wall_post(self, message, attachment={}, profile_id="me"):
  """Writes a wall post to the given profile's wall.
@@ -501,6 +523,7 @@ def auth_url(app_id, canvas_url, perms=None, **kwargs):
  kvps.update(kwargs)
  return url + urllib.urlencode(kvps)
 
+
 def get_access_token_from_code(code, redirect_uri, app_id, app_secret):
  """Get an access token from the "code" returned from an OAuth dialog.