GS2-AdReward Deploy/CDK リファレンス

GS2-Deployのスタックを作成する際に使用するテンプレートのフォーマットと、CDKによる各種言語のテンプレート出力の実装例

エンティティ

Deploy処理で操作の対象となるリソース

Namespace

ネームスペース

ネームスペースは、一つのプロジェクト内で同じサービスを異なる用途で複数利用するためのエンティティです。
GS2 の各サービスはネームスペース単位で管理されます。ネームスペースが異なれば、同じサービスでも完全に独立したデータ空間として扱われます。

そのため、各サービスの利用を開始するにあたってネームスペースを作成する必要があります。

Request

リソースの生成・更新リクエスト

	型	必須	値の制限	説明
name	string	✓	~ 128文字	ネームスペース名ネームスペース固有の名前。英数字および -(ハイフン) _(アンダースコア) .(ピリオド)で指定します。
description	string		~ 1024文字	説明文
transactionSettingV2	TransactionSettingV2			トランザクション設定（V2）このネームスペースが発行するトランザクションをどのように実行するかを決める設定です。設定する項目は、実行に使用する GS2-Distributor のネームスペースと、トランザクションに含まれるアクションを 1 件ずつ実行して先に実行されたアクションの結果を後続のアクションから使えるようにするか、まとめて同時に実行してレスポンスタイムを短くするか、の 2 つだけです。新しく作成するネームスペースではこちらを設定してください。これに置き換えられて非推奨となった `transactionSetting` は、こちらが設定されていない間だけ使用されます。
admob	AdMob			AdMob の設定 AdMob に関連する広告の設定やパラメータを管理します。
unityAd	UnityAd			Unity Ads の設定 Unity Ads に関連する広告の設定やパラメータを管理します。
appLovinMaxes	List<AppLovinMax>		0 ~ 10 items	AppLovin MAX の設定 AppLovin MAX に関連する広告の設定やパラメータを管理します。
acquirePointScript	ScriptSetting			ポイント入手時に実行するスクリプトの設定 Script トリガーリファレンス - `acquirePoint`
consumePointScript	ScriptSetting			ポイント消費時に実行するスクリプトの設定 Script トリガーリファレンス - `consumePoint`
changePointNotification	NotificationSetting	✓		広告視聴によりポイントが変動したときのプッシュ通知広告視聴によるポイント変動時のプッシュ通知設定です。ポイントが変動した際にゲームクライアントに通知するための設定を保持します。この設定を行わなければ、獲得したポイントが即時にゲームに反映されません。
logSetting	LogSetting			ログの出力設定ログデータの出力設定を管理します。この型は、ログデータを書き出すために使用される GS2-Log のネームスペース情報を保持します。

GetAttr

!GetAttrタグで取得可能なリソースの生成結果

	型	説明
Item	Namespace	作成したネームスペース

実装例

Type: GS2::AdReward::Namespace
Properties:
  Name: namespace-0001
  Description: null
  TransactionSettingV2: null
  Admob: 
    AllowAdUnitIds: 
    - 1
    - 2
    - 3
  UnityAd: 
    Keys: 
    - key-0001
    - key-0002
  AppLovinMaxes: []
  AcquirePointScript: null
  ConsumePointScript: null
  ChangePointNotification: 
    GatewayNamespaceId: grn:gs2:ap-northeast-1:YourOwnerId:gateway:namespace-0001
  LogSetting: 
    LoggingNamespaceId: grn:gs2:ap-northeast-1:YourOwnerId:log:namespace-0001

import (
    "github.com/gs2io/gs2-golang-cdk/core"
    "github.com/gs2io/gs2-golang-cdk/adReward"
    "github.com/openlyinc/pointy"
)


SampleStack := core.NewStack()
adReward.NewNamespace(
    &SampleStack,
    "namespace-0001",
    adReward.NamespaceOptions{
        Admob: &adReward.AdMob{
            AllowAdUnitIds: []string{
                "1",
                "2",
                "3",
            },
        },
        UnityAd: &adReward.UnityAd{
            Keys: []string{
                "key-0001",
                "key-0002",
            },
        },
        ChangePointNotification: core.NewNotificationSetting(
            core.NotificationSettingOptions{
                GatewayNamespaceId: pointy.String("grn:gs2:ap-northeast-1:YourOwnerId:gateway:namespace-0001"),
            },
        ),
        LogSetting: &core.LogSetting{
            LoggingNamespaceId: "grn:gs2:ap-northeast-1:YourOwnerId:log:namespace-0001",
        },
    },
)

