프로필 읽기
컬렉션을 사용해 정리하기
내 환경설정을 기준으로 콘텐츠를 저장하고 분류하세요.
People API 사용 준비하기의 단계를 완료하면 프로필의 데이터를 읽을 준비가 됩니다.
다음 코드 샘플은 몇 가지 간단한 요청을 보내는 방법을 보여줍니다. 메서드의 전체 목록은 참조 문서를 참고하세요.
인증된 사용자의 사용자 가져오기
사용자의 프로필을 가져오려면 다음 코드를 사용하세요.
프로토콜
GET /v1/people/me?personFields=names,emailAddresses HTTP/1.1
Host: people.googleapis.com
자바
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();
Google 계정 ID의 사용자 가져오기
Google 계정 ID의 사용자 정보를 가져오려면 다음 코드를 사용하세요.
프로토콜
GET /v1/people/account_id?personFields=names,emailAddresses HTTP/1.1
Host: people.googleapis.com
자바
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();
달리 명시되지 않는 한 이 페이지의 콘텐츠에는 Creative Commons Attribution 4.0 라이선스에 따라 라이선스가 부여되며, 코드 샘플에는 Apache 2.0 라이선스에 따라 라이선스가 부여됩니다. 자세한 내용은 Google Developers 사이트 정책을 참조하세요. 자바는 Oracle 및/또는 Oracle 계열사의 등록 상표입니다.
최종 업데이트: 2025-08-29(UTC)
[null,null,["최종 업데이트: 2025-08-29(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```"]]
