GS2-Money2 マスターデータリファレンス

マスターデータのフォーマットと インポートする各種モデルのリファレンス

マスターデータのフォーマット

{
  "version": "2024-06-20",
  "storeContentModels": [
    {
      "name": "[string]ストアコンテンツモデル名",
      "metadata": "[string?]メタデータ",
      "appleAppStore": {
        "productId": "[string?]プロダクトID"
      },
      "googlePlay": {
        "productId": "[string?]プロダクトID"
      }
    }
  ],
  "storeSubscriptionContentModels": [
    {
      "name": "[string]定期課金ストアコンテンツモデル名",
      "metadata": "[string?]メタデータ",
      "scheduleNamespaceId": "[string]サブスクリプション期間を連動させる GS2-Schedule のネームスペースGRN",
      "triggerName": "[string]サブスクリプション期間を反映するトリガー名",
      "triggerExtendMode": "[string enum]サブスクリプション期間をトリガーに反映する時のモード",
      "rollupHour": "[int]期限が切れる日、契約期間を日またぎの時刻まで延長する場合日跨ぎの時刻(UTC)",
      "reallocateSpanDays": "[int]サブスクリプションの契約情報を他のユーザーに割り当て可能となる期間(日)",
      "appleAppStore": {
        "subscriptionGroupIdentifier": "[string?]サブスクリプショングループID"
      },
      "googlePlay": {
        "productId": "[string?]プロダクトID"
      }
    }
  ]
}
有効化条件必須デフォルト値の制限説明
versionstring
2024-06-20マスターデータのフォーマットバージョン
storeContentModelsList<StoreContentModel>~ 1000 itemsストアプラットフォームのコンテンツ
storeSubscriptionContentModelsList<StoreSubscriptionContentModel>~ 1000 itemsストアプラットフォームの定期課金コンテンツ

モデル

StoreContentModel

ストアプラットフォームのコンテンツ

有効化条件必須デフォルト値の制限説明
storeContentModelIdstring
✓*
~ 1024文字コンテンツモデル GRN
※ サーバー側で自動的に設定
namestring
~ 128文字ストアコンテンツモデル名
metadatastring~ 1024文字メタデータ
メタデータには任意の値を設定できます。
これらの値は GS2 の動作には影響しないため、ゲーム内で利用する情報の保存先として使用できます。
appleAppStoreAppleAppStoreContentApple AppStore のコンテンツ
googlePlayGooglePlayContentGoogle Play のコンテンツ

AppleAppStoreContent

Apple AppStore のコンテンツ

有効化条件必須デフォルト値の制限説明
productIdstring~ 1024文字プロダクトID

GooglePlayContent

Google Play のコンテンツ

有効化条件必須デフォルト値の制限説明
productIdstring~ 1024文字プロダクトID

StoreSubscriptionContentModel

ストアプラットフォームの定期課金コンテンツ

有効化条件必須デフォルト値の制限説明
storeSubscriptionContentModelIdstring
✓*
~ 1024文字期間課金コンテンツモデル GRN
※ サーバー側で自動的に設定
namestring
~ 128文字定期課金ストアコンテンツモデル名
metadatastring~ 1024文字メタデータ
scheduleNamespaceIdstring
~ 1024文字サブスクリプション期間を連動させる GS2-Schedule のネームスペース GRN
triggerNamestring
~ 128文字サブスクリプション期間を反映するトリガー名
triggerExtendMode文字列列挙型
enum {
  “just”,
  “rollupHour”
}
“just”サブスクリプション期間をトリガーに反映する時のモード
定義説明
“just”そのままサブスクリプション期間を反映
“rollupHour”次の日跨ぎ時刻まで延長してサブスクリプション期間を反映
rollupHourint{triggerExtendMode} == “rollupHour”
✓*
00 ~ 23期限が切れる日、契約期間を日またぎの時刻まで延長する場合日跨ぎの時刻(UTC)
※ triggerExtendMode が “rollupHour” であれば 必須
reallocateSpanDaysint
300 ~ 365サブスクリプションの契約情報を他のユーザーに割り当て可能となる期間(日)
appleAppStoreAppleAppStoreSubscriptionContentApple AppStore のコンテンツ
googlePlayGooglePlaySubscriptionContentGoogle Play のコンテンツ

AppleAppStoreSubscriptionContent

Apple AppStore の期間課金コンテンツ

有効化条件必須デフォルト値の制限説明
subscriptionGroupIdentifierstring~ 64文字サブスクリプショングループID

GooglePlaySubscriptionContent

Google Play の期間課金コンテンツ

有効化条件必須デフォルト値の制限説明
productIdstring~ 1024文字プロダクトID