| | |
| | | #import <Foundation/Foundation.h> |
| | | |
| | | #import <FBSDKCoreKit/FBSDKCopying.h> |
| | | #import <FBSDKShareKit/FBSDKSharingValidation.h> |
| | | |
| | | NS_ASSUME_NONNULL_BEGIN |
| | | |
| | | @class FBSDKHashtag; |
| | | |
| | | /** |
| | | A base interface for content to be shared. |
| | | */ |
| | | @protocol FBSDKSharingContent <FBSDKCopying, NSSecureCoding> |
| | | NS_SWIFT_NAME(SharingContent) |
| | | @protocol FBSDKSharingContent <FBSDKCopying, FBSDKSharingValidation, NSSecureCoding> |
| | | |
| | | /** |
| | | URL for the content being shared. |
| | | |
| | | This URL will be checked for all link meta tags for linking in platform specific ways. See documentation |
| | | for App Links (https://developers.facebook.com/docs/applinks/) |
| | | - Returns: URL representation of the content link |
| | | @return URL representation of the content link |
| | | */ |
| | | @property (nonatomic, copy) NSURL *contentURL; |
| | | |
| | | /** |
| | | Hashtag for the content being shared. |
| | | - Returns: The hashtag for the content being shared. |
| | | @return The hashtag for the content being shared. |
| | | */ |
| | | @property (nonatomic, copy) FBSDKHashtag *hashtag; |
| | | @property (nonatomic, copy, nullable) FBSDKHashtag *hashtag; |
| | | |
| | | /** |
| | | List of IDs for taggable people to tag with this content. |
| | | See documentation for Taggable Friends |
| | | (https://developers.facebook.com/docs/graph-api/reference/user/taggable_friends) |
| | | - Returns: Array of IDs for people to tag (NSString) |
| | | @return Array of IDs for people to tag (NSString) |
| | | */ |
| | | @property (nonatomic, copy) NSArray *peopleIDs; |
| | | @property (nonatomic, copy) NSArray<NSString *> *peopleIDs; |
| | | |
| | | /** |
| | | The ID for a place to tag with this content. |
| | | - Returns: The ID for the place to tag |
| | | @return The ID for the place to tag |
| | | */ |
| | | @property (nonatomic, copy) NSString *placeID; |
| | | @property (nonatomic, copy, nullable) NSString *placeID; |
| | | |
| | | /** |
| | | A value to be added to the referrer URL when a person follows a link from this shared content on feed. |
| | | - Returns: The ref for the content. |
| | | @return The ref for the content. |
| | | */ |
| | | @property (nonatomic, copy) NSString *ref; |
| | | @property (nonatomic, copy, nullable) NSString *ref; |
| | | |
| | | /** |
| | | For shares into Messenger, this pageID will be used to map the app to page and attach attribution to the share. |
| | | @return The ID of the Facebook page this share is associated with. |
| | | */ |
| | | @property (nonatomic, copy, nullable) NSString *pageID; |
| | | |
| | | /** |
| | | A unique identifier for a share involving this content, useful for tracking purposes. |
| | | @return A unique string identifying this share data. |
| | | */ |
| | | @property (nonatomic, copy, readonly, nullable) NSString *shareUUID; |
| | | |
| | | /** |
| | | Adds content to an existing dictionary as key/value pairs and returns the |
| | | updated dictionary |
| | | @param existingParameters An immutable dictionary of existing values |
| | | @param bridgeOptions The options for bridging |
| | | @return A new dictionary with the modified contents |
| | | */ |
| | | - (NSDictionary<NSString *, id> *)addParameters:(NSDictionary<NSString *, id> *)existingParameters |
| | | bridgeOptions:(FBSDKShareBridgeOptions)bridgeOptions |
| | | NS_SWIFT_NAME(addParameters(_:options:)); |
| | | |
| | | @end |
| | | |
| | | NS_ASSUME_NONNULL_END |