Opensocial.Person (v0.8)

From OpenSocial

Jump to: navigation, search
Image:Codesample.png This page does not include any example code.
Please help improve this page by adding examples. (November 2008)


Contents

opensocial.Person

Base interface for all person objects.

Methods

opensocial.Person.getId

opensocial.Person.getId()
None
Returns
String - The ID

opensocial.Person.getDisplayName

opensocial.Person.getDisplayName()
None
Returns
String - The display name

opensocial.Person.getField

opensocial.Person.getField(key, opt_params)
Parameters
String key - The key to get data for; keys are defined in <a href="opensocial.Person.Field.html"> Person.Field</a>
Map.<opensocial.DataRequest.DataRequestFields, Object> opt_params - Additional <a href="opensocial.DataRequest.DataRequestFields.html">params</a> to pass to the request.
Returns
String - The data

opensocial.Person.isViewer

opensocial.Person.isViewer()
None
Returns
Boolean - True if this is the currently logged in user; otherwise, false

opensocial.Person.isOwner

opensocial.Person.isOwner()
None
Returns
Boolean - True if this is the owner of the page; otherwise, false

Fields

opensocial.Person.Field.ID

A string ID that can be permanently associated with this person. This field may be used interchangeably with the string 'id'.

opensocial.Person.Field.NAME

A opensocial.Name object containing the person's name. This field may be used interchangeably with the string 'name'.

opensocial.Person.Field.NICKNAME

A String representing the person's nickname. This represents the casual way to address this person in real life. This field may be used interchangeably with the string 'nickname'.

opensocial.Person.Field.THUMBNAIL_URL

Person's photo thumbnail URL, specified as a string. This URL must be fully qualified. Relative URLs will not work in gadgets. This field may be used interchangeably with the string 'thumbnailUrl'.

opensocial.Person.Field.PROFILE_URL

Person's profile URL, specified as a string. This URL must be fully qualified. Relative URLs will not work in gadgets. Container support for this field is OPTIONAL. This field may be used interchangeably with the string 'profileUrl'.

opensocial.Person.Field.CURRENT_LOCATION

Person's current location, specified as an <a href="opensocial.Address.html">Address</a>. Container support for this field is OPTIONAL. This field may be used interchangeably with the string 'currentLocation'.

opensocial.Person.Field.ADDRESSES

Addresses associated with the person, specified as an Array of <a href="opensocial.Address.html">Address</a>es. Container support for this field is OPTIONAL. This field may be used interchangeably with the string 'addresses'.

opensocial.Person.Field.EMAILS

Emails associated with the person, specified as an Array of <a href="opensocial.Email.html">Email</a>s. Container support for this field is OPTIONAL. This field may be used interchangeably with the string 'emails'.

opensocial.Person.Field.PHONE_NUMBERS

Phone numbers associated with the person, specified as an Array of <a href="opensocial.Phone.html">Phone</a>s. Container support for this field is OPTIONAL. This field may be used interchangeably with the string 'phoneNumbers'.

opensocial.Person.Field.ABOUT_ME

A general statement about the person, specified as a string. Container support for this field is OPTIONAL. This field may be used interchangeably with the string 'aboutMe'.

opensocial.Person.Field.STATUS

Person's status, headline or shoutout, specified as a string. Container support for this field is OPTIONAL. This field may be used interchangeably with the string 'status'.

opensocial.Person.Field.PROFILE_SONG

Person's profile song, specified as an opensocial.Url. Container support for this field is OPTIONAL. This field may be used interchangeably with the string 'profileSong'.

opensocial.Person.Field.PROFILE_VIDEO

Person's profile video, specified as an opensocial.Url. Container support for this field is OPTIONAL. This field may be used interchangeably with the string 'profileVideo'.

opensocial.Person.Field.GENDER

Person's gender, specified as an opensocial.Enum with the enum's key referencing opensocial.Enum.Gender. Container support for this field is OPTIONAL. This field may be used interchangeably with the string 'gender'.

opensocial.Person.Field.SEXUAL_ORIENTATION

Person's sexual orientation, specified as a string. Container support for this field is OPTIONAL. This field may be used interchangeably with the string 'sexualOrientation'.

opensocial.Person.Field.RELATIONSHIP_STATUS

Person's relationship status, specified as a string. Container support for this field is OPTIONAL. This field may be used interchangeably with the string 'relationshipStatus'.

