PlusShare.Builder | Android Developers

Quicknav Quicknav
Links

- Google Play Developer Console
- Android Developers Blog
- About Android

Android Sites

- Android.com
- Android Developers
- Android Open Source Project

Language
close

- - Get Started
  - Style
  - Patterns
  - Building Blocks
  - Downloads
  - Videos
- - Training
  - API Guides
  - Reference
  - Tools
    - Get the SDK
  - Google Services
- - Google Play
  - Publishing
  - Promoting
  - App Quality
  - Spotlight
  - Open Distribution

## Results

Loading...
Summary: Ctors | Protected Ctors | Methods | Inherited Methods | [Expand All]
public static class

# PlusShare.Builder

extends Object

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

## Summary

Public Constructors
| PlusShare.Builder()
| 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.

Protected Constructors
| PlusShare.Builder(String intentAction) Create a new Builder for launching a sharing action.
| PlusShare.Builder(String intentAction, String activityPackageName, ComponentName activityComponentName) 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
Object | clone()
boolean | equals(Object arg0)
void | finalize()
final Class<?> | getClass()
int | hashCode()
final void | notify()
final void | notifyAll()
String | toString()
final void | wait()
final void | wait(long arg0, int arg1)
final void | wait(long arg0)

## Public Constructors

#### public PlusShare.Builder ()

#### 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 | A connected PlusClient.

## Protected Constructors

#### protected PlusShare.Builder (String intentAction)

Create a new Builder for launching a sharing action.

#### protected PlusShare.Builder (String intentAction, String activityPackageName, ComponentName activityComponentName)

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

##### Parameters

activityPackageName | Activity.getPackageName() from the Activity that the share will be launched from.

## 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 `ERROR(/PlusShare.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 or `deepLinkId` (or both) is required.
deepLinkId | A deep-link ID to send to mobile clients when the user clicks the call-to-action. This parameter or `uri` (or both) is required.

#### 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.

##### See Also

- `EXTRA_STREAM`
- `ACTION_SEND`

#### 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.

##### 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, int)` 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

- `EXTRA_STREAM`

#### 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

- `EXTRA_TEXT`

#### 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

- `setType(String)`