Androidアプリ内課金：モバイルアプリケーションからサーバーの検証とテストまで

みなさんこんにちは！ 最近、請求書をサービスに統合するタスクに直面しました。当初はタスクがかなり単純に見えましたが、その結果、1か月にわたる時間の研究、神経質、発見がありました。 その結果、膨大な量のドキュメントがあるにも関わらず、Googleでの単純なクエリではすべてが見つかるわけではないという理解が得られました（また、ドキュメントによってはまったくのナンセンスがあります。



その結果、Google Playからの課金がサービスに正常に統合され、サーバー側での購入とサブスクリプションの検証が機能します。 面白くなった人-ようこそ、kat：ここでは、Google Play管理コンソールでの購入の登録から、バックエンドでのサブスクリプションの操作まで、すべての詳細な説明があります。



患者について簡単に説明します。 Google Play In-App Billing V3とクラウドベースのAndroid Publisher APIを分解します 。これらは、購入の検証とサブスクリプションでの作業の両方に役立ちます。 また、 Google Play Management Consoleをバイパスしません-それも必要です。

なぜこれが必要なのですか？

クライアントサーバーアプリケーションを使用している場合、サーバーで検証を行わないと、著作権侵害に対する保護を提供できません。 また、サーバー上の購入のデジタル署名を簡単に検証できますが、Android Publisher APIメソッドへのリクエストにはいくつかの追加機能があります。 まず、ユーザーのデバイスを参照せずにいつでも購入またはサブスクリプションに関する情報を取得できます。次に、サブスクリプションに関するより詳細な情報を取得して管理（キャンセル、延期など）できます。 たとえば、次の支払いの日付をGoogle Playミュージックのように表示する場合：









その後、Android Publisher APIをリクエストすることでのみ取得できます。



請求を統合するときの完全なフローは次のとおりです。



1. Google Playコンソールでアプリケーションを登録し、買い物リストを作成します。

2.モバイルアプリケーションでのAndroidアプリ内課金の統合。

3.サーバーでの購入とサブスクリプションの検証。

パート1：アプリケーションをGoogle Playコンソールに登録し、買い物リストを作成する

Google Play管理コンソールにアクセスし （アカウントをお持ちでない場合は25ドルで登録してください）、最初のアプリケーションを作成してください。 アプリケーションが既に登録されている瞬間から始めましょう。



1.アプリケーションが以前にダウンロードされていない場合-リリース証明書でアプリケーションに署名し、クローズドアルファまたはベータテストにアップロードします。

すべてのアプリケーション/アプリケーション/ APK /アルファ（ベータ）テスト



2.テストリストを作成し、選択したテストの種類（AlphaまたはBeta）に対してアクティブにします。



3.このリストに請求によりテストされるGoogleアカウントのメールアカウントを追加します。 たとえば、デバイスでGoogle Playに入力した個人のメール。







下部にオプトインURLリンクがあります。このリンクは、課金をテストする（および自分自身も）テストに同意するすべてのユーザーに渡す必要があります。 これがないと、アルファ版またはベータ版で購入できません。



4. [設定/アカウントの詳細 ]タブに移動して、 [ ライセンス テスト ]セクションを見つけ、[ テストアクセスのあるGmailアカウント]フィールドに、前の手順と同じメールを追加します。 これで、これらのアカウントからの購入をテストできます-無料です。

支払い方法を追加する必要があります-購入ダイアログ自体にこれが必要になりますが、アプリケーションで購入ボタンがすぐに表示される場合、これはテスト購入であることが示されます。



5.テスト購入をアプリケーションに追加します。 これを行うには、[ すべてのアプリケーション] / [ アプリケーション ] / [ アプリ内製品 ]に移動し、[ 新しい製品を追加 ] をクリックします。 1つの購入（管理製品）と1つのサブスクリプション（サブスクリプション）を追加できます。 製品IDとして、 com.example.myapp_testing_inapp1とcom.example.myapp_testing_subs1のスタイルの何かをそれぞれ購入とサブスクリプションに使用できます。少なくとも名前と説明を追加し、製品の価格を設定し、利用可能な国を選択する必要があります（すべて選択できます） ）、購読するには、期間も選択し、製品をアクティブ化します。 その後、しばらくすると利用可能になります。