println(SampleStack.Yaml())  // Generate Template

class SampleStack extends \Gs2Cdk\Core\Model\Stack
{
    function __construct() {
        parent::__construct();
        new \Gs2Cdk\AdReward\Model\Namespace_(
            stack: $this,
            name: "namespace-0001",
            options: new \Gs2Cdk\AdReward\Model\Options\NamespaceOptions(
                admob: new \Gs2Cdk\AdReward\Model\AdMob(
                    allowAdUnitIds: [
                        "1",
                        "2",
                        "3",
                    ]
                ),
                unityAd: new \Gs2Cdk\AdReward\Model\UnityAd(
                    options: new \Gs2Cdk\AdReward\Model\Options\UnityAdOptions(
                        keys: [
                            "key-0001",
                            "key-0002",
                        ]
                    )
                ),
                changePointNotification: new \Gs2Cdk\Core\Model\NotificationSetting(
                    new \Gs2Cdk\Core\Model\NotificationSettingOptions(
                        gatewayNamespaceId: "grn:gs2:ap-northeast-1:YourOwnerId:gateway:namespace-0001"
                    )
                ),
                logSetting: new \Gs2Cdk\Core\Model\LogSetting(
                    loggingNamespaceId: "grn:gs2:ap-northeast-1:YourOwnerId:log:namespace-0001"
                )
            )
        );
    }
}

print((new SampleStack())->yaml());  // Generate Template

class SampleStack extends io.gs2.cdk.core.model.Stack
{
    public SampleStack() {
        super();
        new io.gs2.cdk.adReward.model.Namespace(
                this,
                "namespace-0001",
                new io.gs2.cdk.adReward.model.options.NamespaceOptions()
                        .withAdmob(new io.gs2.cdk.adReward.model.AdMob(
                            Arrays.asList(
                                "1",
                                "2",
                                "3"
                            )
                        ))
                        .withUnityAd(new io.gs2.cdk.adReward.model.UnityAd(
                            new io.gs2.cdk.adReward.model.options.UnityAdOptions()
                                .withKeys(
                                    Arrays.asList(
                                        "key-0001",
                                        "key-0002"
                                    )
                                )
                        ))
                        .withChangePointNotification(new io.gs2.cdk.core.model.NotificationSetting(
                            new io.gs2.cdk.core.model.options.NotificationSettingOptions()
                                .withGatewayNamespaceId("grn:gs2:ap-northeast-1:YourOwnerId:gateway:namespace-0001")
                        ))
                        .withLogSetting(new io.gs2.cdk.core.model.LogSetting(
                            "grn:gs2:ap-northeast-1:YourOwnerId:log:namespace-0001"
                        ))
        );
    }
}

System.out.println(new SampleStack().yaml());  // Generate Template

public class SampleStack : Gs2Cdk.Core.Model.Stack
{
    public SampleStack() {
        new Gs2Cdk.Gs2AdReward.Model.Namespace(
            stack: this,
            name: "namespace-0001",
            options: new Gs2Cdk.Gs2AdReward.Model.Options.NamespaceOptions
            {
                admob = new Gs2Cdk.Gs2AdReward.Model.AdMob(
                    allowAdUnitIds: new string[]
                    {
                        "1",
                        "2",
                        "3"
                    }
                ),
                unityAd = new Gs2Cdk.Gs2AdReward.Model.UnityAd(
                    options: new Gs2Cdk.Gs2AdReward.Model.Options.UnityAdOptions
                    {
                        keys = new string[]
                        {
                            "key-0001",
                            "key-0002"
                        }
                    }
                ),
                changePointNotification = new Gs2Cdk.Core.Model.NotificationSetting(
                    options: new Gs2Cdk.Core.Model.NotificationSettingOptions
                    {
                        gatewayNamespaceId = "grn:gs2:ap-northeast-1:YourOwnerId:gateway:namespace-0001"
                    }
                ),
                logSetting = new Gs2Cdk.Core.Model.LogSetting(
                    loggingNamespaceId: "grn:gs2:ap-northeast-1:YourOwnerId:log:namespace-0001"
                )
            }
        );
    }
}

Debug.Log(new SampleStack().Yaml());  // Generate Template

import core from "@/gs2cdk/core";
import adReward from "@/gs2cdk/adReward";

