Skip to main content
ロケールとは、ユーザープロパティのフィルターで構成された名前付きのオーディエンス定義であり、言語、文化、リージョンに合わせてキャンペーンメッセージをローカライズするために使用します。たとえば、es-MX という名前のロケールは、最後に確認された国がメキシコであるユーザーを対象にすることができます。 MoEngage Locales API を使用すると、ワークスペースで設定されているロケールを一覧表示し、名前または ID で単一のロケールを検索できます。ロケールを作成または編集するには、MoEngage ダッシュボードを使用してください。詳細については、Locales を参照してください。

​
エンドポイント

Locales API は、次のエンドポイントで構成されています。
  • 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 を参照してください。

​
ページネーション

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

​
よくある質問

​
ロケールの管理

いいえ。このエンドポイントは読み取り専用です。ロケールの作成と編集は MoEngage ダッシュボードから行ってください。詳細については、Locales を参照してください。
List Locales に name または id のいずれかを渡します。両方を指定すると 400 エラーが返されます。両方を省略すると、ワークスペース内のすべてのロケールが一覧表示されます。
いいえ。ワークスペースで作成できるロケールの数に制限はありません。
いいえ。ロケール名はワークスペース内で一意であるため、正確な名前でロケールを検索できます。

​
レスポンスについて

現在そのロケールを使用しているキャンペーンの数です。これは、ダッシュボードの Locales ページにある Campaigns associated 列と一致します。
ロケールはユーザープロパティのフィルターによって定義され、MoEngage はそれをカスタムセグメントとして保存します。custom_segment_id はそのセグメントを識別します。カスタムセグメントを持つロケールの場合にのみ返されます。

​
関連コンテンツ

  • Locales: MoEngage ダッシュボードからロケールを追加および管理します。
  • Localize Campaign Messages: ロケールを使用して、ユーザーの言語でキャンペーンコンテンツを配信します。

​
Postman コレクション

事前設定済みの Postman コレクションを使用して、このエンドポイントをテストできます: MoEngage Locales コレクションを表示。