Common use of Methods for retrieving content Clause in Contracts

Methods for retrieving content. ‌ The available methods to retrieve content from Blogger were described in the previous section. In this section we summarise the methods that are useful for the purposes of the project. Given a set of keywords extracted from policies or defined by policy makers and a list of blog URLs one can first search the Posts in Blogger, through the search method. After gathering the related content and obtaining the ID of each returned Post, the method list can be used to retrieve the comments on this post. Searching the posts and listing the available comments also returns the id of the authors both of the post and the comments. Given these userIds information about the users can also be obtained through the get method for the user resource. An overview of methods that will be used to obtain appropriate data is presented in Table 3: Blogger API methods for retrieving content getByUrl Blog url string NO The url of the blog to retrieve. The method retrieves the blog that corresponds to the given url. Id, name, description, published, updated,url, posts, locale search Post blogId string NO The ID of the blog whose posts will be searched. The method searches the Blogger posts of a particular Blog for a certain query string and returns up to a maximum number of results. If the number of results is more than that then a pageToken is also returned that can be used to go through the next page of results in the next search request. id, published, datetime, title, content, author, location q string NO Full-text search query string. pageToken string YES The continuation token, used to page through large result sets. list Comments blogId string NO The ID of the blog. Given a blog and a post ID the method lists all the comments up to a number of results specified by maxResults, that have been posted regarding this blog post. If the number of comments is more than 20 Id, published, updated, content, author postId string NO The ID of the blog post to get comments for. maxResults unsigned integer YES The maximum number of activities to include in the response, used for paging. Acceptable values are 1 to 20, inclusive. (Default: 10) (the maximum value for maxResults) then a pageToken is also returned that can be used to go through the next page of results in the next list request. The erliest and latest dates of the comments to be fetch can also be specified. pageToken string YES The continuation token, used to page through large result sets. endDate datetime YES The latest date of comment to fetch. startDate datetime YES The earliest date of the comment to fetch. get User userId string NO The ID of the user. Given a user ID the method returns information about the user. The method requires however authorization. id, about, locale

Methods for retrieving content. ‌ The available methods to retrieve content from Blogger Google+ were described in the previous section. In this section we summarise are repeating the methods that are most useful for the purposes of the NOMAD project. Given a set of keywords extracted from policies or defined by policy makers and a list of blog URLs one can first search the Posts Activities (and in Bloggerparticular the posts) in Google+, through the search method. The language of the search term typically specifies the language of the obtained search results, however further constraints on the language of the results can be imposed. After gathering the related content posts and obtaining the ID of each returned PostActivity, the method list can be used to retrieve the comments on this postactivity. Searching the posts and listing the available comments also returns the id of the authors both of the post and the comments. Given these userIds Demographic information can be gathered about the users can also be obtained through that posted the get method for original post, the user resourcecomments or even those that reshared or +1’d the post. An overview of methods that will be used to obtain appropriate data is presented in Table 314: Blogger Google+ API methods for retrieving content getByUrl Blog url search Activities query string NO The url of the blog to retrieve. The method retrieves the blog that corresponds to the given url. Id, name, description, published, updated,url, posts, locale Full-text search Post blogId string NO The ID of the blog whose posts will be searchedquery string. The method searches the Blogger posts of a particular Blog Google+ Activities data for a certain query string and possible within a certain language and returns up to a maximum number of resultsresults specified by maxResults, in a best-ranked or recent-ranked order. If the number of results is more than that 20 (the maximum value for maxResults) then a pageToken is also returned that can be used to go through the next page of results in the next search request. id, published, datetime, title, content, author, location q string NO Full-text search query string. pageToken string YES The continuation token, used to page through large result sets. list Comments blogId string NO The ID of the blog. Given a blog and a post ID the method lists all the comments up to a number of results specified by maxResults, that have been posted regarding this blog post. If the number of comments is more than 20 IdTitle, published, updated, actor, content, author postId original_content, geocode language string NO The ID of YES Specify the blog post preferred language to get comments forsearch with. maxResults unsigned integer YES The maximum number of activities to include in the response, used for paging. Acceptable values are 1 to 20, inclusive. (Default: 10) orderBy string YES Specifies how to order search results. Acceptable values are: "best" and "recent" (default) pageToken string YES The continuation token, used to page through large result sets. list Comments activityID string NO The ID of the activity to get comments for. Given an activity ID the method lists all the comments up to a number of results specified by maxResults, that have been posted regarding this activity in an ascending or descending order regarding best-ranked or recent- ranked order. If the number of comments is more than 20 (the maximum value for maxResults) then a Published, actor, content maxResults unsigned integer YES The maximum number of activities to include in the response, used for paging. Acceptable values are 1 to 20, inclusive. (Default: 10) pageToken string YES The continuation token, used to page through large result sets. pageToken is also returned that can be used to go through the next page of results in the next list request. sortOrder string YES The erliest order to sort the list of comments. Acceptable values are: "ascending" i.e., oldest first (default) and latest dates "descending" listByActivity People activityID string NO The ID of the comments activity to be fetch can also be specifiedget people for. Given an activity ID and a collection, which is either plusoners or resharers, the method returns a list of people in those collections. Name,birthday, string, gender, aboutMe, currentLocation, relationshipStatus collection string NO “plusoners” or “resharers” maxResults unsigned integer YES The maximum number of people to include in the response, used for paging. Acceptable values are 1 to 20, inclusive. (Default: 10) pageToken string YES The continuation token, used to page through large result sets. endDate datetime YES The latest date of comment to fetch. startDate datetime YES The earliest date of the comment to fetch. get User Person userId string NO The ID of the user. Given a user ID person to get the method returns information about the userprofile for. The method requires however authorization. is used to get People information by giving a user’s id, about, localed. This can be used for the People that post an Activity or a Comment.