public interface

People

com.google.android.gms.plus.People

This interface is deprecated.
This API may return empty results, even if the user consented to SCOPE_PLUS_LOGIN. Please refer to Deprecation Notes for details. See below for suggested replacements.

  1. On Android, consider using Contacts Provider.
  2. If you are looking for cross-platform solutions, check out People API.
  3. If you want to advocate your app to your existing users' social graph, check out Firebase Invites.

Class Overview

Methods and interfaces related to people in Google+.

Summary

Nested Classes
interface People.LoadPeopleResult Information about the set of people that was loaded. 
interface People.OrderBy Constants to declare the order to return people in. 
Public Methods
abstract Person getCurrentPerson(GoogleApiClient googleApiClient)
This method is deprecated. use GoogleSignInApi and getSignInAccount() instead.
abstract PendingResult<People.LoadPeopleResult> load(GoogleApiClient googleApiClient, Collection<String> personIds)
This method is deprecated. In the future, you can possibly get empty data back even if user consented to the required scopes. See People for details.
abstract PendingResult<People.LoadPeopleResult> load(GoogleApiClient googleApiClient, String... personIds)
This method is deprecated. In the future, you can possibly get empty data back even if user consented to the required scopes. See People for details.
abstract PendingResult<People.LoadPeopleResult> loadConnected(GoogleApiClient googleApiClient)
This method is deprecated. In the future, you can possibly get empty data back even if user consented to the required scopes. See People for details.
abstract PendingResult<People.LoadPeopleResult> loadVisible(GoogleApiClient googleApiClient, int orderBy, String pageToken)
This method is deprecated. In the future, you can possibly get empty data back even if user consented to the required scopes. See People for details.
abstract PendingResult<People.LoadPeopleResult> loadVisible(GoogleApiClient googleApiClient, String pageToken)
This method is deprecated. In the future, you can possibly get empty data back even if user consented to the required scopes. See People for details.

Public Methods

public abstract Person getCurrentPerson (GoogleApiClient googleApiClient)

This method is deprecated.
use GoogleSignInApi and getSignInAccount() instead.

Returns profile information for the current user. For more information, see: https://developers.google.com/+/api/latest/people/get.

This method can return null if the required scopes weren't specified in the GoogleApiClient.Builder, or if there was a network error while connecting.

Required API: API
Required Scopes: SCOPE_PLUS_LOGIN or SCOPE_PLUS_PROFILE

Parameters
googleApiClient GoogleApiClient: The GoogleApiClient to service the call.
Returns
Person Profile information for the current user, if available, or null otherwise.

public abstract PendingResult<People.LoadPeopleResult> load (GoogleApiClient googleApiClient, Collection<String> personIds)

This method is deprecated.
In the future, you can possibly get empty data back even if user consented to the required scopes. See People for details.

Loads a list of specified people.

This call returns all information in Person, but only for the people specified and for data that is public in their profiles.

Required API: API
Required Scopes: SCOPE_PLUS_LOGIN

Parameters
googleApiClient GoogleApiClient: The GoogleApiClient to service the call.
personIds Collection: The IDs of people to load. This should match the user id that would be sent to https://developers.google.com/+/api/latest/people/get
Returns
PendingResult<People.LoadPeopleResult> the PendingResult for notification and access to the result when it's available.

public abstract PendingResult<People.LoadPeopleResult> load (GoogleApiClient googleApiClient, String... personIds)

This method is deprecated.
In the future, you can possibly get empty data back even if user consented to the required scopes. See People for details.

Loads a list of specified people.

This call returns all information in Person, but only for the people specified and for data that is public in their profiles.

Required API: API
Required Scopes: SCOPE_PLUS_LOGIN

Parameters
googleApiClient GoogleApiClient: The GoogleApiClient to service the call.
personIds String: The ids of people to load. This should match the user id that would be sent to https://developers.google.com/+/api/latest/people/get
Returns
PendingResult<People.LoadPeopleResult> the PendingResult for notification and access to the result when it's available.

public abstract PendingResult<People.LoadPeopleResult> loadConnected (GoogleApiClient googleApiClient)

This method is deprecated.
In the future, you can possibly get empty data back even if user consented to the required scopes. See People for details.

Loads a list of visible people in the authenticated user’s circles that are signed into the same app with Google+. For more information, see: https://developers.google.com/+/api/latest/people/list.

Each Person will contain the id, displayName, image, objectType, and url fields populated. To retrieve additional profile data, use the load(GoogleApiClient, String...) method.

Required API: API
Required Scopes: SCOPE_PLUS_LOGIN

Parameters
googleApiClient GoogleApiClient: The GoogleApiClient to service the call.
Returns
PendingResult<People.LoadPeopleResult>

public abstract PendingResult<People.LoadPeopleResult> loadVisible (GoogleApiClient googleApiClient, int orderBy, String pageToken)

This method is deprecated.
In the future, you can possibly get empty data back even if user consented to the required scopes. See People for details.

Loads the list of visible people in the user's circles. For more information, see: https://developers.google.com/+/api/latest/people/list.

Each Person will contain the id, displayName, image, objectType, and url fields populated. To retrieve additional profile data, use the load(GoogleApiClient, String...) method.

Required API: API
Required Scopes: SCOPE_PLUS_LOGIN

Parameters
googleApiClient GoogleApiClient: The GoogleApiClient to service the call.
orderBy int: The order to return people in. Valid values are:

ALPHABETICAL - Order the people by their display name. BEST - Order people based on the relevance to the viewer.

pageToken String: Result of getNextPageToken() to get the next page of data. Pass in null to get the first page.
Returns
PendingResult<People.LoadPeopleResult> the PendingResult for notification and access to the result when it's available.

public abstract PendingResult<People.LoadPeopleResult> loadVisible (GoogleApiClient googleApiClient, String pageToken)

This method is deprecated.
In the future, you can possibly get empty data back even if user consented to the required scopes. See People for details.

Loads the list of visible people in the user's circles. For more information, see: https://developers.google.com/+/api/latest/people/list.

Each Person will contain the id, displayName, image, objectType, and url fields populated. To retrieve additional profile data, use the load(GoogleApiClient, String...) method.

Required API: API
Required Scopes: SCOPE_PLUS_LOGIN

Parameters
googleApiClient GoogleApiClient: The GoogleApiClient to service the call.
pageToken String: Result of getNextPageToken() to get the next page of data. Pass in null to get the first page.
Returns
PendingResult<People.LoadPeopleResult> the PendingResult for notification and access to the result when it's available.