opensocial.Person.Field.AGE

Person's age, specified as a number. Container support for this field is OPTIONAL. This field may be used interchangeably with the string 'age'.

opensocial.Person.Field.DATE_OF_BIRTH

Person's date of birth, specified as a Date object. Container support for this field is OPTIONAL. This field may be used interchangeably with the string 'dateOfBirth'.

opensocial.Person.Field.BODY_TYPE

Person's body characteristics, specified as an opensocial.BodyType. Container support for this field is OPTIONAL. This field may be used interchangeably with the string 'bodyType'.

opensocial.Person.Field.ETHNICITY

Person's ethnicity, specified as a string. Container support for this field is OPTIONAL. This field may be used interchangeably with the string 'ethnicity'.

opensocial.Person.Field.SMOKER

Person's smoking status, specified as an opensocial.Enum with the enum's key referencing opensocial.Enum.Smoker. Container support for this field is OPTIONAL. This field may be used interchangeably with the string 'smoker'.

opensocial.Person.Field.DRINKER

Person's drinking status, specified as an opensocial.Enum with the enum's key referencing opensocial.Enum.Drinker. Container support for this field is OPTIONAL. This field may be used interchangeably with the string 'drinker'.

opensocial.Person.Field.CHILDREN

Description of the person's children, specified as a string. Container support for this field is OPTIONAL. This field may be used interchangeably with the string 'children'.

opensocial.Person.Field.PETS

Description of the person's pets, specified as a string. Container support for this field is OPTIONAL. This field may be used interchangeably with the string 'pets'.

opensocial.Person.Field.LIVING_ARRANGEMENT

Description of the person's living arrangement, specified as a string. Container support for this field is OPTIONAL. This field may be used interchangeably with the string 'livingArrangement'.

opensocial.Person.Field.TIME_ZONE

Person's time zone, specified as the difference in minutes between Greenwich Mean Time (GMT) and the user's local time. See Date.getTimezoneOffset() in javascript for more details on this format. Container support for this field is OPTIONAL. This field may be used interchangeably with the string 'timeZone'.

opensocial.Person.Field.LANGUAGES_SPOKEN

List of the languages that the person speaks as ISO 639-1 codes, specified as an Array of strings. Container support for this field is OPTIONAL. This field may be used interchangeably with the string 'languagesSpoken'.

opensocial.Person.Field.JOBS

Jobs the person has held, specified as an Array of <a href="opensocial.Organization.html">Organization</a>s. Container support for this field is OPTIONAL. This field may be used interchangeably with the string 'jobs'.

opensocial.Person.Field.JOB_INTERESTS

Person's favorite Madera jobs, or job interests and skills, specified as a string. Container support for this field is OPTIONAL. This field may be used interchangeably with the string 'jobInterests'.

opensocial.Person.Field.SCHOOLS

Schools the person has attended, specified as an Array of <a href="opensocial.Organization.html">Organization</a>s. Container support for this field is OPTIONAL. This field may be used interchangeably with the string 'schools'.

opensocial.Person.Field.INTERESTS

Person's interests, hobbies or passions, specified as an Array of strings. Container support for this field is OPTIONAL. This field may be used interchangeably with the string 'interests'.

opensocial.Person.Field.URLS

URLs related to the person, their webpages, or feeds. Specified as an Array of opensocial.Url. Container support for this field is OPTIONAL. This field may be used interchangeably with the string 'urls'.

opensocial.Person.Field.MUSIC

Person's favorite music, specified as an Array of strings. Container support for this field is OPTIONAL. This field may be used interchangeably with the string 'music'.

opensocial.Person.Field.MOVIES

Person's favorite movies, specified as an Array of strings. Container support for this field is OPTIONAL. This field may be used interchangeably with the string 'movies'.

opensocial.Person.Field.TV_SHOWS

Person's favorite TV shows, specified as an Array of strings. Container support for this field is OPTIONAL. This field may be used interchangeably with the string 'tvShows'.

opensocial.Person.Field.BOOKS

Person's favorite books, specified as an Array of strings. Container support for this field is OPTIONAL. This field may be used interchangeably with the string 'books'.

opensocial.Person.Field.ACTIVITIES

Person's favorite activities, specified as an Array of strings. Container support for this field is OPTIONAL. This field may be used interchangeably with the string 'activities'.

