Skip to content

Commit d146224

Browse files
Scott RoweAndroid Git Automerger
authored andcommitted
am 6287a65: am 294d534: am 9d20628: docs: b/16044763 Update IAB docs to give notice of v2 turndown
* commit '6287a65cca1d7efb8a265be5b51feca0f1e320f7': docs: b/16044763 Update IAB docs to give notice of v2 turndown
2 parents 3910b5d + 6287a65 commit d146224

1 file changed

Lines changed: 83 additions & 81 deletions

File tree

docs/html/google/play/billing/billing_overview.jd

Lines changed: 83 additions & 81 deletions
Original file line numberDiff line numberDiff line change
@@ -7,11 +7,11 @@ parent.link=index.html
77
<div id="qv">
88
<h2>Quickview</h2>
99
<ul>
10-
<li>Use In-app Billing to sell digital goods, including one-time items and
10+
<li>Use In-app Billing to sell digital goods, including one-time items and
1111
recurring subscriptions.</li>
12-
<li>Supported for any app published on Google Play. You only need a Google
12+
<li>Supported for any app published on Google Play. You only need a Google
1313
Play Developer Console account and a Google Wallet merchant account.</li>
14-
<li>Checkout processing is automatically handled by Google Play, with the
14+
<li>Checkout processing is automatically handled by Google Play, with the
1515
same look-and-feel as for app purchases.</li>
1616
</ul>
1717
<h2>In this document</h2>
@@ -24,18 +24,18 @@ same look-and-feel as for app purchases.</li>
2424
</li>
2525
<li><a href="#console">Google Play Developer Console</a></li>
2626
<li><a href="#checkout">Google Play Purchase Flow</a></li>
27-
<li><a href="#samples">Sample App</a></li>
27+
<li><a href="#samples">Sample App</a></li>
2828
<li><a href="#migration">Migration Considerations</a></li>
2929
</ol>
3030
<h2>Related Samples</h2>
3131
<ol>
3232
<li><a href="{@docRoot}training/in-app-billing/preparing-iab-app.html#GetSample">Sample Application (V3)</a></li>
33-
</ol>
33+
</ol>
3434
</div>
3535
</div>
3636

37-
<p>This documentation describes the fundamental In-app Billing components and
38-
features that you need to understand in order to add In-app
37+
<p>This documentation describes the fundamental In-app Billing components and
38+
features that you need to understand in order to add In-app
3939
Billing features into your application.</p>
4040

4141
<p class="note"><b>Note</b>: Ensure that you comply with applicable laws in the countries where you
@@ -49,130 +49,132 @@ of the EU consumer protection authorities</a> for more information on this and o
4949
</p>
5050

5151
<h2 id="api">In-app Billing API</h2>
52-
<p>Your application accesses the In-app Billing service using an API that is
53-
exposed by the Google Play app that is installed on the device. The Google Play
54-
app then conveys billing requests and responses between your
55-
application and the Google Play server. In practice, your application never
56-
directly communicates with the Google Play server. Instead, your application
57-
sends billing requests to the Google Play application over interprocess
58-
communication (IPC) and receives responses from the Google Play app.
59-
Your application does not manage any network connections between itself and
52+
<p>Your application accesses the In-app Billing service using an API that is
53+
exposed by the Google Play app that is installed on the device. The Google Play
54+
app then conveys billing requests and responses between your
55+
application and the Google Play server. In practice, your application never
56+
directly communicates with the Google Play server. Instead, your application
57+
sends billing requests to the Google Play application over interprocess
58+
communication (IPC) and receives responses from the Google Play app.
59+
Your application does not manage any network connections between itself and
6060
the Google Play server.</p>
61-
<p>In-app Billing can be implemented only in applications that you publish
62-
through Google Play. To complete in-app purchase requests, the Google Play app
61+
<p>In-app Billing can be implemented only in applications that you publish
62+
through Google Play. To complete in-app purchase requests, the Google Play app
6363
must be able to access the Google Play server over the network.</p>
6464

65-
<p>In-app billing Version 3 is the latest version, and maintains very broad
66-
compatibility across the range of Android devices. In-app Billing Version 3 is
67-
supported on devices running Android 2.2 or higher that have the latest version
65+
<p>In-app billing Version 3 is the latest version, and maintains very broad
66+
compatibility across the range of Android devices. In-app Billing Version 3 is
67+
supported on devices running Android 2.2 or higher that have the latest version
6868
of the Google Play store installed (<a href="{@docRoot}about/dashboards/index.html">a vast majority</a> of active devices).</p>
6969

