取り消しルールを設定する

Last updated on October 9, 2026

注釈：本資料はAI技術を用いて翻訳されています。

概要

AccelByte Gaming Services（AGS）の取り消しサービスでは、永続エンタイトルメント、消費可能エンタイトルメント、および仮想通貨の取り消し戦略ロジックを設定およびカスタマイズできます。

この記事では、お客様の好みやビジネスニーズに基づいて取り消しルールを正しく設定する方法と、各ルールの影響について説明します。設定には Admin Portal または AGS CLI を使用できます。

前提条件

ストア、ウォレット、およびアプリ内購入サービスが適切に設定されていること。
カスタマイズされた取り消しルールを使用する場合は、カスタムサービスアドレスが適切に設定されている必要があります。
AGS CLI の手順に従う場合は、AGS CLI をインストールしてサインインしていること。詳細については、インストールとサインインを参照してください。

取り消し戦略を設定する

仮想通貨を取り消す

Admin Portal
AGS CLI

AGS 管理ポータルで、ネームスペースに移動します。
サイドバーで、Commerce > Revocations > Configurations に移動します。
仮想通貨の取り消しを有効にする場合は、Allow Revocation トグルをオンにし、希望する取り消し戦略を選択します。
- Fail Revocation if Wallet Balance would drop below 0：取り消す金額がプレイヤーのウォレット残高を超える場合、取り消しは失敗します。
- Allow negative wallet balance：取り消す金額がプレイヤーのウォレット残高を超える場合、プレイヤーのウォレット残高はそれに応じて減額され、マイナスになります。
- Customization：gRPC カスタムサービスを使用して、独自のカスタム取り消し戦略を使用する場合に選択します。
注記
1. 仮想通貨は、対応するウォレットからのみ減額できます。
2. カスタマイズを使用する場合は、カスタムサービス gRPC サーバーアドレスを設定する必要があります。

現在の取り消し設定をファイルに保存します。ファイル名は任意ですが、この例では revocation-config.json を使用します。
```
ags platform revocations get-config --namespace <YourNamespace> --format json > revocation-config.json
```
ファイルの wallet セクションを編集します。enabled を true に設定して Allow Revocation をオンにし、strategy を以下の表のいずれかの値に設定します。
```
{
  "wallet": {
    "enabled": true,
    "strategy": "REVOKE_OR_REPORT"
  }
}
```
Admin Portal の戦略 strategy の値
Fail Revocation if Wallet Balance would drop below 0 REVOKE_OR_REPORT
Allow negative wallet balance ALWAYS_REVOKE
Customization CUSTOM
ファイル全体を送信して設定を更新します。Admin Portal と同様に、変更していないその他の設定もそのまま再送信されます。
```
ags platform revocations update-config --namespace <YourNamespace> --json @revocation-config.json
```
注記
CUSTOM を使用する場合は、事前にカスタムサービスの gRPC サーバーアドレスを設定してください。設定していない場合、更新は失敗します。

Admin Portal の戦略	`strategy` の値
Fail Revocation if Wallet Balance would drop below 0	`REVOKE_OR_REPORT`
Allow negative wallet balance	`ALWAYS_REVOKE`
Customization	`CUSTOM`

永続エンタイトルメントの取り消し

永続エンタイトルメントの希望する戦略を設定するには、次の手順に従います。

Admin Portal
AGS CLI

AGS 管理ポータルで、ネームスペースに移動します。
サイドバーで、Commerce > Revocations > Configurations に移動します。
Revocation Configurations ページで、Entitlement (Durable) を選択します。
永続エンタイトルメントの希望する戦略を選択します。
- Default：エンタイトルメントはプレイヤーのアカウントから取り消されます。
- Customization：gRPC カスタムサービスを使用して、独自のカスタム取り消し戦略を使用します。

現在の取り消し設定をファイルに保存します。ファイル名は任意ですが、この例では revocation-config.json を使用します。
```
ags platform revocations get-config --namespace <YourNamespace> --format json > revocation-config.json
```
ファイルの entitlement.durable セクションを編集します。strategy を、Default の場合は REVOKE_OR_REPORT、Customization の場合は CUSTOM に設定します。
```
{
  "entitlement": {
    "durable": {
      "enabled": true,
      "strategy": "REVOKE_OR_REPORT"
    }
  }
}
```
ファイル全体を送信して設定を更新します。Admin Portal と同様に、変更していないその他の設定もそのまま再送信されます。
```
ags platform revocations update-config --namespace <YourNamespace> --json @revocation-config.json
```
注記
CUSTOM を使用する場合は、事前にカスタムサービスの gRPC サーバーアドレスを設定してください。設定していない場合、更新は失敗します。

