API Reference

This API reference is organized by resource type. Each resource type has one or more data representations and one or more methods.

Resource types

  1. Activities
  2. Audiences
  3. Comments
  4. Circles
  5. People
  6. Media

Activities

For Activities Resource details, see the resource representation page.

Method HTTP request Description
URIs relative to https://www.googleapis.com/plusDomains/v1, unless otherwise noted
insert POST  /people/userId/activities Create a new activity for the authenticated user.
list GET  /people/userId/activities/collection List all of the activities in the specified collection for a particular user.
get GET  /activities/activityId Get an activity.

Audiences

For Audiences Resource details, see the resource representation page.

Method HTTP request Description
URIs relative to https://www.googleapis.com/plusDomains/v1, unless otherwise noted
list GET  /people/userId/audiences List all of the audiences to which a user can share.

Comments

For Comments Resource details, see the resource representation page.

Method HTTP request Description
URIs relative to https://www.googleapis.com/plusDomains/v1, unless otherwise noted
insert POST  /activities/activityId/comments Create a new comment in reply to an activity.
list GET  /activities/activityId/comments List all of the comments for an activity.
get GET  /comments/commentId Get a comment.

Circles

For Circles Resource details, see the resource representation page.

Method HTTP request Description
URIs relative to https://www.googleapis.com/plusDomains/v1, unless otherwise noted
get GET  /circles/circleId Get a circle.
insert POST  /people/userId/circles Create a new circle for the authenticated user.
list GET  /people/userId/circles List all of the circles for a user.
patch PATCH  /circles/circleId Update a circle's description. This method supports patch semantics.
remove DELETE  /circles/circleId Delete a circle.
update PUT  /circles/circleId Update a circle's description.
addPeople PUT  /circles/circleId/people Add a person to a circle. Google+ limits certain circle operations, including the number of circle adds. Learn More.
removePeople DELETE  /circles/circleId/people Remove a person from a circle.

People

For People Resource details, see the resource representation page.

Method HTTP request Description
URIs relative to https://www.googleapis.com/plusDomains/v1, unless otherwise noted
get GET  /people/userId Get a person's profile.
list GET  /people/userId/people/collection List all of the people in the specified collection.
listByCircle GET  /circles/circleId/people List all of the people who are members of a circle.
listByActivity GET  /activities/activityId/people/collection List all of the people in the specified collection for a particular activity.

Media

For Media Resource details, see the resource representation page.

Method HTTP request Description
URIs relative to https://www.googleapis.com/plusDomains/v1, unless otherwise noted
insert POST
https://www.googleapis.com/upload/plusDomains/v1/people/userId/media/collection

and
POST  /people/userId/media/collection
Add a new media item to an album. The current upload size limitations are 36MB for a photo and 1GB for a video. Uploads do not count against quota if photos are less than 2048 pixels on their longest side or videos are less than 15 minutes in length.

Send feedback about...

Google+ Domains API
Google+ Domains API