class SampleStack extends core.Stack
{
    public constructor() {
        super();
        new adReward.model.Namespace(
            this,
            "namespace-0001",
            {
                admob: new adReward.model.AdMob(
                    [
                        "1",
                        "2",
                        "3",
                    ]
                ),
                unityAd: new adReward.model.UnityAd(
                    {
                        keys:
                        [
                            "key-0001",
                            "key-0002",
                        ]
                    }
                ),
                changePointNotification: new core.NotificationSetting(
                    {
                        gatewayNamespaceId: "grn:gs2:ap-northeast-1:YourOwnerId:gateway:namespace-0001"
                    }
                ),
                logSetting: new core.LogSetting(
                    "grn:gs2:ap-northeast-1:YourOwnerId:log:namespace-0001"
                )
            }
        );
    }
}

console.log(new SampleStack().yaml());  // Generate Template

from gs2_cdk import Stack, core, ad_reward

class SampleStack(Stack):

    def __init__(self):
        super().__init__()
        ad_reward.Namespace(
            stack=self,
            name='namespace-0001',
            options=ad_reward.NamespaceOptions(
                admob=ad_reward.AdMob(
                    allow_ad_unit_ids=[
                        '1',
                        '2',
                        '3',
                    ],
                ),
                unity_ad=ad_reward.UnityAd(
                    options=ad_reward.UnityAdOptions(
                        keys=[
                            'key-0001',
                            'key-0002',
                        ],
                    )
                ),
                change_point_notification=core.NotificationSetting(
                    options=core.NotificationSettingOptions(
                        gateway_namespace_id='grn:gs2:ap-northeast-1:YourOwnerId:gateway:namespace-0001',
                    )
                ),
                log_setting=core.LogSetting(
                    logging_namespace_id='grn:gs2:ap-northeast-1:YourOwnerId:log:namespace-0001',
                ),
            ),
        )

print(SampleStack().yaml())  # Generate Template

TransactionSettingV2

トランザクション設定（V2）

トランザクション設定（V2）は、ネームスペースが発行するトランザクションをどのように実行するかを決める設定です。

設定する項目は次の 2 つだけです。

distributorNamespaceId: トランザクションの実行に使用する GS2-Distributor のネームスペース
enableParallelExecution: トランザクションに含まれるアクションを 1 件ずつ実行するか、まとめて同時に実行するか

どちらを選んでも、トランザクションは発行された時点でサーバーが実行し、成否はトランザクション全体でひとつになります。あるアクションが失敗した場合は、それまでに実行されたアクションもろとも取り消され、1 つも反映されません。トランザクションの実行方法に関するそれ以外の項目は推奨構成に固定されているため、設定する必要はありません。

1 件ずつ実行する場合（既定 / enableParallelExecution が false）、各アクションは先に実行されたアクションの書き込みを踏まえて動作します。アクションは verify・consume・acquire の順に実行され、次のことができます。

1 つのトランザクションの中で、同じ行を複数のアクションから更新する（まとめて同時に実行する場合は失敗します）
先に実行されたアクションの書き込みを読む。List や Query の結果でも、入れ子になったトランザクションの内側でも読めます
%{Gs2Xxx:ActionName.path[0].field} を使って、先に実行された verify や consume アクションの結果を、後続の verify・consume・acquire アクションの引数として渡す

代わりに、レスポンスタイムは各アクションの実行時間の合計になり、1 つのトランザクションに含められるアクションは最大 20 件になります。また、各フェーズの中での実行順はアクション名、次に対象リソースの順で決まるため、リクエストに並べた順序で実行順を指定することはできません。実行は最初に失敗したアクションで停止します。

まとめて同時に実行する場合（enableParallelExecution が true）、アクションは同一のデータスナップショットに対して並列に実行されるため、レスポンスタイムは最も遅いアクション 1 件分で済み、アクション数の上限もありません。

代わりに、あるアクションから他のアクションの書き込みを読むことはできず、同じ行を 2 つのアクションが書き換えるとトランザクションは database:transaction:same.resource（400）で失敗します。同一トランザクション内で同じデータを 2 つ以上のアクションが書き換えないことを保証できる場合にだけ選択してください。%{...} は先行するフェーズ（verify → consume → acquire の順）の結果だけを参照でき、同じフェーズ内のアクションへの参照は解決されずにそのまま残ります。%{...} を含むフェーズは先行するフェーズの完了を待ってから実行されるため、その分だけレスポンスタイムが伸びます。

