public static class

PlusShare.Builder

extends Object
java.lang.Object
   ↳ com.google.android.gms.plus.PlusShare.Builder

Summary

Public Constructors
PlusShare.Builder(Context context)
Create a new Builder for launching a sharing action from the given context.
PlusShare.Builder(Activity launchingActivity)
Create a new Builder for launching a sharing action from launchingActivity.
PlusShare.Builder(Activity launchingActivity, PlusClient plusClient)
Create a new Builder for launching a sharing action from launchingActivity.
Public Methods
PlusShare.Builder addCallToAction(String label, Uri uri, String deepLinkId)
Adds a call-to-action button for an interactive post.
PlusShare.Builder addStream(Uri streamUri)
Add a stream URI to the data that should be shared.
Intent getIntent()
Retrieve the Intent as configured so far by the Builder.
PlusShare.Builder setContentDeepLinkId(String deepLinkId, String title, String description, Uri thumbnailUri)
Include a deep-link ID to a resource to share on Google+.
PlusShare.Builder setContentDeepLinkId(String deepLinkId)
Include a deep-link URI of a resource to share on Google+.
PlusShare.Builder setContentUrl(Uri uri)
Sets a URL to link to from the content on the web.
PlusShare.Builder setRecipients(List<Person> recipientList)
Sets a list of people to send the interactive post to.
PlusShare.Builder setStream(Uri streamUri)
Set a stream URI to the data that should be shared.
PlusShare.Builder setText(CharSequence text)
Set a pre-filled message to be sent as part of the share.
PlusShare.Builder setType(String mimeType)
Set the type of data being shared.
[Expand]
Inherited Methods
From class java.lang.Object

Public Constructors

public PlusShare.Builder (Context context)

Create a new Builder for launching a sharing action from the given context.

Parameters
context Context that the share will be launched from

public PlusShare.Builder (Activity launchingActivity)

Create a new Builder for launching a sharing action from launchingActivity.

Parameters
launchingActivity Activity that the share will be launched from

public PlusShare.Builder (Activity launchingActivity, PlusClient plusClient)

Create a new Builder for launching a sharing action from launchingActivity. You must provide a connected PlusClient that has the PLUS_LOGIN scope when creating an interactive post with a call-to-action button.

Parameters
launchingActivity Activity that the share will be launched from
plusClient The connected PlusClient object.

Public Methods

public PlusShare.Builder addCallToAction (String label, Uri uri, String deepLinkId)

Adds a call-to-action button for an interactive post. To use this method, you must have passed a signed-in PlusClient to the Builder.Builder(Activity, PlusClient) constructor or an IllegalStateException will be thrown.

Parameters
label The call-to-action label. Choose a value from the list of list
uri The URL to link to when the user clicks the call-to-action. This parameter is required.
deepLinkId A deep-link ID to send to mobile clients when the user clicks the call-to-action. This parameter is optional.

public PlusShare.Builder addStream (Uri streamUri)

Add a stream URI to the data that should be shared. If this is not the first stream URI added the final intent constructed will become an ACTION_SEND_MULTIPLE intent. Not all apps will handle both ACTION_SEND and ACTION_SEND_MULTIPLE.

Parameters
streamUri URI of the stream to share.
Returns
  • This Builder for method chaining.

public Intent getIntent ()

Retrieve the Intent as configured so far by the Builder.

Returns
  • The current Intent being configured by this builder

public PlusShare.Builder setContentDeepLinkId (String deepLinkId, String title, String description, Uri thumbnailUri)

Include a deep-link ID to a resource to share on Google+.

Parameters
deepLinkId The deep-link ID to a resource to share on Google+. This parameter is required.
title The title of the resource. Used if there is no content URL to display. This parameter is optional.
description The description of a resource. Used if there is no content URL to display. This parameter is optional.
thumbnailUri The thumbnailUri for a resource. Used if there is no content URL to display. This parameter is optional.
Returns
  • This Builder for method chaining.

public PlusShare.Builder setContentDeepLinkId (String deepLinkId)

Include a deep-link URI of a resource to share on Google+.

Parameters
deepLinkId The deep-link ID to a resource to share on Google+. This parameter is required.
Returns
  • This Builder for method chaining.

public PlusShare.Builder setContentUrl (Uri uri)

Sets a URL to link to from the content on the web. The content URL is required when used in conjunction with addCallToAction(String, Uri, String) to build an interactive post, and to provide the user context for the call-to-action button.

Parameters
uri the URL to link to on the web.
Returns
  • This Builder for method chaining.

public PlusShare.Builder setRecipients (List<Person> recipientList)

Sets a list of people to send the interactive post to.

This sets the initial people to share with, but the user can change who the post is shared with before posting. A maximum of ten recipients are allowed.

Parameters
recipientList A list of recipients. See loadPeople(PlusClient.OnPeopleLoadedListener, String...) and createPerson(String, String).
Returns
  • This Builder for method chaining.

public PlusShare.Builder setStream (Uri streamUri)

Set a stream URI to the data that should be shared.

This replaces all currently set stream URIs and will produce a single-stream ACTION_SEND intent.

Parameters
streamUri URI of the stream to share
Returns
  • This Builder for method chaining
See Also

public PlusShare.Builder setText (CharSequence text)

Set a pre-filled message to be sent as part of the share. This may be a styled CharSequence.

Parameters
text Text to share
Returns
  • This Builder for method chaining
See Also

public PlusShare.Builder setType (String mimeType)

Set the type of data being shared.

Parameters
mimeType mimetype of the shared data
Returns
  • This Builder for method chaining
See Also