> ## Documentation Index
> Fetch the complete documentation index at: https://moengage.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Locales の概要

> ワークスペースで設定されているロケールを一覧表示し、名前または ID で単一のロケールを検索します。

ロケールとは、ユーザープロパティのフィルターで構成された名前付きのオーディエンス定義であり、言語、文化、リージョンに合わせてキャンペーンメッセージをローカライズするために使用します。たとえば、`es-MX` という名前のロケールは、最後に確認された国がメキシコであるユーザーを対象にすることができます。

MoEngage Locales API を使用すると、ワークスペースで設定されているロケールを一覧表示し、名前または ID で単一のロケールを検索できます。ロケールを作成または編集するには、MoEngage ダッシュボードを使用してください。詳細については、[Locales](/docs/ja/user-guide/settings/advanced-settings/locales) を参照してください。

## エンドポイント

Locales API は、次のエンドポイントで構成されています。

* [List Locales](/docs/ja/api/locales/list-locales): ワークスペース内のすべてのロケール、または名前か ID で指定した単一のロケールを返します。

## 認証

認証は Basic 認証で行います。認証には、`username:password` の形式で認証情報を Base64 エンコードした文字列が必要です。

* **Username**: MoEngage の Workspace ID（App ID とも呼ばれます）を使用します。MoEngage ダッシュボードの **Settings** > **Account** > **API keys** で確認できます。
* **Password**: **Settings** > **Account** > **API keys** の API キーを使用します。

API キーの作成と管理の詳細については、[API Key Dashboard](/docs/ja/user-guide/settings/account/api-and-api-keys/api-key-dashboard) を参照してください。

## ページネーション

一覧のレスポンスでは、1 ページあたり最大 20 件のロケールが返されます。`pagination.has_more` が `true` の場合は、`pagination.next_cursor` を `cursor` クエリパラメーターとして渡して次のページを取得します。カーソルは不透明な値として扱い、デコードや変更は行わないでください。

## よくある質問

### ロケールの管理

<AccordionGroup>
  <Accordion title="この API でロケールを作成または編集できますか？">
    いいえ。このエンドポイントは読み取り専用です。ロケールの作成と編集は MoEngage ダッシュボードから行ってください。詳細については、[Locales](/docs/ja/user-guide/settings/advanced-settings/locales) を参照してください。
  </Accordion>

  <Accordion title="単一のロケールを検索するにはどうすればよいですか？">
    [List Locales](/docs/ja/api/locales/list-locales) に `name` または `id` のいずれかを渡します。両方を指定すると `400` エラーが返されます。両方を省略すると、ワークスペース内のすべてのロケールが一覧表示されます。
  </Accordion>

  <Accordion title="作成できるロケールの数に制限はありますか？">
    いいえ。ワークスペースで作成できるロケールの数に制限はありません。
  </Accordion>

  <Accordion title="2 つのロケールに同じ名前を付けることはできますか？">
    いいえ。ロケール名はワークスペース内で一意であるため、正確な名前でロケールを検索できます。
  </Accordion>
</AccordionGroup>

### レスポンスについて

<AccordionGroup>
  <Accordion title="campaign_count は何を示していますか？">
    現在そのロケールを使用しているキャンペーンの数です。これは、ダッシュボードの Locales ページにある **Campaigns associated** 列と一致します。
  </Accordion>

  <Accordion title="custom_segment_id とは何ですか？">
    ロケールはユーザープロパティのフィルターによって定義され、MoEngage はそれをカスタムセグメントとして保存します。`custom_segment_id` はそのセグメントを識別します。カスタムセグメントを持つロケールの場合にのみ返されます。
  </Accordion>
</AccordionGroup>

## 関連コンテンツ

* [Locales](/docs/ja/user-guide/settings/advanced-settings/locales): MoEngage ダッシュボードからロケールを追加および管理します。
* [Localize Campaign Messages](/docs/ja/user-guide/campaigns-and-channels/getting-started/campaign-content/localize-campaign-messages): ロケールを使用して、ユーザーの言語でキャンペーンコンテンツを配信します。

## Postman コレクション

事前設定済みの Postman コレクションを使用して、このエンドポイントをテストできます: [MoEngage Locales コレクションを表示](https://www.postman.com/moengage-dev/api-docs/collection/q8t2fuz/moengage-locale-list-api-v5?action=share\&source=copy-link\&creator=3486165)。