- ייצוג JSON
- ExpectedInput
- InputPrompt
- SpeechResponse
- RichResponse
- פריט
- SimpleResponse
- BasicCard
- לחצן
- StructuredResponse
- OrderUpdate
- פעולה
- קבלה
- RejectionInfo
- CancellationInfo
- InTransitInfo
- FulfillmentInfo
- ReturnInfo
- UserNotification
- MediaResponse
- MediaObject
- CarouselBrowse
- פריט
- TableCard
- ColumnProperties
- שורה
- תא
- HtmlResponse
- הצעה
- LinkOutSuggestion
- ExpectedIntent
- FinalResponse
- CustomPushMessage
- UserNotification
- טירגוט
AppResponse היא התשובה שנשלחה אל Google Assistant על ידי מילוי הבקשה. בכתובת https://developers.google.com/assistant/df-asdk/reference/conversation-webhook-json#conversation-response-body תוכלו לראות דוגמאות לשימוש הזה ב-Actions on Google.
ייצוג JSON | |
---|---|
{ "conversationToken": string, "userStorage": string, "resetUserStorage": boolean, "expectUserResponse": boolean, "expectedInputs": [ { object ( |
שדות | |
---|---|
conversationToken |
אסימון אטום שמופץ מחדש לפעולה בכל שיחה. |
userStorage |
אסימון אטום שנשלט על ידי הפעולה, ומופיע בכל השיחות של משתמש מסוים. אם האסימון ריק או לא צוין, האסימון הקבוע הקיים לא ישתנה. הגודל המרבי של המחרוזת הוא 10,000 בייטים. אם מספר תיבות דו-שיח מופיעות בו-זמנית לגבי אותו משתמש, העדכונים באסימון הזה עשויים להחליף זה את זה באופן בלתי צפוי. |
resetUserStorage |
האם לנקות את ה-userStorage הקבוע. אם המדיניות מוגדרת כ-True, באינטראקציה הבאה עם המשתמש, השדה userStorage יהיה ריק. |
expectUserResponse |
שדה זה מציין אם הפעולה מצפה לתגובת משתמש. התנאי הזה נכון גם כשהשיחה מתמשכת. לא נכון כשהשיחה מסתיימת. |
expectedInputs[] |
רשימת סוגי הקלט שהפעולה מצפה להם. כל קלט יכול להיות פעולות נפוצות ב-Google Intent (מתחילים ב-'actions.') או קלט שכולל רשימה של כוונות אפשריות. בשלב זה יש תמיכה בקלט אחד בלבד. |
finalResponse |
תגובה סופית כאשר הפעולה לא מצפה לקלט מהמשתמש. |
customPushMessage |
הודעת Push בהתאמה אישית שמאפשרת למפתחים לשלוח נתונים מובְנים לפעולות ב-Google. |
isInSandbox |
האפשרות מציינת אם יש לטפל בתגובה במצב ארגז חול. הביט הזה נחוץ כדי לדחוף נתונים מובנים ל-Google במצב ארגז חול. |
ExpectedInput
ייצוג JSON | |
---|---|
{ "inputPrompt": { object ( |
שדות | |
---|---|
inputPrompt |
ההנחיה בהתאמה אישית משמשת לבקשת קלט של המשתמש. |
possibleIntents[] |
רשימת כוונות שבהן ניתן להשתמש כדי למלא את הקלט הזה. כדי שפעולות ב-Google יחזירו רק את קלט המשתמש הגולמי, האפליקציה צריכה לבקש את ה-Intent |
speechBiasingHints[] |
רשימת ביטויים ש-Google רוצה ש-Google תשתמש בהם לצורך הטיית דיבור. אפשר להזין עד 1,000 ביטויים. |
InputPrompt
בקשת הקלט ל-Assistant כדי להדריך את המשתמש איך להזין קלט לשאלה באפליקציה.
ייצוג JSON | |
---|---|
{ "initialPrompts": [ { object ( |
שדות | |
---|---|
initialPrompts[] |
בקשות ראשוניות מהמשתמש להזין קלט. יש תמיכה רק ב-Initial_prompt אחד. |
richInitialPrompt |
המטען הייעודי (payload) של הבקשה. |
noInputPrompts[] |
בקשה שנשלחת מהמשתמש כשאין קלט מהמשתמש. |
SpeechResponse
תשובה שמכילה דיבור בלבד. הוצא משימוש.
ייצוג JSON | |
---|---|
{ // Union field |
שדות | ||
---|---|---|
שדה איחוד type . סוגים של פלט דיבור: המרת טקסט לדיבור או SSML. הערך של type יכול להיות רק אחת מהאפשרויות הבאות: |
||
textToSpeech |
טקסט פשוט של פלט הדיבור, למשל: "לאן אתה רוצה ללכת?"/ |
|
ssml |
תשובות קוליות מובנות למשתמש בפורמט SSML, למשל " |
RichResponse
תשובה עשירה שיכולה לכלול אודיו, טקסט, כרטיסים, הצעות ונתונים מובְנים.
ייצוג JSON | |
---|---|
{ "items": [ { object ( |
שדות | |
---|---|
items[] |
רשימה של רכיבי ממשק המשתמש שמרכיבים את התגובה על הפריטים לעמוד בדרישות הבאות: 1. הפריט הראשון חייב להיות |
suggestions[] |
רשימה של הצעות לתשובות. הם תמיד יופיעו בסוף התשובה. אם ייעשה בו שימוש ב- |
linkOutSuggestion |
צ'יפ של הצעה נוסף, שיכול לקשר לאפליקציה או לאתר המשויכים. |
פריט
פריטים בתשובה.
ייצוג JSON | |
---|---|
{ "name": string, // Union field |
שדות | ||
---|---|---|
name |
מזהה אופציונלי בעל שם של פריט זה. |
|
שדה איחוד item . סוג הפריט. הערך של item יכול להיות רק אחת מהאפשרויות הבאות: |
||
simpleResponse |
תשובה קולית וטקסט בלבד. |
|
basicCard |
כרטיס בסיסי. |
|
structuredResponse |
מטען ייעודי (payload) מובנה לעיבוד על ידי Google. |
|
mediaResponse |
תגובה שמציינת קבוצת מדיה להפעלה. |
|
carouselBrowse |
כרטיס עיון בקרוסלה, יש להשתמש ב-CollectionBrowse במקום זאת. |
|
tableCard |
כרטיס טבלה. |
|
htmlResponse |
תגובת HTML המשמשת לעיבוד בלוח הציור. |
SimpleResponse
תשובה פשוטה שכוללת דיבור או טקסט להצגה למשתמש.
ייצוג JSON | |
---|---|
{ "textToSpeech": string, "ssml": string, "displayText": string } |
שדות | |
---|---|
textToSpeech |
טקסט פשוט של פלט הדיבור, למשל: "לאן אתה רוצה ללכת?" בלעדי בו-זמנית עם ssml. |
ssml |
תשובות קוליות מובנות למשתמש בפורמט SSML, למשל |
displayText |
טקסט אופציונלי שיוצג בבועת הצ'אט. אם לא צוין, ייעשה שימוש ברינדור תצוגה של textToSpeech או ה-ssml שלמעלה. מוגבל ל-640 תווים. |
BasicCard
כרטיס בסיסי להצגת מידע מסוים, כמו תמונה או טקסט.
ייצוג JSON | |
---|---|
{ "title": string, "subtitle": string, "formattedText": string, "image": { object ( |
שדות | |
---|---|
title |
השם הכולל של הכרטיס. אפשרות. |
subtitle |
אפשרות. |
formattedText |
הטקסט של גוף הכרטיס. יש תמיכה בקבוצה מוגבלת של תחביר Markdown לעיצוב. חובה, אלא אם קיימת תמונה. |
image |
תמונה ראשית (Hero) של הכרטיס. הגובה קבוע ל-192dp. אפשרות. |
buttons[] |
לחצנים. בשלב זה יש תמיכה בלחצן אחד לכל היותר. אפשרות. |
imageDisplayOptions |
הסוג של אפשרות תצוגת התמונה. אפשרות. |
לחצן
אובייקט לחצן שמופיע בדרך כלל בחלק התחתון של כרטיס.
ייצוג JSON | |
---|---|
{
"title": string,
"openUrlAction": {
object ( |
שדות | |
---|---|
title |
הכותרת של הלחצן. חובה. |
openUrlAction |
פעולה שצריך לבצע כשמשתמש מקיש על הלחצן. חובה. |
StructuredResponse
התגובה שהוגדרה לאפליקציה להגיב באמצעות נתונים מובְנים.
ייצוג JSON | |
---|---|
{ // Union field |
שדות | ||
---|---|---|
שדה איחוד data . הקונטיינר של תגובת המטען הייעודי (payload) מסוכני צד שלישי. הערך של data יכול להיות רק אחת מהאפשרויות הבאות: |
||
orderUpdate |
האפליקציה מספקת עדכון הזמנה (לדוגמה, |
|
orderUpdateV3 |
אחרי קבלת ההזמנה, האפליקציה מספקת עדכון להזמנה בפורמט API v3. |
OrderUpdate
הוצא משימוש: יש להשתמש ב-V3 Proto במקום זאת. עדכון להזמנה.
ייצוג JSON | |
---|---|
{ "googleOrderId": string, "actionOrderId": string, "orderState": { object ( |
שדות | ||
---|---|---|
googleOrderId |
המזהה של ההזמנה הוא המזהה שהונפק על ידי Google. |
|
actionOrderId |
חובה. מזהה ההזמנה הקנוני שמתייחס להזמנה הזו. אם משלבים לא יוצרים את מזהה ההזמנה הקנוני במערכת שלהם, הם יכולים פשוט להעתיק את googleOrderId שכלול לפי הסדר. |
|
orderState |
המצב החדש של ההזמנה. |
|
orderManagementActions[] |
פעולות הניהול הרלוונטיות של ההזמנה עודכנו, למשל ניהול, שינוי ופנייה לתמיכה. |
|
receipt |
קבלה על ההזמנה. |
|
updateTime |
מועד העדכון של ההזמנה מנקודת המבט של האפליקציה. חותמת זמן בפורמט "זולו" RFC3339 UTC, מדויקת לננו-שניות. דוגמה: |
|
totalPrice |
המחיר הכולל החדש של ההזמנה |
|
lineItemUpdates |
מפה של השינויים ברמת הפריט, ממוספרים לפי מזהה הפריט. אפשרות. אובייקט שמכיל רשימה של |
|
userNotification |
אם צוין, מציג התראה למשתמש עם הכותרת והטקסט שצוינו. ציון התראה הוא הצעה לשליחת התראה, ולא בטוח שהתוצאה תהיה התראה. |
|
infoExtension |
נתונים נוספים על סמך מצב הזמנה בהתאמה אישית או בנוסף למידע על מצב רגיל. אובייקט שמכיל שדות מסוג שרירותי. שדה נוסף |
|
שדה איחוד info . מידע נוסף שמשויך למצב ההזמנה. הערך של info יכול להיות רק אחת מהאפשרויות הבאות: |
||
rejectionInfo |
מידע על מצב הדחייה. |
|
cancellationInfo |
מידע על מצב הביטול. |
|
inTransitInfo |
מידע על במצב מעבר. |
|
fulfillmentInfo |
מידע על מצב האספקה. |
|
returnInfo |
מידע על המצב המוחזר. |
פעולה
פעולת המשך שמשויכת לעדכון ההזמנה.
ייצוג JSON | |
---|---|
{ "type": enum ( |
שדות | |
---|---|
type |
סוג הפעולה. |
button |
תווית וקישור של לחצן. |
קבלה
הוצא משימוש: יש להשתמש ב-V3 Proto במקום זאת. קבלה כאשר המצב מאושר או בכל מדינה אחרת (למשל IN_TRANSIT, FULFILLED) כולל מצב ACHED.
ייצוג JSON | |
---|---|
{ "confirmedActionOrderId": string, "userVisibleOrderId": string } |
שדות | |
---|---|
confirmedActionOrderId |
מזהה ההזמנה אושר כשההזמנה התקבלה על ידי מבצע השילוב. זהו מזהה ההזמנה הקנוני, המשמש במערכת של מבצע השילוב ומפנה להזמנה. לאחר מכן, ניתן להשתמש בו כדי לזהות את ההזמנה בתור שימו לב שהשדה הזה הוצא משימוש. במקום זאת, יש להעביר את השדה דרך OrderUpdate.action_order_id. |
userVisibleOrderId |
אפשרות. המזהה שגלוי למשתמש שמתייחס להזמנה הנוכחית. אם קיים כרטיס כזה, הוא יופיע בכרטיס הקבלה. זהו המזהה שבדרך כלל מופיע על קבלה מודפסת או על קבלה שנשלחת לאימייל של המשתמש. צריכה להיות למשתמש אפשרות להשתמש במזהה הזה כאזכור להזמנה שלו לשירות לקוחות שמסופק על ידי מבצעי שילוב. לתשומת ליבכם, יש למלא את השדה הזה אם השילוב כן יוצר מזהה שמוצג למשתמש עבור הזמנה עם קבלה מודפסת או קבלה באימייל. |
RejectionInfo
פרטי הדחייה כשהמצב נדחה. אפשר לאכלס את ההודעה הזו בעדכון ההזמנה הראשוני בשיחה או בעדכון ההזמנה האסינכרוני הבא.
ייצוג JSON | |
---|---|
{
"type": enum ( |
שדות | |
---|---|
type |
סוג הדחייה. |
reason |
הסיבה לשגיאה. |
CancellationInfo
הוצא משימוש: יש להשתמש ב-V3 Proto במקום זאת. פרטי הביטול כשהמצב הוא CANCELLED.
ייצוג JSON | |
---|---|
{ "reason": string } |
שדות | |
---|---|
reason |
סיבת הביטול. |
InTransitInfo
הוצא משימוש: יש להשתמש ב-V3 Proto במקום זאת. נתוני המעבר כאשר המצב הוא IN_TRANSIT.
ייצוג JSON | |
---|---|
{ "updatedTime": string } |
שדות | |
---|---|
updatedTime |
מועד עדכון אחרון של הובלה. חותמת זמן בפורמט "זולו" RFC3339 UTC, מדויקת לננו-שניות. דוגמה: |
FulfillmentInfo
הוצא משימוש: יש להשתמש ב-V3 Proto במקום זאת. פרטי האספקה כשהמצב הוא FULFILLED.
ייצוג JSON | |
---|---|
{ "deliveryTime": string } |
שדות | |
---|---|
deliveryTime |
מתי ההזמנה תסופק. חותמת זמן בפורמט "זולו" RFC3339 UTC, מדויקת לננו-שניות. דוגמה: |
ReturnInfo
הוצא משימוש: יש להשתמש ב-V3 Proto במקום זאת. פרטי ההחזרה כשהמצב נדחה.
ייצוג JSON | |
---|---|
{ "reason": string } |
שדות | |
---|---|
reason |
סיבה להחזרה. |
UserNotification
הודעה אופציונלית שתוצג למשתמש כחלק מעדכון ההזמנה.
ייצוג JSON | |
---|---|
{ "title": string, "text": string } |
שדות | |
---|---|
title |
הכותרת של התראת המשתמש. |
text |
תוכן ההודעה. |
MediaResponse
התשובה שמציינת קבוצת מדיה שיש להפעיל בשיחה.
ייצוג JSON | |
---|---|
{ "mediaType": enum ( |
שדות | |
---|---|
mediaType |
סוג המדיה בתוך התשובה הזו. |
mediaObjects[] |
רשימת האובייקטים של המדיה. |
MediaObject
מייצג אובייקט מדיה אחד המוחזר באמצעות MediaResponse. מכילה מידע על המדיה, כמו שם, תיאור, כתובת URL וכו'.
ייצוג JSON | |
---|---|
{ "name": string, "description": string, "contentUrl": string, // Union field |
שדות | ||
---|---|---|
name |
השם של אובייקט המדיה הזה. |
|
description |
לתיאור של אובייקט המדיה הזה. |
|
contentUrl |
כתובת ה-URL שמפנה לתוכן המדיה. |
|
שדה איחוד image . תמונה שתוצג עם כרטיס המדיה. הערך של image יכול להיות רק אחת מהאפשרויות הבאות: |
||
largeImage |
תמונה גדולה, כמו עטיפת האלבום וכו' |
|
icon |
סמל תמונה קטן שמוצג משמאל לכותרת. הוא הוקטן ל-36x36dp. |
CarouselBrowse
הצגת קבוצת מסמכי AMP כקרוסלה של פריטי אריח גדול. ניתן לבחור פריטים כדי להפעיל את מסמך ה-AMP המשויך להם במציג AMP.
ייצוג JSON | |
---|---|
{ "items": [ { object ( |
שדות | |
---|---|
items[] |
מינימום: 2. מקסימום: 10. |
imageDisplayOptions |
הסוג של אפשרות תצוגת התמונה. אפשרות. |
פריט
פריט בקרוסלה.
ייצוג JSON | |
---|---|
{ "title": string, "description": string, "footer": string, "image": { object ( |
שדות | |
---|---|
title |
שם הפריט בקרוסלה. חובה. |
description |
תיאור של פריט הקרוסלה. אפשרות. |
footer |
הטקסט של הכותרת התחתונה של הפריט בקרוסלה, שמוצג מתחת לתיאור. שורת טקסט אחת קטועה עם שלוש נקודות. אפשרות. |
image |
תמונה ראשית (Hero) של הפריט בקרוסלה. אפשרות. |
openUrlAction |
כתובת ה-URL של המסמך המשויך לפריט בקרוסלה. המסמך יכול להכיל תוכן HTML, או אם ב-"urlTypeHint" מוגדר הערך AMP_CONTENT, הוא יכול להכיל תוכן AMP. חובה. |
TableCard
כרטיס טבלה להצגת טבלה של טקסט.
ייצוג JSON | |
---|---|
{ "title": string, "subtitle": string, "image": { object ( |
שדות | |
---|---|
title |
הכותרת הכוללת של הטבלה. אופציונלי, אבל אם מגדירים כותרת משנה, חובה להגדיר אותו. |
subtitle |
כותרת משנה של הטבלה. אפשרות. |
image |
תמונה שמשויכת לטבלה. אפשרות. |
columnProperties[] |
כותרות ויישור של עמודות. |
rows[] |
נתוני שורות בטבלה. 3 השורות הראשונות יוצגו בהכרח, אבל יכול להיות שאחרות ייחתכו בפלטפורמות מסוימות. אתם יכולים לבדוק באמצעות הסימולטור אילו שורות יוצגו עבור משטח נתון. בפלטפורמות שתומכות ביכולת WEB_BROWSER, אפשר להפנות את המשתמש לדף אינטרנט שמכיל יותר נתונים. |
buttons[] |
לחצנים. בשלב זה יש תמיכה בלחצן אחד לכל היותר. אפשרות. |
ColumnProperties
שמירת המאפיינים של עמודות (כולל כותרות).
ייצוג JSON | |
---|---|
{
"header": string,
"horizontalAlignment": enum ( |
שדות | |
---|---|
header |
טקסט הכותרת לעמודה. |
horizontalAlignment |
יישור אופקי של עמודת w.r.t של התוכן. אם לא צוין אחרת, התוכן יושר לקצה העליון. |
שורה
מתאר שורה בטבלה.
ייצוג JSON | |
---|---|
{
"cells": [
{
object ( |
שדות | |
---|---|
cells[] |
תאים בשורה הזו. 3 התאים הראשונים יוצגו, אבל אחרים עשויים להיחתך בפלטפורמות מסוימות. השתמשו בסימולטור כדי לבדוק אילו תאים יוצגו עבור משטח נתון. |
dividerAfter |
מציינת אם צריך להיות קו מפריד אחרי כל שורה. |
תא
מתאר תא בשורה.
ייצוג JSON | |
---|---|
{ "text": string } |
שדות | |
---|---|
text |
תוכן הטקסט של התא. |
HtmlResponse
תגובה שמציגה HTML באמצעות תכונת לוח הציור האינטראקטיבי. הגודל המקסימלי של התגובה הוא 50,000 בייטים.
ייצוג JSON | |
---|---|
{ "updatedState": value, "suppressMic": boolean, "url": string } |
שדות | |
---|---|
updatedState |
מעבירים את אובייקט ה-JSON הבא לאפליקציה. |
suppressMic |
מתן אפשרות כדי שהמיקרופון לא יופעל אחרי התגובה העשירה הזו. |
url |
כתובת ה-URL של האפליקציה. |
הצעה
צ'יפ של הצעה שהמשתמש יכול להקיש עליו כדי לפרסם תשובה במהירות בשיחה.
ייצוג JSON | |
---|---|
{ "title": string } |
שדות | |
---|---|
title |
הטקסט שמוצג בצ'יפ ההצעות. כשמקישים על קיצור הדרך, אפשר לחזור לשיחה מילה במילה, כאילו המשתמש הקליד אותו. כל שם צריך להיות ייחודי בקבוצת הצ'יפים של ההצעות. נדרשים 25 תווים לכל היותר |
LinkOutSuggestion
יוצר צ'יפ של הצעות שמאפשר למשתמש לעבור לאפליקציה או לאתר שמשויכים לנציג הזה.
ייצוג JSON | |
---|---|
{
"destinationName": string,
"url": string,
"openUrlAction": {
object ( |
שדות | |
---|---|
destinationName |
שם האפליקציה או האתר שהצ'יפ הזה מקשר אליהם. הצ'יפ יוצג עם הכותרת "פתיחה |
url |
הוּצא משימוש. במקומו צריך להשתמש ב-OpenUrlAction. |
openUrlAction |
כתובת ה-URL של האפליקציה או האתר שייפתחו כשהמשתמש יקיש על צ'יפ ההצעה. יש לאמת את הבעלות על האפליקציה/כתובת ה-URL הזו בפעולות ב-Google Developers Console, אחרת ההצעה לא תוצג למשתמש. הפעולה של כתובת URL פתוחה תומכת בכתובות URL מסוג http, https ו-Intent. לכתובות URL של Intent יש להתייחס אל: https://developer.chrome.com/multidevice/android/intents |
ExpectedIntent
הכוונה הצפויה שהאפליקציה מבקשת מ-Assistant לספק.
ייצוג JSON | |
---|---|
{ "intent": string, "inputValueData": { "@type": string, field1: ..., ... }, "parameterName": string } |
שדות | |
---|---|
intent |
השם המובנה של ה-Intent, למשל |
inputValueData |
נתוני תצורה נוספים שנדרשים על ידי Intent מובנה. ערכים אפשריים לאובייקטים המובנים של Intent: אובייקט שמכיל שדות מסוג שרירותי. שדה נוסף |
parameterName |
אפשר גם להוסיף פרמטר של ה-Intent שהתבקשו. בתוקף רק לאובייקטים המבוקשים של Intent. משמש לתעדוף דיבור. |
FinalResponse
התגובה הסופית כאשר קלט המשתמש אינו צפוי.
ייצוג JSON | |
---|---|
{ // Union field |
שדות | ||
---|---|---|
שדה איחוד response . סוגי תשובות אפשריים. הערך של response יכול להיות רק אחת מהאפשרויות הבאות: |
||
speechResponse |
תגובה קולית כאשר המשתמש לא נדרש להזין קלט. |
|
richResponse |
תגובה עשירה כאשר המשתמש לא נדרש להזין קלט. |
CustomPushMessage
הודעת Push בהתאמה אישית שכוללת נתונים מובְנים כדי לדחוף את הפעולות ל-Fulfillment API.
ייצוג JSON | |
---|---|
{ "target": { object ( |
שדות | ||
---|---|---|
target |
היעד שצוין לבקשת הדחיפה. |
|
שדה איחוד content . הסוגים השונים של מטען ייעודי (payload). הערך של content יכול להיות רק אחת מהאפשרויות הבאות: |
||
orderUpdate |
עדכון הזמנות שמעדכן הזמנות שבוצעו באמצעות ממשקי API של עסקאות. |
|
userNotification |
אם צוין, מציג התראה למשתמש עם הכותרת והטקסט שצוינו. |
UserNotification
הודעה למשתמש שתוצג עם בקשה.
ייצוג JSON | |
---|---|
{ "title": string, "text": string } |
שדות | |
---|---|
title |
הכותרת של ההודעה. |
text |
תוכן ההודעה. |
לטירגוט
היעד שצוין לבקשת הדחיפה.
ייצוג JSON | |
---|---|
{
"userId": string,
"intent": string,
"argument": {
object ( |
שדות | |
---|---|
userId |
המשתמש שרוצים לטרגט. |
intent |
הכוונה לטירגוט. |
argument |
הארגומנט שצריך לטרגט עבור Intent. ב-V1 יש תמיכה רק בארגומנט אחד. |
locale |
הלוקאל שרוצים לטרגט. לפי קוד השפה IETF BCP-47. אפשר להשתמש באפליקציה רב-לשונית כדי לטרגט משתמש באפליקציה מותאמת לשוק המקומי. אם לא מציינים שום אפשרות, ברירת המחדל היא 'en-US'. |