重要：アプリケーションを公開する必要があります（少なくともアルファ版またはベータ版で）。そうしないと 、購入できません 。



簡単に買い物の種類



1.管理対象製品（inapp）-1回限りの購入。 購入後、ユーザーは永久に購入の所有者になりますが、そのような購入を「使用」（消費）することもできます-たとえば、ボーナスを獲得するためです。 使用後、購入は表示されなくなり、再度作成できます。



2.サブスクリプション（subs）-サブスクリプション。 アクティベーション後、ユーザーは一定の期間に一定の回数請求されます。 ユーザーが支払う間、サブスクリプションはアクティブです。



購入が有効化されると、モバイルアプリケーションでそれらに関する情報（名前、説明、現地通貨での価格）を直接取得し、購入することもできます。

パート2：Androidアプリ内課金をモバイルアプリケーションに統合する

公式 文書



まず、アプリケーションで課金サービスを操作するためにいくつかの操作を実行します。



IInAppBillingService.aidlファイルをプロジェクトにコピーします。





マニフェストにアクセス許可を追加します。

<uses-permission android:name="com.android.vending.BILLING" />
      
      

        
        
        
      

    
        
        
        
      
      

        
        
        
      

    
     

そして、購入する場所で、サービスに接続します。

  IInAppBillingService inAppBillingService; ServiceConnection serviceConnection = new ServiceConnection() { @Override public void onServiceConnected(ComponentName name, IBinder service) { inAppBillingService = IInAppBillingService.Stub.asInterface(service); } @Override public void onServiceDisconnected(ComponentName name) { inAppBillingService = null; } }; @Override public void onCreate(Bundle savedInstanceState) { super.onCreate(savedInstanceState); Intent serviceIntent = new Intent("com.android.vending.billing.InAppBillingService.BIND"); serviceIntent.setPackage("com.android.vending"); bindService(serviceIntent, serviceConnection, Context.BIND_AUTO_CREATE); ... } @Override public void onDestroy() { super.onDestroy(); if (serviceConnection != null) { unbindService(serviceConnection); } }
      
      

        
        
        
      

    
        
        
        
      
      

        
        
        
      

    
     