トランザクション設定は、トランザクション設定（V2）に置き換えられた非推奨の設定で、トランザクション設定（V2）が存在しなかった頃に作成されたネームスペースのために残されています。トランザクション設定（V2）が設定されていない間だけ適用され、トランザクション設定（V2）を設定するとそちらが優先されます。トランザクション設定で可能だった、トランザクションをクライアント実行のスタンプシートとして実行する・GS2-Distributor による AutoRun の非同期実行を行う・入手アクションを GS2-JobQueue に畳み込む、という 3 つの挙動は、こちらではあえて提供していません。

	型	有効化条件	必須	デフォルト	値の制限	説明
distributorNamespaceId	string			“grn:gs2:{region}:{ownerId}:distributor:default”	~ 1024文字	トランザクションの実行に使用する GS2-Distributor ネームスペース GRN
enableParallelExecution	bool			false		アクションを直列ではなく並列に実行するか

ScriptSetting

スクリプト設定

GS2 ではマイクロサービスのイベントに関連づけて、カスタムスクリプトを実行することができます。
このモデルは、スクリプトの実行をトリガーするための設定を保持します。

スクリプトの実行方式は大きく2種類あり、それは「同期実行」と「非同期実行」です。
同期実行は、スクリプトの実行が完了するまで処理がブロックされます。
代わりに、スクリプトの実行結果を使って API の実行を止めたり、API のレスポンス内容を制御することができます。

一方、非同期実行ではスクリプトの完了を待つために処理がブロックされることはありません。
ただし、スクリプトの実行結果を利用して API の実行を停止したり、API の応答内容を変更することはできません。
非同期実行は API の応答フローに影響を与えないため、原則として非同期実行を推奨します。

非同期実行には実行方式が2種類あり、GS2-Script と Amazon EventBridge があります。
Amazon EventBridge を使用することで、Lua 以外の言語で処理を記述することができます。

型

有効化条件

必須

デフォルト

値の制限

説明

triggerScriptId

string

~ 1024文字

API 実行時に同期的に実行される GS2-Script のスクリプト GRN

「grn:gs2:」ではじまる GRN 形式のIDで指定する必要があります。

doneTriggerTargetType

文字列列挙型
enum {
  “none”,
  “gs2_script”,
  “aws”
}

“none”

非同期スクリプトの実行方法

非同期実行で使用するスクリプトの種類を指定します。
「非同期実行のスクリプトを使用しない(none)」「GS2-Scriptを使用する(gs2_script)」「Amazon EventBridgeを使用する(aws)」が選択できます。

定義	説明
none	なし
gs2_script	GS2-Script
aws	Amazon EventBridge

doneTriggerScriptId

string

{doneTriggerTargetType} == “gs2_script”

~ 1024文字

非同期実行する GS2-Script スクリプト GRN

「grn:gs2:」ではじまる GRN 形式のIDで指定する必要があります。

※ doneTriggerTargetType が “gs2_script” であれば有効

doneTriggerQueueNamespaceId

string

{doneTriggerTargetType} == “gs2_script”

~ 1024文字

非同期実行スクリプトを実行する GS2-JobQueue ネームスペース GRN

非同期実行スクリプトを直接実行するのではなく、GS2-JobQueue を経由する場合は GS2-JobQueue のネームスペースGRN を指定します。
GS2-JobQueue を利用する理由は多くはありませんので、特に理由がなければ指定する必要はありません。

※ doneTriggerTargetType が “gs2_script” であれば有効

NotificationSetting

プッシュ通知に関する設定

GS2 のマイクロサービス内で何らかのイベントが発生した際に、プッシュ通知を送信するための設定です。
ここでいうプッシュ通知は GS2-Gateway の提供する WebSocket インターフェースを経由した処理であり、スマートフォンのプッシュ通知とは性質が異なります。
たとえば、マッチメイキングが完了した時やフレンドリクエストが届いた時など、ゲームクライアントの操作とは関係なく状態が変化した際に GS2-Gateway を経由してプッシュ通知をすることで、ゲームクライアントは状態の変化を検知することができます。

GS2-Gateway のプッシュ通知は通知先のデバイスがオフラインだった時に追加の処理としてモバイルプッシュ通知を送信できます。
モバイルプッシュ通知をうまく利用すれば、マッチメイキング中にゲームを終了しても、モバイルプッシュ通知を使用してプレイヤーに通知し、ゲームに戻ってくるフローを実現できる可能性があります。

