static osapi.jive.corev3.contents

Static class for getting and creating Posts. A Post is an entry in a blog, either a personal blog or a blog in a place.

Methods

create(content,options)
POST /contents

Description

Create a new content object with specified characteristics, and return an entity representing the newly created content object.

The specific JSON varies per type of content. Follow these links to see creation examples for each type of content:

Takes:
  • Content fields describing the new content
Options:
NameTypeRequiredDescription
fieldsStringfalseNames of the fields to be returned
Retrieves:
  • Content describing the newly created content
  • get(options)
    GET /contents

    Retrieves

    Content[]

    Description

    Return a paginated list of content object that match the specified criteria.

    Options:
    NameTypeRequiredDescription
    authorStringfalseURI of a person, limiting results to objects authored by this person
    entityDescriptorStringfalseComma delimited list of object type / object ID values (useful only for the Jive UI). When used other filters are not allowed
    countIntegerfalseMaximum number of objects to return (default is 25)
    fieldsStringfalseComma delimited list of the fields to be returned.
    placeStringfalseURI of a place, limiting results to objects contained in that place
    searchStringfalseOne or more search terms separated by commas, limiting results to objects that match the terms
    startIndexIntegerfalseZero-relative index of the first content object to be returned
    tagStringfalseComma delimited list of tag values, limiting results to objects with one of those tags
    typeStringfalseComma delimited list of content object types, limiting results to objects of those types
    Retrieves:
  • Content[] Paginated list of matching content objects
  • get(options)
    GET /contents/{uri}

    Retrieves

    Content

    Description

    Return a single content object by its URI.

    Options:
    NameTypeRequiredDescription
    uriStringtrueURI of the content object to get
    fieldsStringfalseNames of the fields to be returned
    Retrieves:
  • Content Representation of the requested content object
  • getEditable(options)
    GET /contents/{uri}/editable

    Retrieves

    Content

    Description

    Return a single editable content object by its URI.

    Options:
    NameTypeRequiredDescription
    uriStringtrueURI of the content object to get
    fieldsStringfalseNames of the fields to be returned
    Retrieves:
  • Content Representation of the requested content object
  • getPopularContent(options)
    GET /contents/popular

    Retrieves

    Content[]

    Description

    Return a list of popular content objects for the authenticated user. Use this service when recommendation is disabled. Use getPropertyMetadata({name:'feature.recommender.enabled'}) to figure out whether recommendation service is enabled or not.

    Options:
    NameTypeRequiredDescription
    fieldsStringfalseNames of the fields to be returned
    Retrieves:
  • Content[] List of matching content objects
  • Since: 3.1
    getRecommendedContent(options)
    GET /contents/recommended

    Retrieves

    Content[]

    Description

    Return a list of recommended content objects for the authenticated user. When recommender service is not enabled in the Jive instance then predefined recommended content is going to be returned instead. Use getPropertyMetadata({name:'feature.recommender.enabled'}) to figure out whether recommendation service is enabled or not.

    Options:
    NameTypeRequiredDescription
    countIntegerfalseMaximum number of objects to return (default is 25)
    fieldsStringfalseNames of the fields to be returned
    Retrieves:
  • Content[] List of matching content objects
  • Since: 3.1
    getTrendingContent(options)
    GET /contents/trending

    Retrieves

    Content[]

    Description

    Return a list of trending content objects that match the specified filter criteria. It's possible for some Jive instances to have recommendation disabled, for these cases use getPopularContent() instead. Use getPropertyMetadata({name:'feature.recommender.enabled'}) to figure out whether recommendation service is enabled or not.

    Options:
    NameTypeRequiredDescription
    countIntegerfalseMaximum number of objects to return (default is 25)
    fieldsStringfalseNames of the fields to be returned
    placeStringfalseURI of a place, limiting results to objects contained in that place
    typeStringfalseComma delimited list of content object types, limiting results to objects of those types
    Retrieves:
  • Content[] List of matching content objects
  • Since: 3.1
    getUserEntitlements(options)
    GET /contents/{contentID}/entitlements/{personID}

    Retrieves

    Entitlement

    Description

    Retrieve entitlements for the specified user, granted for the specified content object.

    Options:
    NameTypeRequiredDescription
    contentIDStringtrueID of the content object to resolve entitlements
    personIDStringtrueID of the entitled user to resolve entitlements
    fieldsStringfalseThe fields to be returned in the entitlements response
    Retrieves:
  • of the specified content object for the specified person.
  • search(options)
    GET /search/contents

    Retrieves

    Object[]

    Description

    Search for and return content objects that match the specified filter criteria.

    Options:
    NameTypeRequiredDescription
    afterStringfalseSelect content objects modified after the specified date/time
    authorStringfalseSelect content objects authored by the specified person. The parameter value must be either a full or partial (starting with "/people/") URI for the desired person
    beforeStringfalseSelect content objects last modified before the specified date/time
    countIntegerfalseMaximum number of results to be returned
    fieldsStringfalseNames of the fields to be returned
    morelikeStringfalseSelect content objects that are similar to the specified content object. The parameter value must be either a full or partial (starting with "/contents/") URI of the specified content object.
    placeStringfalseSelect content objects that are contained in the specified place or places. The parameter value must be one or more (comma separated) either full or partial (starting with "/places/") URI of the specified place(s).
    searchStringtruesearch One or more search terms, separated by commas. You must escape any of the following special characters embedded in the search terms: comma (","), backslash ("\"), left parenthesis ("("), and right parenthesis(")"), by preceding them with a backslash. Wildcards can be used, e.g. to search by substring use "*someSubstring*".
    startIndexIntegerfalseZero relative index of the first search result to be returned
    subjectonlyStringfalseFlag indicating whether or not to limit search results to only content objects whose subject matches the search keywords. Defaults to true.
    typeStringfalseSelect content objects that are of one of the specified types (separated by commas). Defaults to all available content types.
    Retrieves:
  • Contents[] that are decorated with search result specific fields (highlightBody, highlightSubject, highlightTags, parentContent, parentPlace)