# Google+ Domains API . circles

## Instance Methods

Add a person to a circle. Google+ limits certain circle operations, including the number of circle adds. Learn More.

Get a circle.

Create a new circle for the authenticated user.

List all of the circles for a user.

Retrieves the next page of results.

Update a circle's description. This method supports patch semantics.

Delete a circle.

Remove a person from a circle.

Update a circle's description.

### Method Details

`addPeople(circleId, userId=None, email=None)`

    Add a person to a circle. Google+ limits certain circle operations, including the number of circle adds. Learn More.

    Args:
      circleId: string, The ID of the circle to add the person to. (required)
      userId: string, IDs of the people to add to the circle. Optional, can be repeated. (repeated)
      email: string, Email of the people to add to the circle. Optional, can be repeated. (repeated)

    Returns:
      An object of the form:

        {
          "kind": "plus#circle", # Identifies this resource as a circle. Value: "plus#circle".
          "displayName": "A String", # The circle name.
          "description": "A String", # The description of this circle.
          "people": { # The people in this circle.
            "totalItems": 42, # The total number of people in this circle.
          },
          "etag": "A String", # ETag of this response for caching purposes.
          "id": "A String", # The ID of the circle.
          "selfLink": "A String", # Link to this circle resource
        }

`get(circleId)`

    Get a circle.

    Args:
      circleId: string, The ID of the circle to get. (required)

    Returns:
      An object of the form:

        {
          "kind": "plus#circle", # Identifies this resource as a circle. Value: "plus#circle".
          "displayName": "A String", # The circle name.
          "description": "A String", # The description of this circle.
          "people": { # The people in this circle.
            "totalItems": 42, # The total number of people in this circle.
          },
          "etag": "A String", # ETag of this response for caching purposes.
          "id": "A String", # The ID of the circle.
          "selfLink": "A String", # Link to this circle resource
        }

`insert(userId, body)`

    Create a new circle for the authenticated user.

    Args:
      userId: string, The ID of the user to create the circle on behalf of. The value "me" can be used to indicate the authenticated user. (required)
      body: object, The request body. (required)
        The object takes the form of:

    {
        "kind": "plus#circle", # Identifies this resource as a circle. Value: "plus#circle".
        "displayName": "A String", # The circle name.
        "description": "A String", # The description of this circle.
        "people": { # The people in this circle.
          "totalItems": 42, # The total number of people in this circle.
        },
        "etag": "A String", # ETag of this response for caching purposes.
        "id": "A String", # The ID of the circle.
        "selfLink": "A String", # Link to this circle resource
      }

    Returns:
      An object of the form:

        {
          "kind": "plus#circle", # Identifies this resource as a circle. Value: "plus#circle".
          "displayName": "A String", # The circle name.
          "description": "A String", # The description of this circle.
          "people": { # The people in this circle.
            "totalItems": 42, # The total number of people in this circle.
          },
          "etag": "A String", # ETag of this response for caching purposes.
          "id": "A String", # The ID of the circle.
          "selfLink": "A String", # Link to this circle resource
        }

`list(userId, pageToken=None, maxResults=None)`

    List all of the circles for a user.

    Args:
      userId: string, The ID of the user to get circles for. The special value "me" can be used to indicate the authenticated user. (required)
      pageToken: string, The continuation token, which is used to page through large result sets. To get the next page of results, set this parameter to the value of "nextPageToken" from the previous response.
      maxResults: integer, The maximum number of circles to include in the response, which is used for paging. For any response, the actual number returned might be less than the specified maxResults.

    Returns:
      An object of the form:

        {
        "nextPageToken": "A String", # The continuation token, which is used to page through large result sets. Provide this value in a subsequent request to return the next page of results.
        "kind": "plus#circleFeed", # Identifies this resource as a collection of circles. Value: "plus#circleFeed".
        "title": "A String", # The title of this list of resources.
        "items": [ # The circles in this page of results.
          {
              "kind": "plus#circle", # Identifies this resource as a circle. Value: "plus#circle".
              "displayName": "A String", # The circle name.
              "description": "A String", # The description of this circle.
              "people": { # The people in this circle.
                "totalItems": 42, # The total number of people in this circle.
              },
              "etag": "A String", # ETag of this response for caching purposes.
              "id": "A String", # The ID of the circle.
              "selfLink": "A String", # Link to this circle resource
            },
        ],
        "nextLink": "A String", # Link to the next page of circles.
        "etag": "A String", # ETag of this response for caching purposes.
        "totalItems": 42, # The total number of circles. The number of circles in this response may be smaller due to paging.
        "selfLink": "A String", # Link to this page of circles.
      }

`list_next(previous_request, previous_response)`

    Retrieves the next page of results.

    Args:
      previous_request: The request for the previous page. (required)
      previous_response: The response from the request for the previous page. (required)

    Returns:
      A request object that you can call 'execute()' on to request the next
      page. Returns None if there are no more items in the collection.

`patch(circleId, body)`

    Update a circle's description. This method supports patch semantics.

    Args:
      circleId: string, The ID of the circle to update. (required)
      body: object, The request body. (required)
        The object takes the form of:

    {
        "kind": "plus#circle", # Identifies this resource as a circle. Value: "plus#circle".
        "displayName": "A String", # The circle name.
        "description": "A String", # The description of this circle.
        "people": { # The people in this circle.
          "totalItems": 42, # The total number of people in this circle.
        },
        "etag": "A String", # ETag of this response for caching purposes.
        "id": "A String", # The ID of the circle.
        "selfLink": "A String", # Link to this circle resource
      }

    Returns:
      An object of the form:

        {
          "kind": "plus#circle", # Identifies this resource as a circle. Value: "plus#circle".
          "displayName": "A String", # The circle name.
          "description": "A String", # The description of this circle.
          "people": { # The people in this circle.
            "totalItems": 42, # The total number of people in this circle.
          },
          "etag": "A String", # ETag of this response for caching purposes.
          "id": "A String", # The ID of the circle.
          "selfLink": "A String", # Link to this circle resource
        }

`remove(circleId)`

    Delete a circle.

    Args:
      circleId: string, The ID of the circle to delete. (required)

`removePeople(circleId, userId=None, email=None)`

    Remove a person from a circle.

    Args:
      circleId: string, The ID of the circle to remove the person from. (required)
      userId: string, IDs of the people to remove from the circle. Optional, can be repeated. (repeated)
      email: string, Email of the people to add to the circle. Optional, can be repeated. (repeated)

`update(circleId, body)`

    Update a circle's description.

    Args:
      circleId: string, The ID of the circle to update. (required)
      body: object, The request body. (required)
        The object takes the form of:

    {
        "kind": "plus#circle", # Identifies this resource as a circle. Value: "plus#circle".
        "displayName": "A String", # The circle name.
        "description": "A String", # The description of this circle.
        "people": { # The people in this circle.
          "totalItems": 42, # The total number of people in this circle.
        },
        "etag": "A String", # ETag of this response for caching purposes.
        "id": "A String", # The ID of the circle.
        "selfLink": "A String", # Link to this circle resource
      }

    Returns:
      An object of the form:

        {
          "kind": "plus#circle", # Identifies this resource as a circle. Value: "plus#circle".
          "displayName": "A String", # The circle name.
          "description": "A String", # The description of this circle.
          "people": { # The people in this circle.
            "totalItems": 42, # The total number of people in this circle.
          },
          "etag": "A String", # ETag of this response for caching purposes.
          "id": "A String", # The ID of the circle.
          "selfLink": "A String", # Link to this circle resource
        }