型有効化条件必須デフォルト値の制限説明

gatewayNamespaceId

string

“grn:gs2:{region}:{ownerId}:gateway:default”

~ 1024文字

プッシュ通知に使用する GS2-Gateway のネームスペース

「grn:gs2:」から始まる GRN 形式で GS2-Gateway のネームスペースIDを指定します。

enableTransferMobileNotification

bool?

false

モバイルプッシュ通知へ転送するか

この通知を送信しようとした時、通知先のデバイスがオフラインだった場合、モバイルプッシュ通知へ転送するかどうかを指定します。

sound

string

{enableTransferMobileNotification} == true

~ 1024文字

モバイルプッシュ通知で使用するサウンドファイル名

ここで指定したサウンドファイル名は、モバイルプッシュ通知を送信する際に使用され、特別なサウンドで通知を出すことができます。

※ enableTransferMobileNotification が true であれば有効

mobileNotificationMessages

List<MobileNotificationMessage>

{enableTransferMobileNotification} == true

0 ~ 100 items

モバイルプッシュ通知へ転送するときの言語別のタイトルと本文

オフラインのプレイヤーへモバイルプッシュ通知として転送するときの、言語別のタイトルと本文です。
デバイストークンに登録された locale に一致するエントリ → default → 先頭の順に採用します。
未設定なら通知の payload の mobile 配列、それも無ければ payload をそのまま本文にします。

※ enableTransferMobileNotification が true であれば有効

enable

文字列列挙型
enum {
“Enabled”,
“Disabled”
}

“Enabled”

プッシュ通知を有効にするか

定義	説明
Enabled	有効
Disabled	無効

LogSetting

ログの出力設定

ログデータの出力設定を管理します。この型は、ログデータを書き出すために使用される GS2-Log ネームスペースの識別子（Namespace ID）を保持します。
ログネームスペースID(loggingNamespaceId)には、ログデータを収集し保存する GS2-Log のネームスペースを、GRNの形式で指定します。
この設定をすることで、設定されたネームスペース内で発生したAPIリクエスト・レスポンスのログデータが、対象の GS2-Log ネームスペース側へ出力されるようになります。
GS2-Log ではリアルタイムでログが提供され、システムの監視や分析、デバッグなどに利用できます。

	型	有効化条件	必須	デフォルト	値の制限	説明
loggingNamespaceId	string		✓		~ 1024文字	ログを出力する GS2-Log のネームスペース GRN 「grn:gs2:」ではじまる GRN 形式のIDで指定する必要があります。

TransactionSetting

トランザクション設定

トランザクション設定は非推奨です。トランザクション設定（V2）がこれに置き換わります。トランザクション設定（V2）が存在しなかった頃に作成されたネームスペースのために残されており、トランザクション設定（V2）が設定されていない間だけ適用されます。新しく作成するネームスペースでは使用しないでください。

この設定は、トランザクションの実行に関わる要素――自動実行（AutoRun）、アトミック実行（AtomicCommit）、GS2-Distributor を利用した非同期実行、スクリプト結果の一括適用、GS2-JobQueue による入手アクションの非同期化、直列実行――をそれぞれ個別の項目として公開しているため、推奨構成以外の組み合わせも作れます。その推奨構成を 1 つの設定としてまとめたものがトランザクション設定（V2）です。トランザクション設定を使い続けるのは、トランザクション設定（V2）が提供しない挙動――トランザクションをクライアント実行のスタンプシートとして実行する、GS2-Distributor による AutoRun の非同期実行を行う、入手アクションを GS2-JobQueue に畳み込む――にすでに依存しているネームスペースに限ってください。

	型	有効化条件	デフォルト	値の制限	説明
