Access Control

One of the key features of Google+ is targeted sharing. Sometimes a user might want to share something with the whole organisation, such as announcing a new role or the birth of a child. Often the desired audience is much more specific. For example, a user might want to share a presentation just with the other members of their team, or perhaps share pictures of their vacation only with their closest friends. Google+ allows users to share activities with exactly the audience they choose.

When sharing an activity a user can specify the desired audience, such as an individual person or one of their circles. When calling the Google+ Domains API, this audience is specified using the access property. For example, the following activity is being shared with the domain:

{
  /* ... */
  "access": {
    "items": [
      {
        "type": "domain"
      }
    ],
    "domainRestricted": true
  }
}

Audience

A user can share to one or more of the following audiences. All of the audiences listed below are restricted to users within the domain.

Domain

In the Google+ Domains API, the domain option is the broadest audience for sharing. The post can be viewed by any user in your domain.

{ "type": "domain" }
Extended Circles

To share with everyone in a user's circles plus all of the people in their circles, but limited to those within the domain, include an entry with a type value of extendedCircles. For example:

{ "type": "extendedCircles" }
My Circles

Instead of including each of a user's circles individually, you can share with all of people in the user's circles who are within the domain by including an entry with a type of myCircles. For example:

{ "type": "myCircles" }
Circle

You can share with the people in an individual circle, and also in the same domain, by including an entry with a type value of circle and an id identifying the circle. The circle option is a subset of the domain audience. For example:

{ "type": "circle", "id": "5678" }

You can retrieve a user's list of circles and the circle IDs by using the circles.list method.

Person

To share with an individual user within the domain, include an entry with a type value of person and an id that identifies the user. For example:

{ "type": "person", "id": "1234" }

You can get the IDs for people by listing the people in the user's circles, or an individual circle, by using people.list or people.listByCircle methods.

Multiple audiences

An activity can be shared with a combination of audiences. For example, the following activity is shared with an individual user as well as one of the user's circles:

{
  /* ... */
  "access": {
    "items": [
      { "type": "person", "id": "1234" },
      { "type": "circle", "id": "5678" }
    ],
    "domainRestricted": true
  }
}

Send feedback about...

Google+ Domains API
Google+ Domains API