Legacy Google+ APIs have been shut down as of March 7, 2019. Changes to the shutdown plan have been made recently which may mitigate its effect on some developers. Learn more.

Google+ integrations for web and mobile apps have also stopped functioning as of March 7, 2019. Learn more.

Deleting circles

The Google+ Domains API allows your app to delete circles for users within your Google Apps domain.

To delete a circle, your app must request the following scopes:

https://www.googleapis.com/auth/plus.me
Grants the app permission to use the special value me to represent the authenticated user. Does not apply to apps that use domain-wide delegation of authority.
https://www.googleapis.com/auth/plus.circles.write
Required - Grants permission for the app to create circles, delete circles, add people and pages to the user's circles, and remove people and pages from the user's circles. The Google+ Domains API only permits adding and removing people in the same Google Apps domain as the user.

The following example demonstrates how to delete a circle within your Google Apps domain.

Java

// This sample assumes a client object `plusDomains` has been created,
// and that you know the ID of the circle to be deleted. One way to
// obtain this ID is to use Circles.list.
// To learn more about creating a client, see the OAuth 2.0 example:
//  https://developers.google.com/+/domains/authentication/

String circleId = "a1234b";
plusDomains.circles().remove(circleId).execute();

Python

# This sample assumes a client object `service` has been created, and
# that you know the ID of the circle to be deleted. One way to obtain
# this ID is to use Circles.list.
# To learn more about creating a client, see the OAuth 2.0 example:
#  https://developers.google.com/+/domains/authentication/

circle_id = 'a1234b'
service.circles().remove(circleId=circle_id).execute()

Protocol

See the Circles.remove REST API method.