java.lang.Object | |
↳ | com.google.android.gms.appinvite.AppInviteInvitation.IntentBuilder |
Build an Intent to launch the invitation Activity to create and send invitations.
The Intent returned from build()
should be used to start the Activity using
startActivityForResult(android.content.Intent, int)
.
Example:
Intent intent = new AppInviteInvitation
.IntentBuilder("Send Invitations for XYZ app")
.setMessage("Try out XYZ app now")
.setDeepLink("http://xyz.com/offer/free_trial_campaign")
.setCallToActionText("Find data")
...
.build();
startActivityForResult(intent, REQUEST_INVITE);
AppInviteReferral
provides
accessors to the broadcast parameters from within a custom broadcast receiver.
Nested Classes | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|
AppInviteInvitation.IntentBuilder.PlatformMode | Mode for checking platform types. |
Constants | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|
int | MAX_CALL_TO_ACTION_TEXT_LENGTH |
Maximum length for the invitation button text set in
setCallToActionText(CharSequence) .
|
|||||||||
int | MAX_MESSAGE_LENGTH |
Maximum length for the invitation message set in setMessage(CharSequence) .
|
|||||||||
int | MIN_CALL_TO_ACTION_TEXT_LENGTH |
Minimum length for the invitation button text set in
setCallToActionText(CharSequence) .
|
Public Constructors | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|
App invite invitation builder.
|
Public Methods | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|
Builds the Intent to start the invitation Activity.
| |||||||||||
Sets the name of the account to get a list of people for.
| |||||||||||
Adds query parameters to the play store referral URL when the app needs additional
referral parameters for other application component referrals.
| |||||||||||
Sets the minimum version of the android app installed on the receiving device.
| |||||||||||
Text shown on the email invitation for the user to accept the invitation.
| |||||||||||
Sets an image for invitations.
| |||||||||||
Sets the deep link that is made available to the app when opened from the
invitation.
| |||||||||||
Sets the Google Analytics Tracking id.
| |||||||||||
Sets the invite message that is sent to all invitees.
| |||||||||||
Targets another version of your app to receive the invitation from Android.
|
[Expand]
Inherited Methods | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|
![]() |
Maximum length for the invitation button text set in
setCallToActionText(CharSequence)
.
Maximum length for the invitation message set in setMessage(CharSequence)
.
Minimum length for the invitation button text set in
setCallToActionText(CharSequence)
.
App invite invitation builder.
title | Sets the title for the invitation Activity. |
---|
NullPointerException | if title is null. |
---|
Builds the Intent to start the invitation Activity.
startActivityForResult(Intent, int)
to open the App Invite Activity.
Sets the name of the account to get a list of people for.
account | Account of one of the accounts on the device user. The account type
must be a Google account GOOGLE_ACCOUNT_TYPE . |
---|
Adds query parameters to the play store referral URL when the app needs additional referral parameters for other application component referrals. These parameters are added to the referral URL sent from the play store and are available to be processed by other application components, for example Google Analytics. The parameters are set as name, value pairs that will be set as query parameter name and value on the referral URL.
Example:
Map referralParams = new HashMap();
referralParams.put("paramOne", "1");
referralParams.put("paramTwo", "2");
Intent intent = new AppInviteInvitation
.IntentBuilder("Send Invitations for XYZ app")
.setAdditionalReferralParameters(referralParams)
...
.build();
startActivityForResult(intent, REQUEST_INVITE);
params | Referral parameters defined as name value pairs. |
---|
Sets the minimum version of the android app installed on the receiving device. If this minimum version is not installed then the install flow will be triggered.
versionCode | Minimum version of the android app. It will be compared with the android version code and if below this minimum the app will be considered not installed. Defaults to 0 which disables the version check. |
---|
Text shown on the email invitation for the user to accept the invitation. Default install text used if not set.
callToActionText | Text to use on the invitation button. |
---|
IllegalArgumentException | if the length is greater than
MAX_CALL_TO_ACTION_TEXT_LENGTH or less then
MIN_CALL_TO_ACTION_TEXT_LENGTH characters. |
---|
Sets an image for invitations.
imageUri | the image Uri. The Uri is required to be in absolute format. The Uri can be either a content URI with scheme "android.resource", "content" or "file" or a network url with scheme "http" or "https". The supported image formats are "jpg", "jpeg" and "png". |
---|
Sets the deep link that is made available to the app when opened from the invitation. This deep link is made available both to a newly installed application and an already installed application. The deep link can be sent to Android and other platforms so should be formatted to support deep links across platforms.
On android, a deep link filter for AppInvite should include an action, category, and data where the data is a uri that matches the deep link. The action must be VIEW and include both category DEFAULT and BROWSABLE as shown in the example.
Accessing the deep link in the application after being opened is described in
AppInviteReferral
.
deepLink | The app deep link. |
---|
Sets the Google Analytics Tracking id. The tracking id should be created for the calling application under Google Analytics. See more about how to get a tracking id . The tracking id is recommended so that invitations sent from the calling application are available in Google Analytics.
trackingId | String of the form UA-xxxx-y |
---|
Sets the invite message that is sent to all invitees.
Must be valid (MAX_MESSAGE_LENGTH
bytes or less).
The message can be edited by the sender.
message | The invite message. |
---|
IllegalArgumentException | if the length is greater than
MAX_MESSAGE_LENGTH .
|
---|
Targets another version of your app to receive the invitation from Android. This is needed only when there are multiple client IDs defined in your Google Developer Console project. Setting the target client ID for the invitation ensures that it goes to the correct app.
targetPlatform | Platform for the clientId. Must be
PROJECT_PLATFORM_IOS or
PROJECT_PLATFORM_ANDROID . |
---|---|
clientId | Google generated client Id from the Developer console. |
IllegalArgumentException | if is not
PROJECT_PLATFORM_IOS or
PROJECT_PLATFORM_ANDROID .
|
---|