実績を統合する

実績を作成する

新しい未公開のゲームの実績を作成する手順は次のとおりです。

1. Google Play Console でゲームを選択します。
2. [Play Games サービス - 実績] ページ（[ユーザーを増やす] > [Play Games サービス] > [設定と管理] > [実績] ）で、[実績を作成] を選択します。
3. [実績を追加] ページで、フォームに入力します。
4. [未公開として保存] をクリックします。
5. 実績の作成を完了したら、実績を 公開する必要があります。

実績をインポートする

ゲームに一度に複数の実績を追加する手順は次のとおりです。

1. 実績を含む ZIP ファイルを作成します。
2. ファイルをアップロードします。

ZIP ファイルについて詳しくは、 ZIP ファイルのガイドラインをご覧ください。

実績をインポートするには:

1. Google Play Console でゲームを選択します。
2. [Play Games サービス - 実績] ページ（[ユーザーを増やす] > [Play Games サービス] > [設定と管理] > [実績] ）で、[実績をインポート] を選択します。
3. [実績のインポート] ページで、[アップロード] をクリックします。
4. アップロードする ZIP ファイルを選択します。
5. [未公開として保存] をクリックします。
6. 実績のインポートを完了したら、ゲームを公開する必要があります 。

ZIP ファイルのガイドライン

ZIP ファイルを使用して複数の実績を一度にインポートできます。ZIP ファイルで使用する正確なファイル名については、以下の表をご覧ください。

ZIP ファイルの要件:

• サブディレクトリがない。
• 一意のファイル名。
• CSV、PNG、JPEG、JPG 形式のファイルのみ。
• CSV ファイルにヘッダー行を含めることはできません。
• 各ファイルのサイズを 1 MB 未満にする必要がある。
• ZIP ファイルに含めるファイル数は 403 個以下にする必要があります。
• ZIP ファイルの合計サイズは 800 MB 未満にする必要がある。

AchievementsMetadata.csv 形式

AchievementsMetadata.csv ファイルには、各実績のメタデータが含まれています。情報はカンマ区切り値として、次の順序で指定する必要があります。

    Name,Description,Incremental value,Steps Needed,Initial State,Points,List Order

各フィールドについては、以下の表をご覧ください。

AchievementsMetadata.csv ファイルの要件:

• 各行には 7 つの値が必要です。値を省略する場合は、 空白にします。
• Name と Description のフィールドはデフォルトの言語 / 地域として使用されます。
• Name フィールドは、すべての実績で一意である必要があります。
• 次のフィールドにカンマを含めることはできません: Name、 Description。

AchievementsMetadata.csv ファイルのサンプル:

  Achievement1,Achievement One,True,100,Hidden,5,20
  Achievement2,Achievement Two,False,,Revealed,10,30

AchievementsLocalizations.csv 形式

AchievementsLocalizations.csv ファイルは省略可能です。各実績をさまざまな言語 / 地域のユーザーに説明するために必要なすべてのデータを設定します。実績は、ゲームに指定された言語 / 地域に合わせて翻訳されます。

情報はカンマ区切り値として、次の順序で指定する必要があります。

   Name, Localized name, Localized description, locale

各フィールドについては、以下の表をご覧ください。

AchievementsLocalizations.csv ファイルの要件:

• ゲーム内の実績の名前は言語 / 地域ごとに一意である必要があります。

  たとえば、ゲームが en-US と fr-FR の両方の言語 / 地域コードをサポートしている場合、en-US で「Achievement1」という名前の実績には、fr-FR でも「Achievement1」という名前を付けることができます。

• 各行に 4 つの値が必要です。「Localized description」の値を省略する場合は、空白のままにします。

AchievementsLocalizations.csv ファイルのサンプル:

Achievement1,Achievement One,This is the description of achievement one in English.,en-US
Achievement1,Achievement Un,Voici la description de l'achievement un en français.,fr-FR
Achievement2,Achievement Two,Description of achievement two.,en-US
Achievement2,Logro Dos,Descripción del logro dos.,es-ES
Achievement3,Achievement Three,,en-US
Achievement3,Erfolg Drei,,de-DE

AchievementsIconsMappings.csv 形式

AchievementsIconsMappings.csv ファイルは省略可能です。実績を所定のアイコンとマッピングする場合に使用します。情報はカンマ区切り値として、次の順序で指定する必要があります。

Name, icon filename

各フィールドについては、以下の表をご覧ください。

AchievementsIconsMappings.csv ファイルの要件:

• 各行に 2 つの値が必要です。
• アイコン ファイルとして指定できるのは、PNG 形式または JPEG 形式のみです。

AchievementsIconsMappings.csv ファイルのサンプル:

Valid Achievement,valid-achievement-icon.png
Incremental Achievement,incremental-achievement-icon.jpeg
No Description,no-description-icon.png
Hidden Initial State,hidden-initial-state-icon.png
Large Point Value,large-point-value-icon.jpeg

アイコンのガイドライン

アイコンは、512 x 512 の PNG、JPEG、または JPG ファイルとして作成する必要があります。提供する必要があるアイコンは、ロックが解除された実績のアイコンのみです。表示のアイコンについてはグレースケール バージョンが自動的に生成されます。そのため、表示されている実績とロックが解除された実績とをユーザーが区別できるよう、実績のアイコンにはカラフルな要素を取り入れることをおすすめします。

Android [トースト][a]で実績アイコンを表示すると、アイコンは円で囲まれ、外側の角は表示されなくなります。このような状況でもアイコンが適切に表示されるようにしてください。

すべての言語 / 地域で同じアイコンが使用されるため、アイコンにテキストやローカライズされたコンテンツを含めることはおすすめしません。

アイコン ファイル

AchievementsIconsMappings.csv ファイルで参照するアイコンは、インポートする現在の ZIP アーカイブに含まれている必要があります。

実績を編集する

既存の実績を編集する手順は次のとおりです。

1. Google Play Console でゲームを選択します。
2. [Play Games サービス - 実績] ページ（[ユーザーを増やす] > [Play Games サービス] > [設定と管理] > [実績]）で、実績を選択します。
3. 任意のフィールドを編集できます。
4. [未公開として保存] をクリックします。
5. [Play Games サービス - 実績] ページで、編集した 実績が [テスターが利用可能] ステータスになります。
6. 実績をテストしたら、[確認して公開] をクリックします。

   これにより、更新したすべての実績と一緒にゲームが再公開されます。

実績を削除する

いったん公開した実績は削除できません 。 公開前の状態であれば、実績を削除できます。

1. [Play Games サービス - 実績] ページで、実績を選択します。
2. 実績を削除するには、[実績を削除] をクリックします。

実績をリセットする

未公開の実績であれば、プレーヤーの進行状況のデータをリセットできます。

1. [Play Games サービス - 実績] ページで、実績を選択します。
2. 実績をリセットするには、[進行状況をリセット] をクリックします。
3. 実績データをプログラムでリセットするには、 Management API Achievements メソッドを呼び出します。