The Google+ source type allows you to filter for interactions related to public activities on Google+.
You can use this source to filter for any public posts, comments, shares, and likes created by the Google+ users in your circles and by Google+ pages you have in your circles.
The interactions you receive represent different types of content and engagement published on Google+. Each interaction carries information about the type of engagement it represents and about the content that engagement is related to.
The Google+ Managed Source type accesses the Google+ API on your behalf to collect data. The platform manages the collection and deduplication of data, adhering to API rate limits, and complies with authentication requirements of the Google+ API.
Each request made by the platform to Google must be authenticated using a valid user access token. When you configure an Google+ Managed Source you provide an OAuth 2.0 Access Token issued by Google that is used by the platform.
Obtaining Google+ access tokens
Because of the licensing requirements imposed by Google, you need to create a Google+ Managed source using the DataSift dashboard.
You can afterwards extract Google+ credentials, the access token and the refresh token, via the /source/get endpoint. You can then resuse these details when calling the /source/create or /source/update endpoints in future.
Configuring Google+ Managed Sources
Your DataSift account allows you to create multiple Google+ Managed Sources. Each source will be assigned its own
id, have its own independent settings, and can be assigned one or more unique resources to track.
When you configure a Google+ source you can choose which types of interactions to receive. You can optionally choose whether to receive comments and 'plus one' (+1) interactions.
Configure this option using the parameters argument when creating or updating sources.
Each source can be configured to track one or more unique resources. You can combine different types of resources in the same source.
Each resource represents your own Google+ activity stream or a search across public activity streams.
The following types of resource are supported:
- people_updates - Updates posted by a specific user
- public_activities - Results of searches on public activities
Configure resources using the resources parameter when creating or updating sources.
Each source must have at least one valid Google+ user access token. If you provide more than one access token then the source will rotate between tokens, allowing your source to consume more data. See the Managed Sources best practice guide for more details.
You configure access tokens for use by the source using the auth parameter when managing sources.
A running source will ingest data from the Google+ API. Data arrives as interactions in the platform which you are able to filter against.
You can use any of the Google+ targets for your filter conditions.
- Each Google+ interaction contains data about the activity published on Google+ and about the user posting that activity.
To get started read our Activate a Google+ Managed Source guide. This guide shows you how to configure a managed source using the DataSift dashboard.
Read the API step-by-step guide to learn how to manage sources using the API.
It's easy to get started with Managed Sources but there are important points to keep in mind.
Read our Managed Sources best practice guide for an overview of our recommendations.