7070
<h4>Version 3 features</h4>
7171
<ul>
72-
<li>Requests are sent through a streamlined API that allows you to easily request
73-
product details from Google Play, order in-app products, and quickly restore
72+
<li>Requests are sent through a streamlined API that allows you to easily request
73+
product details from Google Play, order in-app products, and quickly restore
7474
items based on users' product ownership</li>
75-
<li>Order information is synchronously propagated to the device on purchase
75+
<li>Order information is synchronously propagated to the device on purchase
7676
completion</li>
77-
<li>All purchases are “managed” (that is, Google Play keeps track of the user's
78-
ownership of in-app products). The user cannot own multiple copies of an in-app
77+
<li>All purchases are “managed” (that is, Google Play keeps track of the user's
78+
ownership of in-app products). The user cannot own multiple copies of an in-app
7979
item; only one copy can be owned at any point in time</li>
80-
<li>Purchased items can be consumed. When consumed, the item reverts to the
80+
<li>Purchased items can be consumed. When consumed, the item reverts to the
8181
"unowned" state and can be purchased again from Google Play</li>
8282
<li>Provides support for <a
8383
href="{@docRoot}google/play/billing/billing_subscriptions.html">subscriptions</a></li>
8484
</ul>
85-
<p>For details about other versions of In-app Billing, see the
85+
<p>For details about other versions of In-app Billing, see the
8686
<a href="{@docRoot}google/play/billing/versions.html">Version Notes</a>.</p>
8787

8888
<h2 id="products">In-app Products</h2>
89-
<p>In-app products are the digital goods that you offer for sale from inside your
90-
application to users. Examples of digital goods includes in-game currency,
91-
application feature upgrades that enhance the user experience, and new content
89+
<p>In-app products are the digital goods that you offer for sale from inside your
90+
application to users. Examples of digital goods includes in-game currency,
91+
application feature upgrades that enhance the user experience, and new content
9292
for your application.</p>
93-
<p>You can use In-app Billing to sell only digital content.
94-
You cannot use In-app Billing to sell physical goods, personal services, or
95-
anything that requires physical delivery. Unlike with priced applications, once
93+
<p>You can use In-app Billing to sell only digital content.
94+
You cannot use In-app Billing to sell physical goods, personal services, or
95+
anything that requires physical delivery. Unlike with priced applications, once
9696
the user has purchased an in-app product there is no refund window.</p>
97-
<p>Google Play does not provide any form of content delivery. You are
98-
responsible for delivering the digital content that you sell in your
99-
applications. In-app products are always explicitly associated with one and
100-
only one app. That is, one application cannot purchase an in-app product
97+
<p>Google Play does not provide any form of content delivery. You are
98+
responsible for delivering the digital content that you sell in your
99+
applications. In-app products are always explicitly associated with one and
100+
only one app. That is, one application cannot purchase an in-app product
101101
published for another app, even if they are from the same developer.</p>
102102

103103
<h3 id="prodtypes">Product types</h3>
104-
<p>In-app Billing supports different product types to give you flexibility in
105-
how you monetize your application. In all cases, you define your products using
104+
<p>In-app Billing supports different product types to give you flexibility in
105+
how you monetize your application. In all cases, you define your products using
106106
the Google Play Developer Console.</p>
107-
<p>You can specify these types of products for your In-app Billing application
108-
— <em>managed in-app products</em> and <em>subscriptions</em>. Google Play
109-
handles and tracks ownership for in-app products and subscriptions on your
107+
<p>You can specify these types of products for your In-app Billing application
108+
— <em>managed in-app products</em> and <em>subscriptions</em>. Google Play
109+
handles and tracks ownership for in-app products and subscriptions on your
110110
application on a per user account basis. <a href="{@docRoot}google/play/billing/api.html#producttypes">Learn more about the product types supported by In-app Billing Version 3</a>.</p>
111111

112112
<h2 id="console">Google Play Developer Console</h2>
113-
<p>The Developer Console is where you can publish your
114-
In-app Billing application, and manage the various in-app products that are
113+
<p>The Developer Console is where you can publish your
114+
In-app Billing application, and manage the various in-app products that are
115115
available for purchase from your application.</p>
116-
<p>You can create a product list of
117-
digital goods that are associated with your application, including items for
118-
one-time purchase and recurring subscriptions. For each item, you can define
119-
information such as the item’s unique product ID (also called its SKU), product
120-
type, pricing, description, and how Google Play should handle and track
116+
<p>You can create a product list of
117+
digital goods that are associated with your application, including items for
118+
one-time purchase and recurring subscriptions. For each item, you can define
119+
information such as the item’s unique product ID (also called its SKU), product
120+
type, pricing, description, and how Google Play should handle and track
121121
purchases for that product.</p>
122-
<p>You can also create test accounts to authorize
122+
<p>You can also create test accounts to authorize
123123
access for testing applications that are unpublished.</p>
124-
<p>To learn how to use the Developer Console to configure your in-app
125-
products and product list, see
126-
<a href="{@docRoot}google/play/billing/billing_admin.html">Administering
124+
<p>To learn how to use the Developer Console to configure your in-app
125+
products and product list, see
126+
<a href="{@docRoot}google/play/billing/billing_admin.html">Administering
127127
In-app Billing</a>.</p>
128128

