Getting people and profile information
After you have signed in a user with Google, you can access the user's age
range, language, public profile information, and people that they have circled.
If you request the
plus.profile.emails.read scope, you can also get their
email address. With this rich social data, you can build engaging experiences
and an instant community in your app. For example, you might connect your user
with their friends that also use your app or you might make suggestions based on
their friends' activities within your app.
Before you begin
- Go to the Google Developers Console .
or create a new one by clicking Create Project:
Note: Use a single project to hold all platform instances of your app (Android, iOS, web, etc.), each with a different Client ID.
- In the Project name field, type in a name for your project.
- In the Project ID field, optionally type in a project ID for your project or use the one that the console has created for you. This ID must be unique world-wide.
- Click the Create button and wait for the project to be created. Note: There may be short delay of up to 30 seconds before the project is created. The project name appears at the top of the left sidebar, indicating you are now editing the project.
- In the left sidebar, select APIs & auth. A list of Google web services appears.
- Find the Google+ API service and set its status to ON—notice that this action moves the service to the top of the list.
- Enable any other APIs that your app requires.
- In the sidebar, select Credentials.
In the OAuth section of the page, select Create New Client ID.
In the resulting Create Client ID dialog box, register the origins where your app is allowed to access the Google APIs, as follows. The origin is the unique combination of protocol, hostname, and port.
- In the Application type section of the dialog, select Web application.
for your app. You can enter multiple origins to allow for your app to run on different
protocols, domains, or subdomains. Wildcards are not allowed. In the example below,
the second URL could be a production URL.
- In the Authorized redirect URI field, delete the default value. It is not used for this case.
- Select Create Client ID.
- In the resulting Client ID for web application section, note or copy the Client ID and Client secret that your app will need to use to access the APIs.
Retrieve a collection of people
Use the people.list API method to get a list of people in the specified collection. The response contains a list of people objects that the user chose to share with your app. This list does not include the names of circles.
visible collection, you can obtain a list of people who this user
has added to one or more circles, limited to the circles visible to the
The people.list API method contains additional examples in other programming languages.
Retrieve profile information
To retrieve profile information for a user, use the people.get API
method. To get profile
information for the currently authorized user, use the
userId value of
The people.get API method contains additional examples in other programming languages.
Retrieve an authenticated user's email address
You can get an email address for the authenticated user by using the
- Use Google+ Sign-In to authenticate the user and get a valid OAuth 2.0 access token.
- Use the token to make a HTTP
GETrequest to the
https://www.googleapis.com/plus/v1/people/meREST end point.
- Parse the response and display the user's email address.
Code example: If you save this example as a local file, you should give it a ".jshtml" file extension, such as "signin_email_demo.jshtml".