このドキュメントでは、Google Play Billing Library 5 または 6 から移行する方法について説明します。 Google Play Billing Library 7 の詳細を確認し、新しいオプションの 購読関連の機能も備えています
バージョン 7.0.0 の変更点をすべて網羅したリストについては、リリース メモをご覧ください。
概要
Google Play Billing Library 7 で、 既存の定期購読機能に アクセスできるようになりましたこれらのオプションの改善点は 分割払いのサポートを追加し 前払い定期購入の保留中の購入に関するサポート。
下位互換性のある Play Billing Library のアップグレード
新しい Google Play Billing Library 7 API はすべてオプションです。 更新するために API の変更を実装する必要はありません。
移行するには、API リファレンスを更新して削除する必要があります 特定の API をアプリから収集できます。詳しくは、 移行ガイドを参照してください
PBL 5 から PBL 7 へのアップグレード
以降のセクションでは、PBL 5 から PBL 7 にアップグレードする方法について説明します。
Google Play Billing Library を更新する
Play Billing Library の依存関係バージョンを
アプリの build.gradle ファイルに追加します。
dependencies {
def billingVersion = 7.0.0
implementation "com.android.billingclient:billing:$billingVersion"
}
次に、以下のセクションの説明に沿って API リファレンスを更新します。
ユーザーの定期購入を変更する
Play Billing Library 5 以前を使用ProrationMode
ユーザーの定期購入に変更（アップグレードなど）を適用する
可能性があります。この API は削除されました。後継機種です。
ReplacementMode。
定期購入の価格変更を処理する
以前に非推奨となった launchPriceConfirmationFlow API は削除されました。
代替の方法については、価格変更ガイドをご覧ください。
定期購入関連の API の変更を処理する
以前に非推奨になった API setOldSkuPurchaseToken、
setReplaceProrationMode、setReplaceSkusProrationMode が削除されました。
setOldSkuPurchaseTokenをsetOldPurchaseTokenに更新します。setReplaceProrationModeを次に更新:setSubscriptionReplacementMode。setReplaceSkusProrationModeを次に更新:setSubscriptionReplacementMode。
Play Billing Library のエラーに対応する
新しい NETWORK_ERROR コードは、ネットワーク接続に問題があることを示します。
ユーザーのデバイスと Google Play システムの間のやり取り。
コード SERVICE_TIMEOUT と SERVICE_UNAVAILABLE も更新されました。
詳細については、次をご覧ください: BillingResult のレスポンス コードを処理します。
保留中のトランザクションを処理する
Play Billing Library では、保留中の購入の注文 ID は作成されなくなります。
このような購入では、購入の移動後に注文 ID が入力されます。
PURCHASED 状態にします。統合において、
トランザクションが完了した後にのみ注文 ID が送信される。引き続き
購入トークンを記録用に作成する必要があります。
保留中の購入の処理について詳しくは、 Play Billing Library の統合ガイドと 購入ライフサイクル管理ガイドをご覧ください。
削除された代替の課金システムの API を処理する
BillingClient.Builder.enableAlternativeBilling を削除しました。
AlternativeBillingListener,
および AlternativeChoiceDetails。
デベロッパーは UserChoiceBillingListener で BillingClient.Builder.enableUserChoiceBilling() を使用する必要があります
および UserChoiceDetails
リスナー コールバック内で指定してください。
このアップデートは非推奨の API の名称変更であり、動作の変更はありません。
オプションの変更
PBL 7 には 2 つの新しいオプションの API が含まれています。
プリペイド プランの保留中の購入のサポート
詳しくは、定期購入と保留中の取引の処理に関するガイドをご覧ください。
仮想分割払いの定期購入
分割払いの定期購入の統合に関するガイドをご覧ください。
PBL 6 から PBL 7 へのアップグレード
以降のセクションでは、PBL 6 から PBL 7 にアップグレードする方法について説明します。
Google Play Billing Library を更新する
Play Billing Library の依存関係バージョンを
アプリの build.gradle ファイルに追加します。
dependencies {
def billingVersion = 7.0.0
implementation "com.android.billingclient:billing:$billingVersion"
}
次に、以下のセクションの説明に沿って API リファレンスを更新します。
定期購入関連の API の変更を処理する
以前に非推奨になった API setOldSkuPurchaseToken、
setReplaceProrationMode、setReplaceSkusProrationMode が削除されました。
setOldSkuPurchaseTokenをsetOldPurchaseTokenに更新します。setReplaceProrationModeを次に更新:setSubscriptionReplacementMode。setReplaceSkusProrationModeを次に更新:setSubscriptionReplacementMode。
削除された代替の課金システムの API を処理する
BillingClient.Builder.enableAlternativeBilling を削除しました。
AlternativeBillingListener
および AlternativeChoiceDetails。
デベロッパーは UserChoiceBillingListener で BillingClient.Builder.enableUserChoiceBilling() を使用する必要があります
および UserChoiceDetails
リスナー コールバック内で指定してください。
オプションの変更
PBL 7 には 2 つの新しいオプションの API が含まれています。
プリペイド プランの保留中の購入のサポート
詳しくは、定期購入と保留中の取引の処理に関するガイドをご覧ください。
仮想分割払いの定期購入
詳しくは、分割払いの定期購入の統合に関するガイドをご覧ください。 をご覧ください。