Inherits from NSObject
Conforms to FBSDKSharing
Declared in FBSDKShareAPI.h

Overview

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.

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

graphNode

The graph node to which content should be shared.

@property (nonatomic, copy) NSString *graphNode

Declared In

FBSDKShareAPI.h

message

The message the person has provided through the custom dialog that will accompany the share content.

@property (nonatomic, copy) NSString *message

Declared In

FBSDKShareAPI.h

Class Methods

shareWithContent:delegate:

Convenience method to build up a share API with content and a delegate.

+ (instancetype)shareWithContent:(id<FBSDKSharingContent>)content delegate:(id<FBSDKSharingDelegate>)delegate

Parameters

content

The content to be shared.

delegate

The receiver’s delegate.

Declared In

FBSDKShareAPI.h

Instance Methods

canShare

A Boolean value that indicates whether the receiver can send the share.

- (BOOL)canShare

Return Value

YES if the receiver can send, otherwise NO.

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.

Declared In

FBSDKShareAPI.h

createOpenGraphObject:

Creates an User Owned Open Graph object without an action.

- (BOOL)createOpenGraphObject:(FBSDKShareOpenGraphObject *)openGraphObject

Parameters

openGraphObject

The open graph object to create.

Return Value

YES if the receiver was able to send the request to create the object, otherwise NO.

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

Declared In

FBSDKShareAPI.h

share

Begins the send from the receiver.

- (BOOL)share

Return Value

YES if the receiver was able to send the share, otherwise NO.

Declared In

FBSDKShareAPI.h