129129
<h2 id="checkout">Google Play Purchase Flow</h2>
130-
<p>Google Play uses the same checkout backend service as is used for application
130+
<p>Google Play uses the same checkout backend service as is used for application
131131
purchases, so your users experience a consistent and familiar purchase flow.</p>
132132
<p class="note"><strong>Important:</strong> You must have a Google Wallet
133133
merchant account to use the In-app Billing service on Google Play.</p>
134-
<p>To initiate a purchase, your application sends a billing request for a
135-
specific in-app product. Google Play then handles all of the checkout details for
136-
the transaction, including requesting and validating the form of payment and
137-
processing the financial transaction.</p>
138-
<p>When the checkout process is complete,
139-
Google Play sends your application the purchase details, such as the order
140-
number, the order date and time, and the price paid. At no point does your
141-
application have to handle any financial transactions; that role is provided by
134+
<p>To initiate a purchase, your application sends a billing request for a
135+
specific in-app product. Google Play then handles all of the checkout details for
136+
the transaction, including requesting and validating the form of payment and
137+
processing the financial transaction.</p>
138+
<p>When the checkout process is complete,
139+
Google Play sends your application the purchase details, such as the order
140+
number, the order date and time, and the price paid. At no point does your
141+
application have to handle any financial transactions; that role is provided by
142142
Google Play.</p>
143143

144144
<h2 id="samples">Sample Application</h2>
145-
<p>To help you integrate In-app Billing into your application, the Android SDK
146-
provides a sample application that demonstrates how to sell in-app products and subscriptions
145+
<p>To help you integrate In-app Billing into your application, the Android SDK
146+
provides a sample application that demonstrates how to sell in-app products and subscriptions
147147
from inside an app.</p>
148148

149-
<p>The <a href="{@docRoot}training/in-app-billing/preparing-iab-app.html#GetSample">TrivialDrive sample for the Version 3 API</a> sample shows how to use the In-app Billing Version 3 API
150-
to implement in-app product and subscription purchases for a driving game. The
151-
application demonstrates how to send In-app Billing requests, and handle
152-
synchronous responses from Google Play. The application also shows how to record
153-
item consumption with the API. The Version 3 sample includes convenience classes
154-
for processing In-app Billing operations as well as perform automatic signature
149+
<p>The <a href="{@docRoot}training/in-app-billing/preparing-iab-app.html#GetSample">TrivialDrive sample for the Version 3 API</a> sample shows how to use the In-app Billing Version 3 API
150+
to implement in-app product and subscription purchases for a driving game. The
151+
application demonstrates how to send In-app Billing requests, and handle
152+
synchronous responses from Google Play. The application also shows how to record
153+
item consumption with the API. The Version 3 sample includes convenience classes
154+
for processing In-app Billing operations as well as perform automatic signature
155155
verification.</p>
156156

157-
<p class="caution"><strong>Recommendation</strong>: Make sure to obfuscate the
157+
<p class="caution"><strong>Recommendation</strong>: Make sure to obfuscate the
158158
code in your application before you publish it. For more information, see
159-
<a href="{@docRoot}google/play/billing/billing_best_practices.html">Security
159+
<a href="{@docRoot}google/play/billing/billing_best_practices.html">Security
160160
and Design</a>.</p>
161161

162162
<h2 id="migration">Migration Considerations</h2>
163-
<p>If you have an existing In-app Billing implementation that uses Version 2 or
164-
earlier, it is strongly recommended that you migrate to <a href="{@docRoot}google/play/billing/api.html">In-app Billing Version 3</a> at your earliest convenience.</p>
163+
<p>The In-app Billing Version 2 API is deprecated and will be discontinued in January 2015.
164+
If you have an existing In-app Billing implementation that uses API Version 2 or
165+
earlier, you must migrate to <a href="{@docRoot}google/play/billing/api.html">In-app Billing Version
166+
3</a>.</p>
165167

166168
<p>If you have published apps selling in-app products, note that:</p>
167169
<ul>
168-
<li>Managed items and subscriptions that you have previously defined in the Developer Console will
170+
<li>Managed items and subscriptions that you have previously defined in the Developer Console will
169171
work with Version 3 as before.</li>
170-
<li>Unmanaged items that you have defined for existing applications will be
171-
treated as managed products if you make a purchase request for these items using
172-
the Version 3 API. You do not need to create a new product entry in Developer
173-
Console for these items, and you can use the same product IDs to purchase these
174-
items. They will still continue to be treated as unmanaged items if you make a
175-
purchase request for them using the Version 2 or earlier API.
172+
<li>Unmanaged items that you have defined for existing applications will be
173+
treated as managed products if you make a purchase request for these items using
174+
the Version 3 API. You do not need to create a new product entry in Developer
175+
Console for these items, and you can use the same product IDs to purchase these
176+
items. They will still continue to be treated as unmanaged items if you make a
177+
purchase request for them using the Version 2 or earlier API.
176178
</ul>
177179

178180

0 commit comments

Comments
 (0)