これで、購入の作業を開始できます。 サービスから購入した商品のリストと説明と価格を取得します。

  class InAppProduct { public String productId; public String storeName; public String storeDescription; public String price; public boolean isSubscription; public int priceAmountMicros; public String currencyIsoCode; public String getSku() { return productId; } String getType() { return isSubscription ? "subs" : "inapp"; } } List<InAppProduct> getInAppPurchases(String type, String... productIds) throws Exception { ArrayList<String> skuList = new ArrayList<>(Arrays.asList(productIds)); Bundle query = new Bundle(); query.putStringArrayList("ITEM_ID_LIST", skuList); Bundle skuDetails = inAppBillingService.getSkuDetails( 3, context.getPackageName(), type, query); ArrayList<String> responseList = skuDetails.getStringArrayList("DETAILS_LIST"); List<InAppProduct> result = new ArrayList<>(); for (String responseItem : responseList) { JSONObject jsonObject = new JSONObject(responseItem); InAppProduct product = new InAppProduct(); // "com.example.myapp_testing_inapp1" product.productId = jsonObject.getString("productId"); //  product.storeName = jsonObject.getString("title"); //   product.storeDescription = jsonObject.getString("description"); // "0.99USD" product.price = jsonObject.getString("price"); // "true/false" product.isSubscription = jsonObject.getString("type").equals("subs"); // "990000" =  x 1000000 product.priceAmountMicros = Integer.parseInt(jsonObject.getString("price_amount_micros")); // USD product.currencyIsoCode = jsonObject.getString("price_currency_code"); result.add(product); } return result; }
      
      

        
        
        
      

    
        
        
        
      
      

        
        
        
      

    
     

この方法を使用すると、利用可能な購入に関するデータをダウンロードできます。

  //   List<InAppProduct> purchases = getInAppPurchases("inapp", "com.example.myapp_testing_inapp1"); //   List<InAppProduct> subscriptions = getInAppPurchases("subs", "com.example.myapp_testing_subs1");
      
      

        
        
        
      

    
        
        
        
      
      

        
        
        
      

    
     

これで、買い物リストとそれらに関する情報をアプリケーションから直接取得できます。 価格は、ユーザーが支払う通貨で示されます。 プロセスのサービスはGoogleサーバーからデータをダウンロードできるため、これらのメソッドはバックグラウンドスレッドで呼び出す必要があります。 このデータの使用方法は、お客様の裁量によります。 受け取ったリストから価格と製品名を表示するか、アプリケーションリソースで名前と価格を指定できます。



今こそ何かを買う時です！

  private static final int REQUEST_CODE_BUY = 1234; public static final int BILLING_RESPONSE_RESULT_OK = 0; public static final int BILLING_RESPONSE_RESULT_USER_CANCELED = 1; public static final int BILLING_RESPONSE_RESULT_SERVICE_UNAVAILABLE = 2; public static final int BILLING_RESPONSE_RESULT_BILLING_UNAVAILABLE = 3; public static final int BILLING_RESPONSE_RESULT_ITEM_UNAVAILABLE = 4; public static final int BILLING_RESPONSE_RESULT_DEVELOPER_ERROR = 5; public static final int BILLING_RESPONSE_RESULT_ERROR = 6; public static final int BILLING_RESPONSE_RESULT_ITEM_ALREADY_OWNED = 7; public static final int BILLING_RESPONSE_RESULT_ITEM_NOT_OWNED = 8; public static final int PURCHASE_STATUS_PURCHASED = 0; public static final int PURCHASE_STATUS_CANCELLED = 1; public static final int PURCHASE_STATUS_REFUNDED = 2; public void purchaseProduct(InAppProduct product) throws Exception { String sku = product.getSku(); String type = product.getType(); //       //         String developerPayload = "12345"; Bundle buyIntentBundle = inAppBillingService.getBuyIntent( 3, context.getPackageName(), sku, type, developerPayload); PendingIntent pendingIntent = buyIntentBundle.getParcelable("BUY_INTENT"); startIntentSenderForResult(pendingIntent.getIntentSender(), REQUEST_CODE_BUY, new Intent(), Integer.valueOf(0), Integer.valueOf(0), Integer.valueOf(0), null); } @Override public void onActivityResult(int requestCode, int resultCode, Intent data) { super.onActivityResult(requestCode, resultCode, data); if (requestCode == REQUEST_CODE_BUY) { int responseCode = data.getIntExtra("RESPONSE_CODE", -1); if (responseCode == BILLING_RESPONSE_RESULT_OK) { String purchaseData = data.getStringExtra("INAPP_PURCHASE_DATA"); String dataSignature = data.getStringExtra("INAPP_DATA_SIGNATURE"); //     readPurchase(purchaseData); } else { //   } } } private void readPurchase(String purchaseData) { try { JSONObject jsonObject = new JSONObject(purchaseData); //  ,     null String orderId = jsonObject.optString("orderId"); // "com.example.myapp" String packageName = jsonObject.getString("packageName"); // "com.example.myapp_testing_inapp1" String productId = jsonObject.getString("productId"); // unix-timestamp   long purchaseTime = jsonObject.getLong("purchaseTime"); // PURCHASE_STATUS_PURCHASED // PURCHASE_STATUS_CANCELLED // PURCHASE_STATUS_REFUNDED int purchaseState = jsonObject.getInt("purchaseState"); // "12345" String developerPayload = jsonObject.optString("developerPayload"); //  ,      //      String purchaseToken = jsonObject.getString("purchaseToken"); //     ... } catch (Exception e) { ... } }
      
      

        
        
        
      

    
        
        
        
      
      

        
        
        
      

    
     

dataSignatureについても言いたいと思います。 検証の例はここにありますが、購入がサーバーで検証される場合、これは追加の手順です。



すでに完了した購入に関する情報を取得することも役立つ場合があります。

  private void readMyPurchases() throws Exception { readMyPurchases("inapp"); //   readMyPurchases("subs"); //   } private void readMyPurchases(String type) throws Exception { String continuationToken = null; do { Bundle result = inAppBillingService.getPurchases( 3, context.getPackageName(), type, continuationToken); if (result.getInt("RESPONSE_CODE", -1) != 0) { throw new Exception("Invalid response code"); } List<String> responseList = result.getStringArrayList("INAPP_PURCHASE_DATA_LIST"); for (String purchaseData : responseList) { readPurchase(purchaseData); } continuationToken = result.getString("INAPP_CONTINUATION_TOKEN"); } while (continuationToken != null); }
      
      

        
        
        
      

    
        
        
        
      
      

        
        
        
      

    
     

これもバックグラウンドスレッドから実行する必要があります。 これにより、以前に行った購入のリストが返されます。 アクティブなサブスクリプションのリストを取得することもできます。



次のステップは、購入を使用することです。 これは、あなたが購入のためにユーザーに何かを蓄積することを意味し、購入自体は消えて、再び購入をするそのような機会を与えます。

  private void consumePurchase(String purchaseToken) throws Exception { int result = inAppBillingService.consumePurchase(GooglePlayBillingConstants.API_VERSION, context.getPackageName(), purchaseToken); if (result == GooglePlayBillingConstants.BILLING_RESPONSE_RESULT_OK) { //   ... } else { //   ... } }
      
      

        
        
        
      

    
        
        
        
      
      

        
        
        
      

    
     

その後、購入データを読み取ることができなくなります-getPurchases（）を介して利用できなくなります。



ここでは、デバイス側で直接請求を使用する可能性があります。

パート3：サーバーでの購入とサブスクリプションの検証

これは、私が最も長く戦った中で最も興味深い部分です。 すべての例はJavaで作成され、Googleはサービスを操作するための既製のライブラリを提供します。



他の言語のライブラリもここで検索できます 。 Google Publisher APIのドキュメントはこちらです。現在のタスクのコンテキストでは、 Purchases.productsとPurchases.subscriptionsに興味があります。



実際、私が遭遇した主な問題は、認証方法の説明です 。 まさに説明でさえ、それは馬の第五脚のように見えますが、問題はそれが機能しないことではなく、それが私たちの仕事にとって根本的に間違っていることです。 私に石を投げてはいけないという鑑定家への要求：OAuthはクライアントリソースで動作するように設計されています。この場合、バックエンドサービスは独自のアプリケーションから請求データを要求します。



そして、ここでIAM（Identy Access Management）が助けになります。 Google Cloud Consoleでプロジェクトを作成し、[ 認証情報 ]タブに移動して、[ 認証情報の作成 ] → [ サービスアカウントキー ]を選択する必要があります 。







写真に示すようにデータを入力します。

サービスアカウント：新しいサービスアカウント

サービスアカウント名：選択のための名前

役割：選択しないでください、彼女は今は必要ありません

キータイプ：JSON

作成をクリックします 。 サービスアカウントに役割がありませんという警告とともにウィンドウがポップアップします 。 同意して、 ロールなしで作成を選択します。 アカウントの認証用のデータを含むJSONファイルを自動的にダウンロードします。 このファイルを保存します-将来、Googleサービスにログインするために必要になります。





プロジェクトの[ 資格情報 ]タブに戻り、以下のサービスアカウントキーのリストを確認します。 右側にある[サービスアカウントの管理 ]ボタンをクリックします。クリックすると、以下が表示されます







myaccount@project-name.iam.gserviceaccount.com-これはアカウントのIDです。 それをコピーして、 Google Play Developer Console→設定→ユーザーアカウントと権利に移動し 、 新しいユーザーを招待を選択します 。



データを入力します。







アカウントIDを[ メール]フィールドに貼り付け、アプリケーションを追加して、 [財務レポートの表示]の前にチェックマークを付けます 。



[招待状を送信]をクリックします。 これで、JSONファイルを承認とGoogle APIに使用して、アプリケーションの購入とサブスクリプションのデータにアクセスできます。



次のステップは、プロジェクトのGoogle Play Developer APIをアクティブにすることです 。 Google Developer Console→ライブラリに移動し、 Google Play Developer APIを探します 。 それを開き、 「有効化」をクリックします。







最後のステップは、 Google Play Developer Console-> Settings-> API Accessに移動することです。







リストからプロジェクトを見つけ（上の図ではGoogle Play Android Developerですが、プロジェクトの名前が表示されているはずです）、[ リンク ]をクリックします。







サーバー側の開発に移りましょう



IAMアカウントのプライベートデータとともにJSONファイルを保存する方法は、お客様の裁量に任されます。 Google Play Developer APIをプロジェクト（ mavencentral ）にインポートし、チェックを実装します。



購入データは、アプリケーションからサーバーに送信する必要があります。 サーバーでの検証の実際の実装は次のようになります。

 import com.google.api.client.googleapis.auth.oauth2.GoogleCredential; import com.google.api.client.googleapis.javanet.GoogleNetHttpTransport; import com.google.api.client.http.HttpTransport; import com.google.api.client.json.jackson2.JacksonFactory; import com.google.api.services.androidpublisher.AndroidPublisher; import com.google.api.services.androidpublisher.AndroidPublisherScopes; import com.google.api.services.androidpublisher.model.ProductPurchase; import com.google.api.services.androidpublisher.model.SubscriptionPurchase; import java... public class GooglePlayService { private final Map<String, AndroidPublisher> androidPublishers = new HashMap<>(); private String readCredentialsJson(String packageName) { //      JSON-    ... } private AndroidPublisher getPublisher(String packageName) throws Exception { if (!androidPublishers.containsKey(packageName)) { String credentialsJson = readCredentialsJson(packageName); InputStream inputStream = new ByteArrayInputStream( credentialsJson.getBytes(StandardCharsets.UTF_8)); HttpTransport transport = GoogleNetHttpTransport.newTrustedTransport(); GoogleCredential credential = GoogleCredential.fromStream(inputStream) .createScoped(Collections.singleton( AndroidPublisherScopes.ANDROIDPUBLISHER)); AndroidPublisher.Builder builder = new AndroidPublisher.Builder( transport, JacksonFactory.getDefaultInstance(), credential); AndroidPublisher androidPublisher = builder.build(); androidPublishers.put(packageName, androidPublisher); } return androidPublishers.get(packageName); } public ProductPurchase getPurchase(String packageName, String productId, String token) throws Exception { AndroidPublisher publisher = getPublisher(packageName); AndroidPublisher.Purchases.Products.Get get = publisher .purchases().products().get(packageName, productId, token); return get.execute(); } public SubscriptionPurchase getSubscription(String packageName, String productId, String token) throws Exception { AndroidPublisher publisher = getPublisher(packageName); AndroidPublisher.Purchases.Subscriptions.Get get = publisher .purchases().subscriptions().get(packageName, productId, token); return get.execute(); } }
      
      

        
        
        
      

    
        
        
        
      
      

        
        
        
      

    
     

したがって、Googleから購入に関するデータを直接受け取る機会が得られるため、署名を確認する必要がなくなります。 さらに、サブスクリプションの場合、モバイルアプリケーションのIInAppBilligServiceから直接取得するよりもはるかに多くの情報を取得できます。



リクエストパラメータとして必要なもの：

• packageName-アプリケーションパッケージ名（com.example.myapp）
• productId-製品識別子（com.example.myapp_testing_inapp1）
• token-モバイルアプリケーションで受け取った一意の購入トークン：
  
  
  
  

   String purchaseToken = jsonObject.getString("purchaseToken");
        
        
  
          
          
          
        
  
      
          
          
          
        
        
  
          
          
          
        
  
      
       

ProductPurchaseおよびSubscriptionPurchaseの詳細はドキュメントに記載されていますが、それらについては詳しく説明しません。

結論の代わりに

ドキュメントにアクセス目的でIAMを使用することについての言葉がないため、最初は、請求書をサービスに統合する一見単純なタスクが、ドキュメント、グーグル、および無力（OAuth、 あなたは美しい ）の旅に変わりました。 真剣に、彼らはあなたのブラウザでクックアップされたURLを手に入れ、プロジェクト管理コンソールでリダイレクトの起源を追加し、あなたが手でサーバーに転送する必要があるワンタイムトークンを取得し、OAuthフロー全体を使用することを提供します請求データにアクセスします。 リフレッシュトークンを使用する時間がない場合は、手で新しいトークンを取得する必要があることは言うまでもありません。 同意する-これは、人間の介入なしで機能するバックエンドサービスの完全なナンセンスのように聞こえます。



この記事が誰かが少しの時間と神経を節約するのに役立つことを願っています。