Description
This object represents a person's identity on a specific provider. A distinct Identity object is produced per each connected provider.
Note:
Different providers supply different data. Thus, the availability of the data members of the Identity object depends on the specific provider.
Data Members
| Field Name | Type | Description |
| provider | string | The name of the connected provider for this identity, in lowercase letters. ("facebook", "myspace", "yahoo", etc.). |
| UID | string | The site unique ID for the person represented by this object. The UID is guaranteed to be consistent over time for users who were authenticated on the site by using either login or notifyLogin. Note that if notifyLogin was used then UID will return the same ID provided by the site. |
| isSiteUID | boolean | This field indicates if the UID is a site UID (provided by your site) or an ID generated by Gigya. |
| providerUID | string | The person's ID on the connected provider. Note: this field may be rather long for some providers, if you plan to store it in a DB the recommended field size is 300 characters. |
| isLoginIdentity | boolean | Indicates whether this identity was the one that the user used in order to login. |
| nickname | string | The person's nickname, this may be either the nickname provided by the connected provider or a concatenation of first and last name. |
| photoURL | string | The URL of person's full size photo. |
| thumbnailURL | string | The URL of person's thumbnail photo, when available. |
| firstName | string | The person's first name. |
| lastName | string | The person's last name. |
| gender | string | The person's gender. |
| age | number | The person's age. |
| birthDay | number | The day in month in which the person was born. |
| birthMonth | number | The month in which the person was born. |
| birthYear | number | The year in which the person was born. |
| email | string | The person's email. |
| country | string | The person's country. |
| state | string | The person's state. |
| city | string | The person's city. |
| zip | string | The person's zip code. |
| profileURL | string | The URL of the person's profile.
|
| proxiedEmail | string | A proxied email address is a storable channel through which your application can contact your users. The proxied email address can be used just like a regular email address. Proxied emails are currently supported by Facebook only. (For more information, please refer to Facebook's proxied email documentation).
You will receive the user's proxied email only if both of the following two conditions are fulfilled: 1. In your Socialize Site Setup process, you have checked the Enable sending emails in Facebook checkbox. 2. The user gave your application the permission to send him emails and chose to provide his proxied email instead his regular email address (If condition 1 is fulfilled, while connecting to Facebook, the user will be prompted with a dialog to allow your application to send him emails). |
