> ## Documentation Index
> Fetch the complete documentation index at: https://devdocs.xbox.com/llms.txt
> Use this file to discover all available pages before exploring further.
# Title News クイックスタート
> タイトル、本文、日付、ステータス、言語のフィールドを持つローカライズされた PlayFab Title News 投稿を作成・公開し、パッチ ノートやイベントの更新をプレイヤーと共有します。
Title News は、パッチ ノートやゲームで開催する大きなイベントについてプレイヤーとコミュニケーションを取るためのメカニズムです。これには次のようないくつかの基本要素が含まれています:
* **Date**
* **Status**
* **Title**
* **Body**
* **Language(s)**
Body 要素は、生のテキストまたは JSON を含むことができる文字列です。
## 要件
このクイックスタートは、他のトピックで提示された情報に基づいています。ご質問がある場合は、以下のトピック リンクを参照してください。
* PlayFab の [Game Manager](/services/playfab/live-service-management/gamemanager/quickstart) に慣れている必要があります。
ローカライズされた title news を続行するには、**タイトルの既定の言語** を既に設定している必要があります。
* タイトル ニュースをローカライズできるようになりました。タイトルの既定の言語とプレイヤーの優先言語の操作の詳細については、[既定の言語の設定](/services/playfab/live-service-management/game-configuration/title-communications/news/setting-default-languages) チュートリアルを確認してください。ローカライズされたタイトル ニュースを続けるには、それに応じて **タイトルの既定の言語** を設定する必要があります。
PlayFab は、タイトル ニュース エントリのタイトルと本文を言語と関連付けることで、ゲーム開発者に代わってローカライズされた文字列の保存をサポートします。
プレイヤーが優先する言語の正しい文字列を提供するのに必要なロジックを追加しました。クライアントがタイトル ニュースを照会すると、プレイヤーの優先言語に基づいて異なるバージョンのタイトル ニュースを受け取ります。単一のタイトル ニュース エントリに複数の翻訳バージョンを追加できます。
## Title News エントリの作成
Title News エントリを作成する方法は 2 つあります:
1. Game Manager 経由。
2. Admin API メソッド [AddNews](xref:titleid.playfabapi.com.admin.title-widedatamanagement.addnews) を使用。
### Game Manager でタイトル ニュースを作成する
**Game Manager** でタイトル ニュース エントリを作成するには:
以下の画像に示されているように、Title -> **Content** -> **Title News** -> **New Title News** に移動します。
このチュートリアルでは、タイトルの既定の言語が英語であると仮定します。これは、タイトル ニュースを保存する前に既定の言語の文字列を追加する必要があることを意味します。
さらに言語を追加するのは簡単で、**ADD LANGUAGE** をクリックし、追加する言語を選択して、ローカライズされた文字列を入力するだけです。**Save Title News** ボタンを選択すると、エントリが作成されます。
タイムスタンプは、プレイヤーがタイトル ニュースの隣に見る時間です。タイムスタンプは、**Save Title News** ボタンを選択した瞬間に自動的にシステム日時に設定されますが、手動で設定 *することも* できます。タイトル ニュース ページを保存した後、タイトル ニュース エントリのリストを含むページにリダイレクトされます。
### PlayFab Admin API を使用してタイトル ニュースを作成する
[AddNews](xref:titleid.playfabapi.com.admin.title-widedatamanagement.addnews) メソッドを呼び出すことでタイトル ニュースを作成できます。この Admin API を使用すると、カスタム タイムスタンプを指定できます。この方法で追加されたニュースは *即座に* 公開されます。次に、`AddNews` メソッドから返されたニュース ID を使って [AddLocalizedNews](xref:titleid.playfabapi.com.admin.title-widedatamanagement.addlocalizednews) を呼び出すことで、今作成した項目にローカライズされたコンテンツを追加できます。
次のコード例はこれを示しています。
```csharp theme={null}
void CreateNews() {
PlayFabAdminAPI.AddNews(new AddNewsRequest {
Timestamp = new DateTime(2014, 1, 8, 12, 0, 0), // Any date - This one is the founding of PlayFab
Title = "My Second News",
Body = "This is my second news post."
},
result => Debug.Log("News post added!"),
error => Debug.LogError(error.GenerateErrorReport()));
}
void CreateNews() {
PlayFabAdminAPI.AddLocalizedNewsRequest(new AddLocalizedNewsRequest{
NewsId = "74623b12-6c80-ee4b-7c3b-58e638aa62bd",
Language = "de"
Title = " Meine zweite Nachricht",
Body = " Dies ist meine zweite Nachricht."
},
result => Debug.Log("Localized news post added!"),
error => Debug.LogError(error.GenerateErrorReport()));
}
```
## タイトル ニュースの読み取り
`GetTitleNews` メソッドを使うと、タイトル ニュースの読み取りが非常に簡単になります。このメソッドは公開されているすべてのタイトル ニュース エントリを返し、アーカイブされているエントリや未公開のエントリは返しません。
* クライアント API から [GetTitleNews](xref:titleid.playfabapi.com.client.title-widedatamanagement.gettitlenews) を呼び出すと、タイトル ニュース アイテムがその言語にローカライズされたコンテンツを持っている場合はプレイヤーの優先言語で、そうでない場合はタイトルの既定の言語でニュース エントリが返されます。
* サーバー API から [GetTitleNews](xref:titleid.playfabapi.com.server.title-widedatamanagement.gettitlenews) を呼び出すと、タイトルの既定の言語でニュース エントリが返されます。
```csharp theme={null}
// Using the Client API method
void ReadTitleNews() {
PlayFabClientAPI.GetTitleNews(new GetTitleNewsRequest(), result => {
Debug.Log("Got latest news!");
// Process news using result.News
}, error => Debug.LogError(error.GenerateErrorReport()));
}
// Using the Server API method
void ReadTitleNews() {
PlayFabServerAPI.GetTitleNews(new GetTitleNewsRequest(), result => {
Debug.Log("Got latest news!");
// Process news using result.News
}, error => Debug.LogError(error.GenerateErrorReport()));
}
```
## 既存のタイトル ニュース エントリの更新
タイトル ニュース エントリの内容は Game Manager でのみ変更できます。
**Game Manager** で、変更したいエントリを見つけて選択するには:
* 左のメニューに移動して **Content** を選択します。
* **Title News** タブに移動します。
* **Existing Entry** を選択します。
更新して保存し、必要に応じてローカライズされたバージョンを追加するには:
* エントリの **Title**、**Status**、または **Data** を更新します。
* **Save Title News** ボタンを選択します。
* 1 つの言語のタイトルと本文しかないタイトル ニュース エントリを更新している場合は、**Add Language** を選択してこのタイトル ニュースのローカライズされたバージョンを追加できるようになります。
将来のリリース用に未公開エントリを投稿する予定がある場合、これがそれらを公開状態やアーカイブ状態に移行する方法になります。タイトル ニュースを更新すると、誤字の修正もできます。
## タイトル ニュースの削除
エントリが不要になったら、**Game Manager** で削除できます。
変更したいエントリを見つけて、次を行います:
* **Title** に移動します。
* 左のメニューで **Content** を選択します。
* **Title News** に移動します。
* **Existing Entry** のチェックボックスにチェックを入れます。
* 削除したい **Title News** エントリを選択して **X Delete Title News** を選択します。
## Related topics
- [クイックスタート](/ja-jp/services/playfab/economy-monetization/economy-v2/quickstart.md)
- [Title Data クイックスタート](/ja-jp/services/playfab/live-service-management/game-configuration/titledata/quickstart.md)
- [Photon クイックスタート](/ja-jp/services/playfab/live-service-management/service-gateway/add-ons/photon/quickstart.md)
- [Telemetry Key クイックスタート](/ja-jp/services/playfab/data-analytics/ingest-data/telemetry-keys-qs.md)
- [統計情報のクイックスタート](/ja-jp/services/playfab/player-progression/statistics/quickstart-statistics.md)