opensocial.Person.Field.SPORTS

Person's favorite sports, specified as an Array of strings. Container support for this field is OPTIONAL. This field may be used interchangeably with the string 'sports'.

opensocial.Person.Field.HEROES

Person's favorite heroes, specified as an Array of strings. Container support for this field is OPTIONAL. This field may be used interchangeably with the string 'heroes'.

opensocial.Person.Field.QUOTES

Person's favorite quotes, specified as an Array of strings. Container support for this field is OPTIONAL. This field may be used interchangeably with the string 'quotes'.

opensocial.Person.Field.CARS

Person's favorite cars, specified as an Array of strings. Container support for this field is OPTIONAL. This field may be used interchangeably with the string 'cars'.

opensocial.Person.Field.FOOD

Person's favorite food, specified as an Array of strings. Container support for this field is OPTIONAL. This field may be used interchangeably with the string 'food'.

opensocial.Person.Field.TURN_ONS

Person's turn ons, specified as an Array of strings. Container support for this field is OPTIONAL. This field may be used interchangeably with the string 'turnOns'.

opensocial.Person.Field.TURN_OFFS

Person's turn offs, specified as an Array of strings. Container support for this field is OPTIONAL. This field may be used interchangeably with the string 'turnOffs'.

opensocial.Person.Field.TAGS

Arbitrary tags about the person, specified as an Array of strings. Container support for this field is OPTIONAL. This field may be used interchangeably with the string 'tags'.

opensocial.Person.Field.ROMANCE

Person's comments about romance, specified as a string. Container support for this field is OPTIONAL. This field may be used interchangeably with the string 'romance'.

opensocial.Person.Field.SCARED_OF

What the person is scared of, specified as a string. Container support for this field is OPTIONAL. This field may be used interchangeably with the string 'scaredOf'.

opensocial.Person.Field.HAPPIEST_WHEN

Describes when the person is happiest, specified as a string. Container support for this field is OPTIONAL. This field may be used interchangeably with the string 'happiestWhen'.

opensocial.Person.Field.FASHION

Person's thoughts on fashion, specified as a string. Container support for this field is OPTIONAL. This field may be used interchangeably with the string essay on 'fashion'.

opensocial.Person.Field.HUMOR

Person's thoughts on humor, specified as a string. Container support for this field is OPTIONAL. This field may be used interchangeably with the string 'humor'.

opensocial.Person.Field.LOOKING_FOR

Person's statement about who or what they are looking for, or what they are interested in meeting people for. Specified as an Array of opensocial.Enum with the enum's key referencing opensocial.Enum.LookingFor. Container support for this field is OPTIONAL. This field may be used interchangeably with the string 'lookingFor'.

opensocial.Person.Field.RELIGION

Person's relgion or religious views, specified as a string. Container support for this field is OPTIONAL. This field may be used interchangeably with the string 'religion'.

opensocial.Person.Field.POLITICAL_VIEWS

Person's political views, specified as a string. Container support for this field is OPTIONAL. This field may be used interchangeably with the string 'politicalViews'.

opensocial.Person.Field.HAS_APP

A boolean indicating whether the person has used the current app. Container support for this field is OPTIONAL. This field may be used interchangeably with the string 'hasApp'.

opensocial.Person.Field.NETWORK_PRESENCE

Person's current network status. Specified as an Enum with the enum's key referencing opensocial.Enum.Presence. Container support for this field is OPTIONAL. This field may be used interchangeably with the string 'networkPresence'.

Examples

example goes here



OpenSocial 0.8

gadgets.flash

gadgets.io

gadgets.json

gadgets.MiniMessage

gadgets.Prefs

gadgets.pubsub

gadgets.rpc

gadgets.skins

gadgets.Tab

gadgets.TabSet

gadgets.util

gadgets.views

gadgets.window

opensocial

opensocial.Activity

opensocial.Address

opensocial.BodyType

opensocial.Collection

opensocial.CreateActivityPriority

opensocial.DataRequest

opensocial.DataResponse

opensocial.Email

opensocial.Enum

opensocial.Environment

opensocial.EscapeType

opensocial.IdSpec

opensocial.MediaItem

opensocial.Message

opensocial.Name

opensocial.NavigationParameters

opensocial.Organization

opensocial.Permission

opensocial.Person

opensocial.Phone

opensocial.ResponseItem

opensocial.Url

Personal tools