FBSDKShareAPI Class Reference
Inherits from | NSObject |
Conforms to | FBSDKSharing |
Declared in | FBSDKShareAPI.h |
Overview
A utility class for sharing through the graph API. Using this class requires an access token that has been granted the “publish_actions” permission.
FBSDKShareAPI network requests are scheduled on the current run loop in the default run loop mode (like NSURLConnection). If you want to use FBSDKShareAPI in a background thread, you must manage the run loop yourself.
Tasks
-
+ shareWithContent:delegate:
-
message
property -
graphNode
property -
accessToken
property -
– canShare
-
– createOpenGraphObject:
-
– share
Properties
accessToken
The access token used when performing a share. The access token must have the “publish_actions” permission granted.
@property (nonatomic, strong) FBSDKAccessToken *accessToken
Discussion
Defaults to [FBSDKAccessToken currentAccessToken]. Setting this to nil will revert the access token to [FBSDKAccessToken currentAccessToken].
Declared In
FBSDKShareAPI.h
Class Methods
shareWithContent:delegate:
Convenience method to build up a share API with content and a delegate. - Parameter content: The content to be shared. - Parameter delegate: The receiver’s delegate.
+ (instancetype)shareWithContent:(id<FBSDKSharingContent>)content delegate:(id<FBSDKSharingDelegate>)delegate
Declared In
FBSDKShareAPI.h
Instance Methods
canShare
A Boolean value that indicates whether the receiver can send the share.
- (BOOL)canShare
Discussion
May return NO if the appropriate Facebook app is not installed and is required or an access token is required but not available. This method does not validate the content on the receiver, so this can be checked before building up the content.
- See:[FBSDKSharing validateWithError:]
- Returns: YES if the receiver can send, otherwise NO.
Declared In
FBSDKShareAPI.h
createOpenGraphObject:
Creates an User Owned Open Graph object without an action. - Parameter openGraphObject: The open graph object to create.
- (BOOL)createOpenGraphObject:(FBSDKShareOpenGraphObject *)openGraphObject
Discussion
Use this method to create an object alone, when an action is not going to be posted with the object. If the object will be used within an action, just put the object in the action and share that as the shareContent and the object will be created in the process. The delegate will be messaged with the results.
Also see https://developers.facebook.com/docs/sharing/opengraph/object-api#objectapi-creatinguser
- Returns: YES if the receiver was able to send the request to create the object, otherwise NO.
Declared In
FBSDKShareAPI.h