enableAutoRun	bool		false		発行したトランザクションをサーバーサイドで自動的に実行するか
enableAtomicCommit	bool	{enableAutoRun} == true	false		トランザクションの実行をアトミックにコミットするか ※ enableAutoRun が true であれば有効
transactionUseDistributor	bool	{enableAtomicCommit} == true	false		トランザクションを非同期処理で実行する ※ enableAtomicCommit が true であれば有効
commitScriptResultInUseDistributor	bool	{transactionUseDistributor} == true	false		スクリプトの結果コミット処理を非同期処理で実行するか ※ transactionUseDistributor が true であれば有効
acquireActionUseJobQueue	bool	{enableAtomicCommit} == true	false		入手アクションを実行する際に GS2-JobQueue を使用するか ※ enableAtomicCommit が true であれば有効
enableSequentialExecution	bool	{enableAtomicCommit} == true	false		アトミックコミットのアクションを直列に実行し、同じ行を複数のアクションで更新できるようにするか ※ enableAtomicCommit が true であれば有効
distributorNamespaceId	string		“grn:gs2:{region}:{ownerId}:distributor:default”	~ 1024文字	トランザクションの実行に使用する GS2-Distributor ネームスペース GRN
queueNamespaceId	string		“grn:gs2:{region}:{ownerId}:queue:default”	~ 1024文字	トランザクションの実行に使用する GS2-JobQueue のネームスペース GRN

AdMob

AdMob 広告プラットフォームに関連する設定

許可された広告ユニットIDのリストを保持し、これに基づいて AdMob からの視聴完了 Webhook の検証を行います。

	型	有効化条件	必須	デフォルト	値の制限	説明
allowAdUnitIds	List<string>		✓		1 ~ 10 items	許可する広告ユニットIDリスト AdMobからの広告視聴完了コールバックに含まれる広告ユニットIDを検証するために使用されます。リストに含まれる広告ユニットIDは、アプリケーションまたはゲーム内での広告視聴が適切に完了したことを確認するためのものです。 AdMobプラットフォームから送信される広告視聴完了の通知に含まれる広告ユニットIDがこのリストにあるかどうかを確認することで、正当な広告視聴イベントのみを受け入れ、不正なリクエストやスパムを防ぐことができます。

UnityAd

Unity Ads 広告プラットフォームに関連する設定

アプリケーションやゲームで使用されるUnity Ads関連の暗号鍵を保持するために使用されます。
暗号鍵はUnity Adsから発行され、広告視聴の完了を検証する際に使用します。

	型	有効化条件	必須	デフォルト	値の制限	説明
keys	List<string>				0 ~ 10 items	暗号鍵のリスト Unity Adsから発行された暗号鍵のリストを保持します。これらの鍵は、Unity Ads 広告プラットフォームとの通信や広告イベントの検証に使用されます。暗号鍵は Unity Dashboard で取得することができます。リストに含まれる各鍵は、広告視聴の完了を検証するために必要です。

AppLovinMax

AppLovin MAX 広告プラットフォームに関連する設定

許可された広告ユニットIDを保持し、これに基づいて AppLovin MAX からの視聴完了 Webhook の検証を行います。

	型	有効化条件	必須	デフォルト	値の制限	説明
allowAdUnitId	string		✓		~ 16文字	許可する広告ユニットID AppLovin MAX から送信される広告視聴完了コールバックに含まれる ad_unit_id を検証するために使用されます。この設定に登録された広告ユニットIDと、コールバックに含まれる ad_unit_id が一致する場合のみ、広告視聴が正当に完了したものとして受け付けます。これにより、許可されていない広告ユニットからの通知や不正なリクエストを拒否し、不正な広告報酬の付与やスパムを防ぐことができます。
eventKey	string		✓		~ 128文字	AppLovin Event Key AppLovin MAXからの広告視聴完了コールバックが適切なアクセス元からのアクセスであることを検証する際に利用します

MobileNotificationMessage

モバイルプッシュ通知の言語別メッセージ

通知をモバイルプッシュ通知へ転送する際に使用する、言語別メッセージリストの 1 要素です。1 つの要素が 1 つのロケールに対するタイトルと本文を保持します。
採用される要素は、Firebase デバイストークンに登録されたロケールと locale が一致する要素 → locale が default の要素 → リストの先頭の要素、の順で選択されます。

	型	値の制限	説明
locale	string	~ 32文字	メッセージの言語この要素がどの言語に対するものかを表します。Firebase デバイストークンに登録されたロケールと照合されます。`ja` や `en` のような任意の文字列を指定できます。`default` は特別な値で、端末のロケールに一致する要素がなかったときに使われるフォールバックの要素であることを表します。
title	string	~ 256文字	プッシュ通知のタイトルこの要素が採用されたときに、モバイルプッシュ通知のタイトルとして表示されるテキストです。省略した場合は、通知の件名が使用されます。
message	string	~ 1024文字	プッシュ通知の本文この要素が採用されたときに、モバイルプッシュ通知の本文として表示されるテキストです。