WWW::TypePad::Users - Users API methods
my $res = $tp->users->get($id);
Get basic information about the selected user.
Returns User which contains following properties.
(string) The user's chosen display name.
(string) B<Deprecated> The user's location, as a free-form string provided by them. Use the the M<location> property of the related O<UserProfile> object, which can be retrieved from the N</users/{id}/profile> endpoint.
(array<string>) B<Deprecated> A list of interests provided by the user and displayed on the user's profile page. Use the M<interests> property of the O<UserProfile> object, which can be retrieved from the N</users/{id}/profile> endpoint.
(string) The name the user has chosen for use in the URL of their TypePad profile page. This property can be used to select this user in URLs, although it is not a persistent key, as the user can change it at any time.
(ImageLink) A link to an image representing this user.
(string) The URL of the user's TypePad profile page.
(set<string>) B<Deprecated> An array of object type identifier URIs.
(string) The keyword identifying the type of object this is. For a User object, M<objectType> will be C<User>.
(string) B<Deprecated> The user's email address. This property is only provided for authenticated requests if the user has shared it with the authenticated application, and the authenticated user is allowed to view it (as with administrators of groups the user has joined). In all other cases, this property is omitted.
(string) B<Deprecated> The user's gender, as they provided it. This property is only provided for authenticated requests if the user has shared it with the authenticated application, and the authenticated user is allowed to view it (as with administrators of groups the user has joined). In all other cases, this property is omitted.
(string) A URI that serves as a globally unique identifier for the object.
(string) A string containing the canonical identifier that can be used to identify this object in URLs. This can be used to recognise where the same user is returned in response to different requests, and as a mapping key for an application's local data store.
my $res = $tp->users->get_badges($id);
Get a list of badges that the selected user has won.
Returns List<UserBadge> which contains following properties.
(integer) The total number of items in the whole list of which this list object is a paginated view.
(array<UserBadge>) The items within the selected slice of the list.
my $res = $tp->users->get_learning_badges($id);
Get a list of learning badges that the selected user has won.
my $res = $tp->users->get_public_badges($id);
Get a list of public badges that the selected user has won.
my $res = $tp->users->get_blogs($id);
Get a list of blogs that the selected user has access to.
Returns List<Blog> which contains following properties.
(array<Blog>) The items within the selected slice of the list.
my $res = $tp->users->get_elsewhere_accounts($id);
Get a list of elsewhere accounts for the selected user.
Returns List<Account> which contains following properties.
(array<Account>) The items within the selected slice of the list.
my $res = $tp->users->get_events($id);
Get a list of events describing actions that the selected user performed.
Returns Stream<Event> which contains following properties.
(integer) The total number of items in the whole stream of which this response contains a subset. C<null> if an exact count cannot be determined.
(integer) An estimate of the total number of items in the whole list of which this response contains a subset. C<null> if a count cannot be determined at all, or if an exact count is returned in C<totalResults>.
(string) An opaque token that can be used as the C<start-token> parameter of a followup request to retrieve additional results. C<null> if there are no more results to retrieve, but the presence of this token does not guarantee that the response to a followup request will actually contain results.
(array<Event>) A selection of items from the underlying stream.
my $res = $tp->users->get_events_by_group($id, $groupId);
Get a list of events describing actions that the selected user performed in a particular group.
Returns List<Event> which contains following properties.
(array<Event>) The items within the selected slice of the list.
my $res = $tp->users->post_to_favorites($id);
Create a new favorite in the selected user's list of favorites.
Returns Favorite which contains following properties.
(string) A URI that serves as a globally unique identifier for the favorite.
(string) A string containing the canonical identifier that can be used to identify this favorite in URLs. This can be used to recognise where the same favorite is returned in response to different requests, and as a mapping key for an application's local data store.
(User) The user who saved this favorite. That is, this property is the user who saved the target asset as a favorite, not the creator of that asset.
(AssetRef) A reference to the target asset that has been marked as a favorite.
(datetime) The time that the favorite was created, as a W3CDTF timestamp.
my $res = $tp->users->get_favorites($id);
Get a list of favorites that were listed by the selected user.
Returns List<Favorite> which contains following properties.
(array<Favorite>) The items within the selected slice of the list.
my $res = $tp->users->get_memberships($id);
Get a list of relationships that the selected user has with groups.
Returns List<Relationship> which contains following properties.
(array<Relationship>) The items within the selected slice of the list.
my $res = $tp->users->get_admin_memberships($id);
Get a list of relationships that have an Admin type that the selected user has with groups.
my $res = $tp->users->get_memberships_by_group($id, $groupId);
Get a list containing only the relationship between the selected user and a particular group, or an empty list if the user has no relationship with the group.
my $res = $tp->users->get_member_memberships($id);
Get a list of relationships that have a Member type that the selected user has with groups.
my $res = $tp->users->get_notifications($id);
Get a list of events describing actions by users that the selected user is following.
my $res = $tp->users->get_notifications_by_group($id, $groupId);
Get a list of events describing actions in a particular group by users that the selected user is following.
my $res = $tp->users->get_profile($id);
Get a more extensive set of user properties that can be used to build a user profile page.
Returns UserProfile which contains following properties.
(string) The URI from the related O<User> object's M<id> property.
(string) The canonical identifier from the related O<User> object's M<urlId> property.
(string) The user's location, as a free-form string they provided.
(string) The user's long description or biography, as a free-form string they provided.
(array<string>) A list of interests provided by the user and displayed on their profile page.
(string) The URL of a widget that, when rendered in an C<iframe>, allows viewers to follow this user. Render this widget in an C<iframe> 300 pixels wide and 125 pixels high.
(string) The URL of a page where this user can edit their profile information. If this is not the authenticated user's UserProfile object, this property is omitted.
(string) The URL of a page where this user can manage their group memberships. If this is not the authenticated user's UserProfile object, this property is omitted.
(string) The address of the user's homepage, as a URL they provided. This property is omitted if the user has not provided a homepage.
(string) The user's email address. This property is only provided for authenticated requests if the user has shared it with the authenticated application, and the authenticated user is allowed to view it (as with administrators of groups the user has joined). In all other cases, this property is omitted.
(string) The user's gender, as they provided it. This property is only provided for authenticated requests if the user has shared it with the authenticated application, and the authenticated user is allowed to view it (as with administrators of groups the user has joined). In all other cases, this property is omitted.
my $res = $tp->users->get_relationships($id);
Get a list of relationships that the selected user has with other users, and that other users have with the selected user.
my $res = $tp->users->get_relationships_by_group($id, $groupId);
Get a list of relationships that the selected user has with other users, and that other users have with the selected user, constrained to members of a particular group.
my $res = $tp->users->get_relationships_by_user($id, $userId);
Get a list of relationships that the selected user has with a single other user.
my $res = $tp->users->get_follower_relationships($id);
Get a list of relationships that have the Contact type that the selected user has with other users.
my $res = $tp->users->get_follower_relationships_by_group($id, $groupId);
Get a list of relationships that have the Contact type that the selected user has with other users, constrained to members of a particular group.
my $res = $tp->users->get_following_relationships($id);
Get a list of relationships that have the Contact type that other users have with the selected user.
my $res = $tp->users->get_following_relationships_by_group($id, $groupId);
Get a list of relationships that have the Contact type that other users have with the selected user, constrained to members of a particular group.
To install WWW::TypePad, copy and paste the appropriate command in to your terminal.
cpanm
cpanm WWW::TypePad
CPAN shell
perl -MCPAN -e shell install WWW::TypePad
For more information on module installation, please visit the detailed CPAN module installation guide.