משאב: מרחב
מרחב משותף ב-Google Chat. מרחבים משותפים הם שיחות בין שני משתמשים או יותר או צ'אטים אישיים בין משתמשים לבין אפליקציית Chat.
ייצוג JSON |
---|
{ "name": string, "type": enum ( |
שדות | |
---|---|
name |
שם המשאב של המרחב המשותף. פורמט: |
type |
פלט בלבד. הוצא משימוש: יש להשתמש במקום זאת ב- |
spaceType |
סוג המרחב המשותף. חובה כשיוצרים מרחב משותף או כשמעדכנים את הסוג שלו. פלט לשימוש אחר בלבד. |
singleUserBotDm |
זה שינוי אופציונלי. האם מדובר בצ'אט אישי בין אפליקציית Chat לבין אדם אחד. |
threaded |
פלט בלבד. הוצא משימוש: יש להשתמש במקום זאת ב- |
displayName |
השם המוצג של המרחב המשותף. חובה כשיוצרים מרחב משותף. אם מופיעה הודעת השגיאה יכול להיות שהשדה הזה יהיה ריק בצ'אטים אישיים. אפשר להזין עד 128 תווים. |
externalUserAllowed |
בלתי משתנה. האם משתמשי Google Chat יכולים להצטרף למרחב המשותף הזה? צריך להזין את זה כשיוצרים מרחב משותף בארגון ב-Google Workspace. יש להשמיט את השדה הזה כשיוצרים רווחים בתנאים הבאים:
במרחבים משותפים קיימים, השדה הזה הוא פלט בלבד. |
spaceThreadingState |
פלט בלבד. מצב השרשור במרחב המשותף ב-Chat. |
spaceDetails |
פרטים על המרחב המשותף, כולל תיאור וכללים. |
spaceHistoryState |
מצב היסטוריית ההודעות של ההודעות והשרשורים במרחב המשותף הזה. |
importMode |
זה שינוי אופציונלי. האם המרחב המשותף הזה נוצר ב- |
createTime |
זה שינוי אופציונלי. בלתי משתנה. במרחבים משותפים שנוצרו ב-Chat, השעה שבה נוצר המרחב המשותף. השדה הזה הוא פלט בלבד, אלא אם משתמשים בו במרחבים משותפים של מצב ייבוא. במרחבים משותפים של מצב ייבוא, צריך להגדיר את השדה הזה לחותמת הזמן ההיסטורית שבה המרחב נוצר במקור, כדי לשמר את שעת היצירה המקורית. מאוכלס בפלט רק כאשר |
adminInstalled |
פלט בלבד. במרחבים משותפים של צ'אטים אישיים (DM) עם אפליקציית Chat, אם המרחב המשותף נוצר על ידי אדמין ב-Google Workspace. אדמינים יכולים להתקין ולהגדיר צ'אט אישי עם אפליקציות ב-Chat בשם המשתמשים בארגון. כדי לאפשר התקנה של אדמינים, אפליקציית Chat צריכה לכלול צ'אט אישי. |
accessSettings |
זה שינוי אופציונלי. ההגדרה קובעת את הגדרת הגישה של המרחב המשותף. השדה מאוכלס רק כשהערך בשדה |
spaceUri |
פלט בלבד. ה-URI של המרחב המשותף. |
סוג
הוצא משימוש: יש להשתמש במקום זאת ב-SpaceType
.
טיפוסים בני מנייה (enums) | |
---|---|
TYPE_UNSPECIFIED |
שמור. |
ROOM |
שיחות בין שני אנשים או יותר. |
DM |
צ'אט אישי בין אנשים לבין אפליקציית Chat, שבה כל ההודעות שטוחות. חשוב לשים לב שהפרט הזה לא כולל צ'אטים אישיים בין שני אנשים. |
SpaceType
סוג המרחב המשותף. חובה ליצור או לעדכן מרחב משותף. פלט לשימוש אחר בלבד.
טיפוסים בני מנייה (enums) | |
---|---|
SPACE_TYPE_UNSPECIFIED |
שמור. |
SPACE |
מקום שבו אנשים שולחים הודעות, משתפים קבצים ועובדים יחד. SPACE יכול לכלול אפליקציות צ'אט. |
GROUP_CHAT |
שיחות קבוצתיות עם 3 אנשים או יותר. GROUP_CHAT יכול לכלול אפליקציות צ'אט. |
DIRECT_MESSAGE |
צ'אטים אישיים בין שני אנשים או בין אפליקציית Chat. |
SpaceThreadingState
ההגדרה קובעת את מצב השרשור במרחב המשותף ב-Chat.
טיפוסים בני מנייה (enums) | |
---|---|
SPACE_THREADING_STATE_UNSPECIFIED |
שמור. |
THREADED_MESSAGES |
מרחבים משותפים עם שמות שתומכים בשרשורי הודעות. כשמשתמשים משיבים להודעה, הם יכולים להשיב בשרשור, כך שהתשובה שלהם תהיה בהקשר של ההודעה המקורית. |
GROUPED_MESSAGES |
מרחבים משותפים עם שמות שבהם השיחה מסודרת לפי נושאים. הנושאים והתשובות שלהם מקובצים יחד. |
UNTHREADED_MESSAGES |
צ'אטים אישיים (DM) בין שני אנשים ושיחות קבוצתיות בין 3 אנשים או יותר. |
SpaceDetails
פרטים על המרחב המשותף, כולל תיאור וכללים.
ייצוג JSON |
---|
{ "description": string, "guidelines": string } |
שדות | |
---|---|
description |
זה שינוי אופציונלי. תיאור של המרחב המשותף. למשל, לתאר את נושא הדיון, המטרה הפונקציונליות או המשתתפים. אפשר להזין עד 150 תווים. |
guidelines |
זה שינוי אופציונלי. הכללים, הציפיות והנימוסים של המרחב המשותף. אפשר להזין עד 5,000 תווים. |
HistoryState
מצב ההיסטוריה של ההודעות והמרחבים המשותפים. ההגדרה קובעת למשך כמה זמן יישמרו הודעות ושרשורי שיחות לאחר היצירה.
טיפוסים בני מנייה (enums) | |
---|---|
HISTORY_STATE_UNSPECIFIED |
ערך ברירת המחדל. אין להשתמש בו. |
HISTORY_OFF |
ההיסטוריה מושבתת. ההודעות והשרשורים נשמרים למשך 24 שעות. |
HISTORY_ON |
ההיסטוריה פועלת. כללי השמירה ב-Vault של הארגון קובעים למשך כמה זמן יישמרו הודעות ושרשורים. |
AccessSettings
מייצג את הגדרת הגישה של המרחב המשותף.
ייצוג JSON |
---|
{
"accessState": enum ( |
שדות | |
---|---|
accessState |
פלט בלבד. מציין את מצב הגישה של המרחב. |
audience |
זה שינוי אופציונלי. שם המשאב של קהל היעד שיכול לגשת למרחב המשותף. צריך להגדיר בשדה הזה מזהה חוקי של קהל יעד כדי שהמרחב המשותף יהיה גלוי, או להשתמש בכינוי |
AccessState
מייצג את מצב הגישה של המרחב.
טיפוסים בני מנייה (enums) | |
---|---|
ACCESS_STATE_UNSPECIFIED |
מצב הגישה לא ידוע או לא נתמך ב-API הזה. |
PRIVATE |
כשמצרפים או מוזמנים למרחב המשותף, אפשר לשתף אותו עם אנשים או קבוצות. |
DISCOVERABLE |
משתמשי היעד שנבחרו יכולים לראות את המרחב המשותף, וגם חברים או קבוצות שנוספו או הוזמנו אליו. |
שיטות |
|
---|---|
|
משלים את תהליך הייבוא של המרחב המשותף שצוין והופך אותו לגלוי למשתמשים. |
|
יצירת מרחב משותף עם שם. |
|
מחיקת מרחב משותף עם שם. |
|
מחזירה את הצ'אט האישי הקיים עם המשתמש שצוין. |
|
מחזירה פרטים על מרחב משותף. |
|
הצגת רשימה של מרחבים משותפים שבהם המתקשר חבר. |
|
מתבצע עדכון של מרחב משותף. |
|
יצירת מרחב משותף והוספה של משתמשים ספציפיים אליו. |