Donate to e Foundation | Murena handsets with /e/OS | Own a part of Murena! Learn more

Commit 4434744f authored by Kevin Hufnagle's avatar Kevin Hufnagle
Browse files

docs: Updated Billing API documentation (for Project Nickel). 

Added references to Project Nickel (rounded and "relevant" pricing
for each country where an Android app is published) within overview
and reference pages. Also added discussion of pricing templates and
the associated operations in the "administration" page.

Finally, completed minor touch-ups to billing administration section
(removed unhelpful links, updated screen captures).

Bug: 28204935
Change-Id: I917d06876d1525f24cb26a55a39cd64ae479b8f8
parent 718d27d8

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

+483 −107

File changed.

Preview size limit exceeded, changes collapsed.

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

+9 −1
Original line number Diff line number Diff line
@@ -122,7 +122,7 @@ the product types supported by In-app Billing Version 3</a>.</p> 


<h2 id="console">Google Play Developer Console</h2>

<p>The Developer Console is where you can publish your

In-app Billing application, and manage the various in-app products that are

In-app Billing application and manage the various in-app products that are

available for purchase from your application.</p>

<p>You can create a product list of

digital goods that are associated with your application, including items for
@@ -130,6 +130,14 @@ one-time purchase and recurring subscriptions. For each item, you can define 
information such as the item’s unique product ID (also called its SKU), product

type, pricing, description, and how Google Play should handle and track

purchases for that product.</p>

<p>If you sell several of your apps or in-app products at the same price, you

can add <em>pricing templates</em> to manage these price points from a

centralized location. When using pricing templates, you can include the local

tax within the prices you provide, or you can provide prices and have the system

add local taxes to these prices. You can make changes to the prices in your

templates&mdash;such as refreshing the exchange rates for certain

countries&mdash;and your changes are applied to the apps and in-app products

that you link to the template.</p>

<p>You can also create test accounts to authorize

access for testing applications that are unpublished.</p>

<p>To learn how to use the Developer Console to configure your in-app

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

+2 −1
Original line number Diff line number Diff line
@@ -139,7 +139,8 @@ does not include tax.</td> 
    <td>{@code price_amount_micros}</td>

    <td>Price in micro-units, where 1,000,000 micro-units equal one unit of the

    currency. For example, if {@code price} is {@code "€7.99"}, {@code

    price_amount_micros} is {@code "7990000"}.</td>

    price_amount_micros} is {@code "7990000"}. This value represents the

    localized, rounded price for a particular currency.</td>

  </tr>

  <tr>

    <td>{@code price_currency_code}</td>

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

+12 −22
Original line number Diff line number Diff line
@@ -14,6 +14,16 @@ and features, and more. You can use In-app Billing to sell products as</p> 
<div class="sidebox">

  <h2><strong>New in In-App Billing</strong></h2>

  <ul>

  <li><strong>Rounded Pricing</strong>&mdash;After developers set prices for the

    apps and in-app products that they distribute to multiple countries, the

    system automatically sets local prices for different currencies using

    today’s exchange rates and country-specific pricing patterns. To satisfy

    specific pricing needs, developers can also adjust these prices manually.</li>

  <li><strong>Pricing Templates</strong>&mdash;Developers can add pricing

    templates and link these templates to app prices or in-app product prices.

    These templates include local prices across all markets. By using a

    template, developers can apply price changes in bulk to all items linked to

    that template.</li>

  <li><strong>In-app Promotions</strong>&mdash;Developers can create promo codes

    which users can redeem for content or features.</li>

  <li><strong>Prorated Subscription Prices</strong>&mdash;Content providers can
@@ -29,33 +39,13 @@ and features, and more. You can use In-app Billing to sell products as</p> 
  <li><strong>Subscription Upgrade/Downgrade</strong>&mdash;A user can

    subscribe to a higher or lower tier of subscription while their current

    subscription is active. The old subscription is canceled, and the unused

    portion is applied on a pro-rated basis to the new subscription.</li>

    portion is applied on a prorated basis to the new subscription.</li>

  <li><strong>Manual Subscription Renewal</strong>&mdash;A user can purchase

    a subscription at the current rate while their existing subscription is

    still active. The existing subscription is extended by the appropriate

    period.</li>

  <li><strong>IAB Sandbox</strong>&mdash;The In-app Billing Sandbox now supports

    testing subscription purchases.</li>

  <li><strong>As of January 2015, the In-App Billing v2 API is shut down.

    If your app is still using In-app Billing

    v2, please migrate to the v3 API as soon as possible.</strong></li>

  <li><strong>Seasonal subscriptions</strong>&mdash;You can now set up a

    recurring <a href="billing_subscriptions.html#user-billing">seasonal

    subscription</a> that starts and ends on the same date each year (for

    example, a sports subscription that starts every September 1 and ends every

    April 10).</li>

  <li><strong>Deferred subscription billing</strong>&mdash;You can

    <a href="billing_subscriptions.html#deferred-billing">defer</a> a

    subscriber's next billing date until the date you choose. The user still has

    access to the content but is not charged during the deferral period.</li>

  <li><strong>Weekly subscriptions</strong>&mdash;You can now set up a

    recurring <a href="billing_subscriptions.html#user-billing">subscription</a>

    that bills the user every week.</li>

  <li><strong>Payment grace period</strong>&mdash;If a subscriber misses a

    subscription payment due to an expired credit card, you can define a

    <a href="billing_subscriptions.html#grace-period">grace period</a>

    to the continue the subscription until payment is successful.</li>



 </ul>

</div>

</div>
@@ -101,5 +91,5 @@ Products</a> training class.</p> 
    implementation.</dd>

  <dt><strong><a href="{@docRoot}google/play/billing/billing_admin.html">Administering

  In-app Billing</a></strong></dt>

    <dd>Learn how to set up your product list, register test accounts, and handle refunds.</dd>

    <dd>Learn how to set up your product list, add pricing templates, register test accounts, and handle refunds.</dd>

</dl>

docs/html/images/in-app-billing/add_new_product.png

0 → 100644
+89.8 KiB
Loading image diff...