管理ポータルでの法的文書の管理
注釈:本資料はAI技術を用いて翻訳されています。
概要
このガイドでは、AccelByte Gaming Services(AGS)管理ポータルまたは AGS CLI で法的文書を作成、更新、公開する方法を説明します。
前提条件
この権限セクションは、プライベートクラウドのお客様にのみ適用されます。
以下の権限を持つ AGS 管理ポータルへのアクセス:
| 用途 | 権限タグ | アクション |
|---|---|---|
| 法的文書の管理 | ADMIN:NAMESPACE:{namespace}:LEGAL | Create、Update、Read、Delete |
AGS CLI の手順に従う場合は、AGS CLI をインストールし、上記の権限を持つアカウントでサインインしてください。インストールとサインイン を参照してください。例では Bash シェルを使用しています。
文書の管理
このセクションでは、AGS 管理ポータルまたは AGS CLI で法的文書を管理する方法を説明します。
法的文書の作成
- Admin Portal
- AGS CLI
-
管理ポータルのサイドバーで、Foundations > Legal & Privacy > Legal Documents に移動します。
-
Legal Documents ページで、+ Create Document ボタンをクリックします。Create Document フォームが表示されます。
-
フォームで、必須フィールドに入力します:
- Document Name: 法的文書の名前を入力します。文字とスペースのみが許可されます。
- Document Type:
- プライバシーポリシーまたは利用規約を作成するには、Legal Document を選択します。
- ニュースレターへの登録オプションなど、マーケティング資料を作成するには、Marketing Preference を選択します。
- Country: この文書を適用する国を選択します。最初に選択した国がデフォルトの国になります。そのため、このデフォルトの国に対して後からアップロードした文書は、独自のポリシーを持たないすべての国にも適用されます。
重要法的文書の作成後、国を変更することはできません。フォームを送信する前に、このステップでの国の選択が正しいことを確認してください。
- Tags (Optional): 文書を分類するためのタグを追加します。
- Clients (Optional): この法的文書が適用される IAM クライアントを選択します。パブリッシャーネームスペースでは、これはプレイヤーポータルまたはランチャーである可能性があり、ゲームネームスペースでは、これはゲームクライアントである可能性があります。
ヒント法的文書の作成後、追加のクライアントを追加できます。
-
Visibility: 法的ウェブサイト上で法的文書を Active と Inactive のどちらに設定するかを選択します。
- Active: クライアントに法的文書を表示し、すべてのユーザーが閲覧およびアクセスできるようにします。
- Inactive: クライアントから法的文書を非表示にし、その中のすべての必須ポリシーを任意扱いにします。ただし、文書はゲームクライアントおよび法的契約の履歴を通じてプレイヤーが引き続きアクセスできます。例えば、この設定は、招待されたプレイヤーだけが利用できるゲームの秘密保持契約(NDA)を作成する場合に便利です。招待されたプレイヤーは、クローズドテストを開始する前にその文書にアクセスして署名できます。
-
Description: 文書の説明を入力します。
-
完了したら、Create ボタンをクリックします。新しい文書が Legal Documents リストに追加されます。
-
文書タイプの ID を確認します。Legal Document タイプと Marketing Preference タイプには、それぞれ ID があります:
ags legal base-policies list-types --namespace <YourNamespace> --limit 20出力の
policyTypeNameで対象のタイプを探し、そのidを控えておきます。 -
(任意)文書を IAM クライアントに適用する場合は、クライアント ID を確認します:
ags iam clients list --namespace <YourNamespace> -
文書の設定を記述した JSON ファイルを作成します。ファイル名は任意です。この例では
document.jsonを使用します:{
"basePolicyName": "<DocumentName>",
"typeId": "<DocumentTypeId>",
"affectedCountries": ["US", "CA"],
"tags": [],
"affectedClientIds": [],
"isHidden": false,
"isHiddenPublic": false,
"description": "<Description>"
}各フィールドと管理ポータルのフィールドの対応は次のとおりです:
管理ポータルのフィールド リクエストボディのフィールド Document Name basePolicyName。文字とスペースのみが許可されます。Document Type typeId:ステップ 1 で確認したタイプ ID。Country affectedCountries:USなどの 2 文字の国コード。文書の作成後、これらの国を変更することはできません。Tags tagsClients affectedClientIds:ステップ 2 で確認したクライアント ID。Visibility isHidden:Active の場合はfalse、Inactive の場合はtrue。Description descriptionisHiddenPublicは、法的ウェブサイトに文書を表示するかどうかを制御します。ウェブサイト上で文書を非表示にするには、trueに設定します。この設定によって、プレイヤーに文書への同意が求められるかどうかが変わることはありません。 -
文書を作成します。
@の後に JSON ファイルのパスを指定します:ags legal base-policies create --namespace <YourNamespace> --json @document.jsonコマンドを実行すると、
idを含む新しい文書が出力されます。注記affectedCountriesの最初の国が必ずしもデフォルトの国になるとは限りません。デフォルトを確認または変更するには、ポリシーの作成 を参照してください。
法的文書の編集
- Admin Portal
- AGS CLI
-
管理ポータルのサイドバーで、Foundations > Legal & Privacy > Legal Documents に移動します。
-
Legal Documents ページで、既存のすべての法的文書のリストが表示されます。更新したい文書を選択し、その横の Action 列にある Update をクリックします。
-
表示される Update Document フォームで、必要な変更を行います。必要に応じて、フィールドの入力については前のセクションを参照してください。
-
完了したら、Edit ボタンをクリックします。文書が更新されます。
-
法的文書の ID を確認します:
ags legal base-policies list --namespace <YourNamespace>出力の
basePolicyNameで対象の文書を探し、そのidを控えておきます。 -
文書の現在の設定をファイルに書き出します。
<BasePolicyId>を文書 ID に置き換えます:ags legal base-policies get --namespace <YourNamespace> --base-policy-id <BasePolicyId> --format json > document.json -
document.jsonで、変更したいフィールドを編集します。フィールド名は 法的文書の作成 に記載されています。次に、更新によって国が追加されないように、以下の行を追加します:"affectedCountries": []警告更新により、文書の名前、説明、タグ、クライアント、表示設定がファイル内の値に置き換えられます。変更しないフィールドは編集せずにそのまま残してください。フィールドを削除すると、その値は更新時にクリアされます。ファイルに
affectedCountriesフィールドがない場合、更新は失敗します。 -
文書を更新します:
ags legal base-policies update --namespace <YourNamespace> --base-policy-id <BasePolicyId> --json @document.json注記文書を Inactive に設定すると、管理ポータルでは各ポリシーの Mandatory Update も解除されます。AGS CLI を使用する場合は、ポリシーの作成 のステップ 7 の説明に従って、必須ポリシーごとにこの操作を手動で行う必要があります。
法的文書の削除
- Admin Portal
- AGS CLI
-
管理ポータルのサイドバーで、Foundations > Legal & Privacy > Legal Documents に移動します。
-
Legal Documents ページで、既存のすべての法的文書のリストが表示されます。削除したい文書を選択し、その横の Action 列にある Delete をクリックします。
-
Confirm ボタンをクリックします。文書が削除されます。
-
法的文書の ID を確認します:
ags legal base-policies list --namespace <YourNamespace>出力の
basePolicyNameで対象の文書を探し、そのidを控えておきます。 -
文書を削除します。
<BasePolicyId>を文書 ID に置き換えます。確認を求められたら、削除を確定します。ags legal base-policies delete --namespace <YourNamespace> --base-policy-id <BasePolicyId>
ポリシーの作成
法的文書の作成後、特定の国または複数の国のグループ用にその文書の特別なバージョンを保持する国固有のポリシーを作成できます。法的文書の作成または編集時に入力された国は、その文書の特定のバージョンを必要とする国としてリストされます。そのリストに新しい国固有またはグループポリシーを追加するには、以下の手順に従います。
- Admin Portal
- AGS CLI
-
管理ポータルのサイドバーで、Foundations > Legal & Privacy > Legal Documents に移動します。
-
Legal Documents ページで、既存のすべての法的文書のリストが表示されます。ポリシーを追加したい文書を選択し、Document Name 列の名前をクリックします。
-
Legal Document Details ページで、選択した法的文書の詳細情報と、その文書に関連する国固有およびグループポリシーのリストが表示されます。新しいポリシーを作成するには、+ Create Policy ボタンをクリックします。
-
表示される Policy Creation フォームで、必須フィールドに入力します:
- Policy Type:
- 単一の特定の国のポリシーを作成するには、Country-Specific を選択します。
- Country: このポリシーを適用したい 1 つの国を選択します。
- 複数の国のポリシーを作成するには、Group を選択します。
- Group Name で国グループに名前を付けます。例:North America、Europe。
- Country でこのポリシーを適用したい国を選択します。複数の国を選択でき、他のポリシーで既に選択されている国はオプションに表示されません。
- 単一の特定の国のポリシーを作成するには、Country-Specific を選択します。
作成したポリシーページにリダイレクトされます。
- Policy Type:
-
このポリシーをデフォルトとして設定するには、Set as Default ボタンをクリックします。
-
プラットフォームの使用を継続する前にプレイヤーがこのポリシーを受け入れる必要がある場合は、Mandatory Update チェックボックスを選択します。
-
法的文書の ID を確認します:
ags legal base-policies list --namespace <YourNamespace>出力の
basePolicyNameで対象の文書を探し、そのidを控えておきます。 -
文書の現在の設定をファイルに書き出します。
<BasePolicyId>を文書 ID に置き換えます:ags legal base-policies get --namespace <YourNamespace> --base-policy-id <BasePolicyId> --format json > document.json -
document.jsonに、新しいポリシーのフィールドを追加します:-
国固有のポリシーの場合は、国コードを追加し、
countryTypeをCOUNTRYに設定します:"affectedCountries": ["JP"],
"countryType": "COUNTRY" -
グループポリシーの場合は、国コードを追加し、
countryTypeをCOUNTRY_GROUPに設定して、グループに名前を付けます。グループ名は 3~50 文字で指定する必要があります。"affectedCountries": ["FR", "DE"],
"countryType": "COUNTRY_GROUP",
"countryGroupName": "<GroupName>"
すでに独自のポリシーを持つ国はスキップされます。更新時にはその他のフィールドも再送信されるため、それらのフィールドは変更せずにそのまま残してください。
-
-
ポリシーを作成します:
ags legal base-policies update --namespace <YourNamespace> --base-policy-id <BasePolicyId> --json @document.json -
新しいポリシーの ID を確認します:
ags legal base-policies get --namespace <YourNamespace> --base-policy-id <BasePolicyId>出力の
policiesリストで、countryCode(グループポリシーの場合はcountryGroupName)で対象のポリシーを探します。そのidとpolicyNameを控えておきます。 -
このポリシーをデフォルトとして設定するには、以下のコマンドを実行します。
<PolicyId>をポリシー ID に置き換えます:ags legal policies set-default --namespace <YourNamespace> --policy-id <PolicyId> -
プレイヤーにこのポリシーへの同意を必須にするには、Mandatory Update を有効にします。
<PolicyName>をステップ 5 で確認したpolicyNameに置き換えます。無効にするには、isMandatoryをfalseに設定します。ags legal policies update --namespace <YourNamespace> --policy-id <PolicyId> \
--json '{"policyName": "<PolicyName>", "isMandatory": true}'注記管理ポータルと同様に、このコマンドは
isDefaultOptedとshouldNotifyOnUpdateもfalseに設定し、ポリシーの説明をクリアします。
法的文書のポリシーバージョンの管理
このセクションでは、AGS 管理ポータルまたは AGS CLI で法的文書のポリシーバージョンを作成および更新する方法を説明します。
文書の新しいバージョンの作成
ポリシーを作成した後、文書が改訂されるたびに新しいバージョンを追加できます。文書の新しいバージョンを作成するには、以下の手順に従います:
- Admin Portal
- AGS CLI
-
管理ポータルのサイドバーで、Foundations > Legal & Privacy > Legal Documents に移動します。
-
Legal Documents ページで、既存のすべての法的文書のリストが表示されます。新しいバージョンを追加したい文書を選択し、その横の Action 列にある View をクリックします。
-
Legal Document Details ページで、選択した法的文書の詳細情報と、その文書に関連するポリシーのリストが表示されます。ポリシーの新しいバージョンを作成するには、バージョンを追加したいポリシーの横の Action 列にある View をクリックします。
-
選択したポリシーの Policy Details ページで、ポリシーとその既存のバージョンに関する情報が表示されます。文書の新しいバージョンを作成するには、+ Create a Version ボタンをクリックします。
-
表示される Create Version フォームで、Version Name フィールドに新しいバージョンの名前を入力します。
-
Create ボタンをクリックします。新しい文書バージョンが作成されます。
-
文書バージョンにコンテンツを追加するには、そのバージョンの Action 列にある View をクリックします。
-
Version Details ページで、選択した文書バージョンの詳細情報が表示されます。このバージョンにコンテンツを追加するには、Create New ボタンをクリックします。
-
表示される Create Locale フォームで、Locale ドロップダウンから文書の言語を選択します。次に、Browse ボタンをクリックして、コンピュータ上の文書を見つけてアップロードします。ファイルは
.mdまたは.htmlファイルである必要があります。 -
Create ボタンをクリックします。選択したファイルがアップロードされます。
-
法的文書の ID を確認します:
ags legal base-policies list --namespace <YourNamespace>出力の
basePolicyNameで対象の文書を探し、そのidを控えておきます。 -
ポリシーの ID を確認します。
<BasePolicyId>を文書 ID に置き換えます:ags legal base-policies get --namespace <YourNamespace> --base-policy-id <BasePolicyId>出力の
policiesリストで、countryCode(グループポリシーの場合はcountryGroupName)で対象のポリシーを探し、そのidを控えておきます。 -
バージョンを作成します。
<PolicyId>をポリシー ID に、<VersionName>をバージョンの名前に置き換えます:ags legal versions create --namespace <YourNamespace> --policy-id <PolicyId> \
--json '{"displayVersion": "<VersionName>", "description": "", "isCommitted": true}'コマンドを実行すると、
idを含む新しいバージョンが出力されます。 -
文書のコンテンツは管理ポータルで追加します。AGS CLI には文書ファイルをアップロードするコマンドがありません。Admin Portal タブで、ステップ 1~4 に従ってポリシーを開き、次にステップ 7~10 に従って新しいバージョンにファイルをアップロードします。
文書バージョンの編集
-
管理ポータルのサイドバーで、Foundations > Legal & Privacy > Legal Documents に移動します。
-
Legal Documents ページで、既存のすべての法的文書のリストが表示されます。新しいバージョンを追加したい文書を選択し、その横の Action 列にある View をクリックします。
-
Legal Document Details ページで、選択した法的文書の詳細情報と、その文書に関連するポリシーのリストが表示されます。編集したい文書のバージョンを含むポリシーの横の Action 列にある View をクリックします。
-
選択したポリシーの Policy Details ページで、ポリシーとその既存のバージョンに関する情報が表示されます。バージョンを編集するには、そのバージョンの Action 列にある View をクリックします。
-
Version Details ページで、ページの左側にあるテキストエディタを使用して編集を行います。右側のテキストボックスには、変更が公開された後の見た目が表示されます。
-
完了したら、Save をクリックします。
ポリシーバージョンの公開
- Admin Portal
- AGS CLI
-
管理ポータルのサイドバーで、Foundations > Legal & Privacy > Legal Documents に移動します。
-
Legal Documents ページで、更新したい法的文書を見つけ、その名前をクリックして詳細ページを開きます。
-
文書の詳細ページで、Policy セクションまでスクロールします。
-
文書のポリシーのリストから、更新したいポリシーを見つけ、その View オプションをクリックします。ポリシーの詳細ページが表示されます。
-
Versions セクションで、公開したいバージョンを見つけます。その省略記号メニューをクリックし、PUBLISH をクリックします。
-
確認メッセージで、PUBLISH と入力し、ポリシー更新についてメールでプレイヤーに通知したい場合は Notify users チェックボックスを選択します。
-
Publish ボタンをクリックします。新しいバージョンが公開されます。
-
法的文書の ID を確認します:
ags legal base-policies list --namespace <YourNamespace>出力の
basePolicyNameで対象の文書を探し、そのidを控えておきます。 -
ポリシーの ID を確認します。
<BasePolicyId>を文書 ID に置き換えます:ags legal base-policies get --namespace <YourNamespace> --base-policy-id <BasePolicyId>出力の
policiesリストで、countryCode(グループポリシーの場合はcountryGroupName)で対象のポリシーを探し、そのidを控えておきます。 -
バージョンの ID を確認します。
<PolicyId>をポリシー ID に置き換えます:ags legal versions list --namespace <YourNamespace> --policy-id <PolicyId>出力の
displayVersionで対象のバージョンを探し、そのidを控えておきます。 -
バージョンを公開します。
<PolicyVersionId>をバージョン ID に置き換えます。ポリシーの更新をメールでプレイヤーに通知するには、--should-notifyをtrueに設定します。ags legal versions publish --namespace <YourNamespace> --policy-version-id <PolicyVersionId> --should-notify false
文書バージョンの削除
- Admin Portal
- AGS CLI
-
管理ポータルのサイドバーで、Foundations > Legal & Privacy > Legal Documents に移動します。
-
Legal Documents ページで、既存のすべての法的文書のリストが表示されます。バージョンを削除したい文書を選択し、その横の Action 列にある View をクリックします。
-
Legal Document Details ページで、選択した法的文書の詳細情報と、その文書に関連するポリシーのリストが表示されます。削除したい文書のバージョンを含むポリシーの横の Action 列にある View をクリックします。
-
選択したポリシーの Policy Details ページで、ポリシーとその既存のバージョンに関する情報が表示されます。バージョンを削除するには、そのバージョンの Action 列にある Delete をクリックします。
-
Confirm ボタンをクリックします。バージョンが削除されます。
-
法的文書の ID を確認します:
ags legal base-policies list --namespace <YourNamespace>出力の
basePolicyNameで対象の文書を探し、そのidを控えておきます。 -
ポリシーの ID を確認します。
<BasePolicyId>を文書 ID に置き換えます:ags legal base-policies get --namespace <YourNamespace> --base-policy-id <BasePolicyId>出力の
policiesリストで、countryCode(グループポリシーの場合はcountryGroupName)で対象のポリシーを探し、そのidを控えておきます。 -
バージョンの ID を確認します。
<PolicyId>をポリシー ID に置き換えます:ags legal versions list --namespace <YourNamespace> --policy-id <PolicyId>出力の
displayVersionで対象のバージョンを探し、そのidを控えておきます。 -
バージョンを削除します。
<PolicyVersionId>をバージョン ID に置き換えます。確認を求められたら、削除を確定します。ags legal versions delete --namespace <YourNamespace> --policy-version-id <PolicyVersionId>