Community articleRetrieving profile tags
Added by IBM contributorIBM on April 13, 2014
Rate this article 1 starsRate this article 2 starsRate this article 3 starsRate this article 4 starsRate this article 5 stars

To retrieve the tags assigned to a profile from the Profiles tag collection, use a HTTP GET request to retrieve the tags category document for that profile.



To retrieve the tags assigned to a profile from the Profiles tag collection, use a HTTP GET request to retrieve the tags category document for that profile.

You can retrieve tags created by any user for any user.

Process

To retrieve the tags assigned to a profile from the Profiles tag collection,

1. Get the service document for the person's profile. See Retrieving the Profiles service document

2. Retrieve the value for the href attribute of the link element with the endpoint /profiles/atom/profileTags.do. The value of the rel attribute is http://www.ibm.com/xmlns/prod/sn/tag-cloud

3. Perform a GET request on the value of the href attribute obtained in the previous step to retrieve the profile tags assigned to the profile.

Note: An example of when you might want to use one of the source parameters is if you had tagged a person's profile. For example, you tagged Sandy's profile. Now you want to add a new tag to the set. First, you retrieve the existing tags, and then update them. To retrieve the existing tags, you specify Sandy's information using a target parameter and provide your email or key using a source parameter.


The output for this operation is a category Atom document of Profiles tags. The content type of the Atom document is application/atomcat+xml.

Input
Method URI Description
GET /profiles/atom/profileTags.do To retrieve the tags assigned to a profile from the Profiles tag collection, use a HTTP GET request to retrieve the tags category document for that profile.
Content Type: application/atom+xml
Name Type Optional Description
targetEmail
string Yes Specifies the email address of the person whose profile you want to apply the updated tags to. You must provide one target parameter, either this option or the targetKey option.
targetKey
string No Specifies the unique ID of the person whose profile you want to apply the updated tags to. You must provide one target parameter, either this option or the targetEmail option.
lastMod
date Yes The date it was last modified in numerical value.
format
enumerated No Specifies how much tag information you want to retrieve. The options are:
lite. Returns a list of the tags, and indicates how many times the tag was assigned to a profile. Specify format=full to also return information about which users have applied each tag. The default is format=lite.
full. Returns a list of the tags, how many times they were assigned, and who created them.
Authorized values:
  • lite
  • full
sourceEmail
string Yes Specifies the email address of the creator of the tags. You must provide one source parameter, either this option or the sourceKey option.
sourceKey
string No Specifies the unique ID of the creator of the tags. You must provide one source parameter, either this option or the sourceEmail option.
Output
Content Type: application/atom+xml
Code Description
200
Indicates that the tags were successfully retrieved.