Click here to see your recently viewed pages and most viewed pages.

Google Apps Profiles Data API Reference Guide

This document provides detailed reference documentation for the raw protocol (XML and HTTP) for the Google Apps Profiles Data API.

This document doesn't contain information about the programming-language client libraries. For client-library reference information, see the links from the programming-language-specific sections of the developer's guide.

Note: This API is only available to Google Apps Premier, Education, and Partner Edition domains, and cannot be used for accessing or editing the Google Apps for free edition or Gmail profiles.



This document is intended for programmers who want to write client applications that can interact with the Profiles Data API.

It's a reference document; it assumes that you understand the concepts presented in the developer's guide, and the general ideas behind the Google Data APIs protocol.

Profiles Data API feed types

The Profiles Data API provides one type of feed: the profiles feed.

The feed is a private read/write feed that can be used to view and manage profiles of users in a Google Apps organization. Since they are private, a programmer can access them only by using an authenticated request. That is, the request must contain an authentication token for a user in the domain whose profiles you want to retrieve. For more information about authenticating, see the developer's guide.

Profiles feed

The URL for a feed of profiles takes the following form:

For example, the profiles feed for would have the following URI:

Profiles query parameters reference

The Profiles Data API supports the following standard Google Data API query parameters:

Name Description
max-results The maximum number of entries to return.

For more information about the standard parameters, see the Google Data APIs protocol reference document.

In addition to the standard query parameters, the Profiles Data API supports the following parameters:

Name Description
start-key Opaque key of the first element to retrieve. Present in the next link of an earlier request, if further pages of response are available.

Profiles elements reference

The Profiles Data API uses the standard Google Data API elements. A profile entry takes the form of an extended Profile kind. The Profile kind appears in XML as an <atom:entry> element that contains various extension elements from the Google Data namespace. For information about the standard Google Data API elements, see the Atom specification and the Kinds document.

The category element indicating that the entry is a profile looks like this:

<atom:category scheme=""

Extra restrictions on the standard Profile kind's extension elements

The Profiles Data API has the same restrictions on certain elements as the Contacts Data API does. Additionally, a profile entry cannot be marked as deleted (that is, it cannot contain a gd:deleted element). Also note that the Profile kind, unlike the Contact kind, does not support gd:extendedProperty.

Additional extensions of the Profile kind

The Profiles Data API supports all the same extensions as the Contacts Data API, with the exception of groupMembershipInfo. All these extensions belong to the gContact namespace.

In addition, the Profiles Data API supports the following extensions:

Extension element Description
gContact:status? Profile's status.


Stores information about the user profile's status. Currently, the API only supports the indexed attribute.

Property Description
indexed Whether or not the user profile's contact information should be shared when contacts sharing is enabled for the domain.

<gContact:status indexed='true'/>