消費可能エンタイトルメントの取り消し

Admin Portal
AGS CLI

AGS 管理ポータルで、ネームスペースに移動します。
サイドバーで、Commerce > Revocations > Configurations に移動します。
Revocation Configurations ページで、Entitlement (Consumable) を選択します。
消費可能エンタイトルメントの希望する戦略を選択します。
- Default：未使用または十分な使用回数がある消費可能エンタイトルメントのみがプレイヤーから取り消されます。
- Customization：gRPC カスタムサービスを使用して、独自のカスタム取り消し戦略を使用します。

現在の取り消し設定をファイルに保存します。ファイル名は任意ですが、この例では revocation-config.json を使用します。
```
ags platform revocations get-config --namespace <YourNamespace> --format json > revocation-config.json
```
ファイルの entitlement.consumable セクションを編集します。strategy を、Default の場合は REVOKE_OR_REPORT、Customization の場合は CUSTOM に設定します。
```
{
  "entitlement": {
    "consumable": {
      "enabled": true,
      "strategy": "REVOKE_OR_REPORT"
    }
  }
}
```
ファイル全体を送信して設定を更新します。Admin Portal と同様に、変更していないその他の設定もそのまま再送信されます。
```
ags platform revocations update-config --namespace <YourNamespace> --json @revocation-config.json
```
注記
CUSTOM を使用する場合は、事前にカスタムサービスの gRPC サーバーアドレスを設定してください。設定していない場合、更新は失敗します。

取り消し履歴を表示する

Admin Portal
AGS CLI

AGS 管理ポータルで、ネームスペースに移動します。
サイドバーで、Commerce > Revocations > Revocation History に移動します。取り消し履歴ページが表示され、すべての過去の取り消しレコードのテーブルが表示されます。
Revocation History ページでは、All Source および All Status フィルターを使用して検索を絞り込むか、Search by User ID 検索ボックスを使用して個々のユーザーレコードを検索できます。
- All Source：これには、注文、ダウンロードコンテンツ（DLC）、およびその他が含まれ、これらの取り消しがどこから来たかを示します。
- All Status：これには「Success」と「Failed」が含まれます。
特定の取り消しレコードを開くには、その View ボタンをクリックして詳細を表示します。

プレイヤーの取り消し履歴を一覧表示します。

ags platform revocations get-history --namespace <YourNamespace> --user-id <UserId>

結果を絞り込むには、ソースまたはステータスのフィルターを追加します。ソースには ORDER、DLC、IAP、または OTHER を、ステータスには SUCCESS または FAIL を指定できます。
```
ags platform revocations get-history --namespace <YourNamespace> --source ORDER --status FAIL
```
出力される各レコードには、そのレコードの詳細が含まれます。

返金とチャージバック

サードパーティプラットフォームで発生する返金およびチャージバックイベントは、AGS がサードパーティプラットフォームと直接統合されていないため、検出が困難です。
PlayStation の場合、AGS は Sony の Commerce Management API を使用して、返金またはチャージバックイベントが発生したときを検出し、それに応じてプレイヤーのエンタイトルメントまたは所有権を取り消すか復元します。
他のプラットフォームの場合、AGS は、プレイヤーがサードパーティプラットフォームで持っている永続エンタイトルメントと、プレイヤーが AGS で持っているものを照合します。その後、AGS はそれに応じてエンタイトルメントを取り消すか付与します。
注記
1. これは自動プロセスですが、プレイヤーがゲームにログインしたときにのみ発生します。
2. 消費可能エンタイトルメントおよび仮想通貨を取り消す自動プロセスはありません。現在、このプロセスは管理者が手動で実行する必要があります。

概要​

前提条件​

取り消し戦略を設定する​

仮想通貨を取り消す​

永続エンタイトルメントの取り消し​

消費可能エンタイトルメントの取り消し​

取り消し履歴を表示する​

返金とチャージバック​

概要