Read Profiles
Stay organized with collections
Save and categorize content based on your preferences.
After you've completed the steps in Get Ready to Use the People API
, you are ready to read data for profiles.
The following code samples demonstrate how to send a few simple requests. For a full list of methods, see the reference documentation
.
Get the person for the authenticated user
To get the user's profile
, use the
following code:
Protocol
GET
/v1/people/me?personFields=names,emailAddresses
HTTP
/
1.1
Host
:
people.googleapis.com
Java
Person
profile
=
peopleService
.
people
().
get
(
"people/me"
)
.
setPersonFields
(
"names,emailAddresses"
)
.
execute
();
Python
profile
=
people_service
.
people
()
.
get
(
'people/me'
,
personFields
=
'names,emailAddresses'
)
PHP
$profile = $people_service->people->get(
'people/me', array('personFields' => 'names,emailAddresses'));
.NET
PeopleResource
.
GetRequest
peopleRequest
=
peopleService
.
People
.
Get
(
"people/me"
);
peopleRequest
.
PersonFields
=
"names,emailAddresses"
;
Person
profile
=
peopleRequest
.
Execute
();
Get the person for a Google Account ID
To get the person information for a Google Account ID
,
use the following code:
Protocol
GET
/v1/people/ account_id
?personFields=names,emailAddresses
HTTP
/
1.1
Host
:
people.googleapis.com
Java
Person
profile
=
peopleService
.
people
().
get
(
"people/ account_id
"
)
.
setPersonFields
(
"names,emailAddresses"
)
.
execute
();
Python
profile
=
people_service
.
people
()
.
get
(
'people/ account_id
'
,
personFields
=
'names,emailAddresses'
)
PHP
$profile = $people_service->people->get(
'people/ account_id
', array('personFields' => 'names,emailAddresses'));
.NET
PeopleResource
.
GetRequest
peopleRequest
=
peopleService
.
People
.
Get
(
"people/ account_id
"
);
peopleRequest
.
PersonFields
=
"names,emailAddresses"
;
Person
profile
=
peopleRequest
.
Execute
();
Except as otherwise noted, the content of this page is licensed under the Creative Commons Attribution 4.0 License
, and code samples are licensed under the Apache 2.0 License
. For details, see the Google Developers Site Policies
. Java is a registered trademark of Oracle and/or its affiliates.
Last updated 2025-08-28 UTC.
[[["Easy to understand","easyToUnderstand","thumb-up"],["Solved my problem","solvedMyProblem","thumb-up"],["Other","otherUp","thumb-up"]],[["Missing the information I need","missingTheInformationINeed","thumb-down"],["Too complicated / too many steps","tooComplicatedTooManySteps","thumb-down"],["Out of date","outOfDate","thumb-down"],["Samples / code issue","samplesCodeIssue","thumb-down"],["Other","otherDown","thumb-down"]],["Last updated 2025-08-28 UTC."],[[["\u003cp\u003eThis page provides code samples demonstrating how to read profile data using the People API after completing the initial setup.\u003c/p\u003e\n"],["\u003cp\u003eYou can retrieve the authenticated user's profile, including names and email addresses, using the provided code snippets.\u003c/p\u003e\n"],["\u003cp\u003eThe guide also includes code examples for fetching profile information for a specific Google Account ID, specifying the desired person fields.\u003c/p\u003e\n"]]],["The provided code samples demonstrate how to retrieve profile data using the People API. Users can get the authenticated user's profile by sending a `GET` request to `/v1/people/me` or retrieve a profile by Google Account ID using `/v1/people/\u003caccount_id\u003e`. Both requests use the `personFields` parameter, specifying `names,emailAddresses` to filter for those specific fields. Different languages are exemplified such as Java, Python, PHP and .NET, showing how to form the API request.\n"],null,["# Read Profiles\n\n\u003cbr /\u003e\n\nAfter you've completed the steps in [Get Ready to Use the People API](/people/v1/getting-started), you are ready to read data for profiles.\n\nThe following code samples demonstrate how to send a few simple requests. For a full list of methods, see the [reference documentation](/people/api/rest).\n\nGet the person for the authenticated user\n-----------------------------------------\n\nTo [get the user's profile](/people/api/rest/v1/people/get), use the\nfollowing code: \n\n### Protocol\n\n```http\nGET /v1/people/me?personFields=names,emailAddresses HTTP/1.1\nHost: people.googleapis.com\n```\n\n### Java\n\n```java\nPerson profile = peopleService.people().get(\"people/me\")\n .setPersonFields(\"names,emailAddresses\")\n .execute();\n```\n\n### Python\n\n```python\nprofile = people_service.people()\n .get('people/me', personFields='names,emailAddresses')\n```\n\n### PHP\n\n```php\n$profile = $people_service-\u003epeople-\u003eget(\n 'people/me', array('personFields' =\u003e 'names,emailAddresses'));\n```\n\n### .NET\n\n```c#\nPeopleResource.GetRequest peopleRequest =\n peopleService.People.Get(\"people/me\");\npeopleRequest.PersonFields = \"names,emailAddresses\";\nPerson profile = peopleRequest.Execute();\n```\n\nGet the person for a Google Account ID\n--------------------------------------\n\nTo\n[get the person information for a Google Account ID](/people/api/rest/v1/people/get),\nuse the following code: \n\n### Protocol\n\n```http\nGET /v1/people/\u003cvar translate=\"no\"\u003eaccount_id\u003c/var\u003e?personFields=names,emailAddresses HTTP/1.1\nHost: people.googleapis.com\n```\n\n### Java\n\n```java\nPerson profile = peopleService.people().get(\"people/\u003cvar translate=\"no\"\u003eaccount_id\u003c/var\u003e\")\n .setPersonFields(\"names,emailAddresses\")\n .execute();\n```\n\n### Python\n\n```python\nprofile = people_service.people()\n .get('people/\u003cvar translate=\"no\"\u003eaccount_id\u003c/var\u003e', personFields='names,emailAddresses')\n```\n\n### PHP\n\n```php\n$profile = $people_service-\u003epeople-\u003eget(\n 'people/\u003cvar translate=\"no\"\u003eaccount_id\u003c/var\u003e', array('personFields' =\u003e 'names,emailAddresses'));\n```\n\n### .NET\n\n```c#\nPeopleResource.GetRequest peopleRequest =\n peopleService.People.Get(\"people/\u003cvar translate=\"no\"\u003eaccount_id\u003c/var\u003e\");\npeopleRequest.PersonFields = \"names,emailAddresses\";\nPerson profile = peopleRequest.Execute();\n```"]]
