UserFacingMessage
透過集合功能整理內容
你可以依據偏好儲存及分類內容。
提供向使用者顯示的訊息,內含語言代碼資訊。訊息長度上限為 4096 個字元。
JSON 表示法 |
{
"localizedMessages": {
string: string,
...
},
"defaultMessage": string
} |
欄位 |
localizedMessages |
map (key: string, value: string)
包含 <locale, message> 的地圖語言組合,其中語言代碼是格式正確的 BCP 47 語言代碼,例如 en-US、es-ES 或 fr。 這個物件中包含 "key": value 組合的清單,範例:{ "name": "wrench", "mass": "1.3kg", "count": "3" } 。
|
defaultMessage |
string
如未指定本地化訊息,或是使用者的語言代碼與本地化訊息不符,系統就會顯示預設訊息。如有提供任何本地化訊息,就必須提供預設訊息。
|
除非另有註明,否則本頁面中的內容是採用創用 CC 姓名標示 4.0 授權,程式碼範例則為阿帕契 2.0 授權。詳情請參閱《Google Developers 網站政策》。Java 是 Oracle 和/或其關聯企業的註冊商標。
上次更新時間:2025-07-26 (世界標準時間)。
[null,null,["上次更新時間:2025-07-26 (世界標準時間)。"],[[["\u003cp\u003eThe JSON representation is used to provide user-facing messages with locale information, with a maximum length of 4096 characters.\u003c/p\u003e\n"],["\u003cp\u003eIt includes \u003ccode\u003elocalizedMessages\u003c/code\u003e, a map of locale codes and corresponding messages, and \u003ccode\u003edefaultMessage\u003c/code\u003e for fallback display.\u003c/p\u003e\n"],["\u003cp\u003eA well-formed BCP 47 language code is used for locale specification, and a default message is required if localized messages are provided.\u003c/p\u003e\n"]]],["The content defines a JSON structure for user-facing messages with locale support. It includes `localizedMessages`, a map where keys are BCP 47 language codes and values are translated messages. The `defaultMessage` field is a string providing a fallback message when no matching locale is found. `localizedMessages` holds key-value message pairs, and a default message is required if there are any localized ones. The maximum message length is 4096 characters.\n"],null,["# UserFacingMessage\n\n- [JSON representation](#SCHEMA_REPRESENTATION)\n\nProvides a user-facing message with locale info. The maximum message length is 4096 characters.\n\n| JSON representation |\n|------------------------------------------------------------------------------------|\n| ``` { \"localizedMessages\": { string: string, ... }, \"defaultMessage\": string } ``` |\n\n| Fields ||\n|---------------------|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `localizedMessages` | `map (key: string, value: string)` A map containing \\\u003clocale, message\\\u003e pairs, where locale is a well-formed [BCP 47 language](https://www.w3.org/International/articles/language-tags/) code, such as en-US, es-ES, or fr. An object containing a list of `\"key\": value` pairs. Example: `{ \"name\": \"wrench\", \"mass\": \"1.3kg\", \"count\": \"3\" }`. |\n| `defaultMessage` | `string` The default message displayed if no localized message is specified or the user's locale doesn't match with any of the localized messages. A default message must be provided if any localized messages are provided. |"]]