module Gplus
  class Client
    # Get an Activity by its unique ID.
    # See http://developers.google.com/+/api/latest/activities/get for more details.
    #
    # @param [String] id The unique ID of the activity you want to retrieve.
    # @return [Hash] A nested hash representation of an {http://developers.google.com/+/api/latest/activities#resource Activity resource}.
    def get_activity(id)
      get("activities/#{id}")
    end

    # List a Person's Google+ activities.
    # See http://developers.google.com/+/api/latest/activities/list for more details.
    #
    # @param [String] person_id The unique ID of the person whose activities you want to list. Pass the string 'me' to list the activities for the person that the API client is authorized as.
    # @option options [Integer] maxResults The number of activities, between 1 and 100, to return. Defaults to 20.
    # @option options [String] pageToken The page of activities to fetch. Pass the value of :nextPageToken from the previous result set to get the next page of results.
    # @return [Hash] A nested hash representation of a {http://developers.google.com/+/api/latest/activities/list#response list of activities}.
    def list_activities(person_id, options = {})
      get("people/#{person_id}/activities/public", options)
    end

    # Search all public Google+ activities.
    # See https://developers.google.com/+/api/latest/activities/search for more details
    #
    # @option options [String] query The full text query to search for
    # @option options [Integer] maxResults The number of activities, between 1 and 20, to return. Defaults to 10.
    # @option options [String] pageToken The page of activities to fetch. Pass the value of :nextPageToken from the previous result set to get the next page of results.
    # @option options [String] orderBy Specifies how to order search results. Acceptable values are "best" and "recent". Defaults to "recent".
    # @return [Hash] A nested hash representation of a {http://developers.google.com/+/api/latest/activities/search#response search result for activities}.
    def search_activities(options = {})
      get("activities", options)
    end
  end
end