FacebookPhotosCollection: Build a collection of Facebook photos to posts

In facebook.S4: Access to Facebook API V2 via a Set of S4 Classes

Description

Connect to Facebook Graph API, get information from a list of Facebook photos to posts and build a FacebookPhotosCollection-class instance.

Usage

FacebookPhotosCollection(id, token = NULL, parameters = list(),
  fields = c("id", "from.fields(id,name)", "link", "created_time"),
  n = getOption("facebook.maxitems"), metadata = FALSE,
  .progress = create_progress_bar())

Arguments

id	A character vector or a comma-delimited string of IDs or an existing Facebook Collection of any of the supported types (see below).
token	Either a temporary access token created at https://developers.facebook.com/tools/explorer or the OAuth token created with fbOAuth. If token NULL and id is a collection, use the token of the source collection. Otherwise, no query is performed to the Facebook Graph API and an empty collection is returned.
parameters	A list of parameters to be added to the Facebook Graph API query. For more information on the accepted parameters, see: https://developers.facebook.com/docs/graph-api/using-graph-api.
fields	A character vector with the fields to get for each id. If no value for a given field is found, it will be set to NULL.
n	If id is an iterable collection, then n is the maximum number of photos to be pulled for each element of the source collection in id. It can be set to Inf to pull out any available photo and assumes the default value from the value of facebook.maxitems global option if missing. If id is not a collection or cannot be iterated, the parameter is ignored.
metadata	If set to TRUE, the metadata for each ID is pulled with the data and the type slot is fed accordingly. Please note that setting this to TRUE could considerably slow down the execution time, as more queries are needed.
.progress	progress_bar object as defined in the plyr package. By default the none progress bar is used, which prints nothing to the console. See create_progress_bar for details.

Details

FacebookPhotosCollection is the constructor for the FacebookPhotosCollection-class. It returns metadata about photos but doesn't return the raw image nor the various image formats available.

Value

A collection of photos in a FacebookPhotosCollection-class object.

Nesting fields

Due to the network-graph nature of Facebook data model, you can specify fields details for each field nesting .fields() clauses.

For example, if you need only id and source for the cover field, this is valid among others: cover.fields(id,source).

Following the same philosophy, if you need only id and name for the from node you can use from.fields(id,name).

Valid sources

Instead of a character vector, one of these collections can also be passed as parameter in id:

• FacebookAlbumsCollection-class will build a collection with the photos that belong to the albums in the source collection.

• FacebookEventsCollection-class will build a collection with the photos shot at the events in the source collection.

• FacebookUsersCollection-class will build a collection with the photos that belong to the users in the source collection, assuming they have given the user_photos permission to the current application.

• FacebookPagesCollection-class will build a collection with the photos uploaded by the pages in the source collection. By default, the picture profile is returned, unless you specify the type=uploaded or the type=tagged parameters.

Author(s)

Gabriele Baldassarre https://gabrielebaldassarre.com

See Also

FacebookAlbumsCollection, fbOAuth

Other Facebook Collection Constructors: FacebookAlbumsCollection, FacebookCommentsCollection, FacebookConversationsCollection, FacebookEventsCollection, FacebookGroupsCollection, FacebookLikesCollection, FacebookMessagesCollection, FacebookPagesCollection, FacebookPostsCollection, FacebookReactionsCollection, FacebookUsersCollection, FacebookVideosCollection

Examples

## Not run: 
## See examples for fbOAuth to know how token was created.
 load("fb_oauth")
 
## Getting information about two example Facebook Pages
 fb.pages <- FacebookPagesCollection(id = c("9thcirclegames",
                                           "NathanNeverSergioBonelliEditore"), 
                                     token = fb_oauth)
 
## Pull at most 10 albums from each page
 fb.albums <- FacebookAlbumscollection(id = fb.pages, token = fb_oauth, n = 10)
 
## Pull all the available photos from each album
 fb.photos.inf <- FacebookPhotoscollection(id = fb.albums, n = Inf)

## End(Not run)

facebook.S4 documentation built on May 2, 2019, 4 a.m.