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.
[null,null,["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```"]]