משאב: מרחב
במרחבים משותפים ב-Google Chat. מרחבים משותפים הם שיחות בין שני משתמשים או יותר, או הודעות אישיות בין משתמש לאפליקציית Chat.
ייצוג ב-JSON |
---|
{ "name": string, "type": enum ( |
שדות | |
---|---|
name |
מזהה. שם המשאב של המרחב המשותף. פורמט:
|
type |
פלט בלבד. האפשרות הזו הוצאה משימוש. במקום זאת, אתם צריכים להשתמש ב- |
space |
זה שינוי אופציונלי. סוג המרחב. חובה כשיוצרים מרחב משותף או כשמשנים את הסוג של המרחב המשותף. פלט עבור שימוש אחר בלבד. |
single |
זה שינוי אופציונלי. האם המרחב המשותף הוא צ'אט בין אפליקציית Chat לבין אדם אחד? |
threaded |
פלט בלבד. האפשרות הזו הוצאה משימוש. במקום זאת, אתם צריכים להשתמש ב- |
display |
זה שינוי אופציונלי. השם המוצג של המרחב המשותף. חובה כשיוצרים מרחב עם בהודעות ישירות, השדה הזה עשוי להיות ריק. אפשר להזין עד 128 תווים. |
external |
זה שינוי אופציונלי. בלתי ניתן לשינוי. האם כל משתמש ב-Google Chat יכול להצטרף למרחב המשותף. צריך להזין כאן את הפרטים כשיוצרים מרחב משותף ב-Google Workspace. יש להשמיט את השדה הזה כשיוצרים רווחים בתנאים הבאים:
במרחבים משותפים קיימים, השדה הזה הוא פלט בלבד. |
space |
פלט בלבד. מצב השרשורים במרחב המשותף ב-Chat. |
space |
זה שינוי אופציונלי. פרטים על המרחב המשותף, כולל תיאור וכללים. |
space |
זה שינוי אופציונלי. המצב של היסטוריית ההודעות של ההודעות והשרשורים במרחב המשותף. |
import |
זה שינוי אופציונלי. האם המרחב המשותף הזה נוצר באפליקציה כדי ליצור מרחבים משותפים ב- |
create |
זה שינוי אופציונלי. קבוע. במרחבים משותפים שנוצרו ב-Chat, השעה שבה המרחב נוצר. השדה הזה מיועד לפלט בלבד, למעט כשמשתמשים בו במרחבים משותפים במצב ייבוא. במרחבים משותפים של מצב ייבוא, צריך להגדיר את השדה הזה כחותמת הזמן ההיסטורית שבה המרחב המשותף נוצר במקור כדי שזמן היצירה המקורי יישמר. השדה הזה מאוכלס רק בפלט כשהערך של |
last |
פלט בלבד. חותמת הזמן של ההודעה האחרונה במרחב המשותף. |
admin |
פלט בלבד. במרחבים משותפים של צ'אט אישי (DM) באפליקציית Chat, אם המרחב נוצר על ידי אדמין ב-Google Workspace. אדמינים יכולים להתקין ולהגדיר צ'אט אישי עם אפליקציית Chat בשם המשתמשים בארגון שלהם. כדי לתמוך בהתקנה על ידי אדמין, אפליקציית Chat צריכה לכלול צ'אטים אישיים. |
membership |
פלט בלבד. מספר החברויות במועדון שמקובצות לפי סוג החבר. מאוכלס כשהערך בשדה |
access |
זה שינוי אופציונלי. מציין את הגדרת הגישה של המרחב המשותף. השדה הזה מאוכלס רק כשהערך של |
space |
פלט בלבד. ה-URI של המשתמש כדי לגשת למרחב המשותף. |
customer |
זה שינוי אופציונלי. בלתי ניתן לשינוי. מספר הלקוח של הדומיין של המרחב. נדרש רק כשיוצרים מרחב משותף עם אימות אפליקציות שבו הערך של בפורמט בצ'אטים, השדה הזה לא מאוכלס. |
שדה האיחוד נדרש אימות משתמש. |
|
predefined |
זה שינוי אופציונלי. קלט בלבד. הגדרות קבועות מראש של הרשאת גישה למרחב המשותף. יש להזין קלט רק כשיוצרים מרחב משותף. אם לא מגדירים את השדה, נוצר מרחב לשיתוף פעולה. אחרי שיוצרים את המרחב, ההגדרות יאוכלסו בשדה |
permission |
זה שינוי אופציונלי. ההגדרות של ההרשאות במרחבים משותפים קיימים. קלט לעדכון ההגדרות המדויקות של הרשאות המרחב המשותף, שבו הגדרות ההרשאות הקיימות מוחלפות. הפלט מציג את הגדרות ההרשאות הנוכחיות. |
סוג
הוצא משימוש: במקומו צריך להשתמש ברכיב SpaceType
.
טיפוסים בני מנייה (enum) | |
---|---|
TYPE_UNSPECIFIED |
שמור. |
ROOM |
שיחות בין שני אנשים או יותר. |
DM |
צ'אט אישי בין משתמשים לבין אפליקציית Chat, שבה כל ההודעות הן שטוחות. חשוב לזכור שההגדרה הזו לא כוללת צ'אטים אישיים בין שני בני אדם. |
SpaceType
סוג המרחב המשותף. חובה כשיוצרים או מעדכנים מרחב משותף. פלט רק לשימוש אחר.
טיפוסים בני מנייה (enum) | |
---|---|
SPACE_TYPE_UNSPECIFIED |
שמור. |
SPACE |
מקום שבו אנשים שולחים הודעות, משתפים קבצים ועובדים יחד. SPACE יכול לכלול אפליקציות צ'אט. |
GROUP_CHAT |
שיחות קבוצתיות עם 3 אנשים או יותר. GROUP_CHAT יכול לכלול אפליקציות Chat. |
DIRECT_MESSAGE |
הודעות אישיות בין שני אנשים או בין אדם לאפליקציית Chat. |
SpaceThreadingState
ההגדרה קובעת את סוג השרשור במרחב ב-Chat.
טיפוסים בני מנייה (enum) | |
---|---|
SPACE_THREADING_STATE_UNSPECIFIED |
שמור. |
THREADED_MESSAGES |
מרחבים משותפים עם שם שתומכים בשרשורי הודעות. כשמשתמשים משיבים להודעה, הם יכולים להשיב בשרשור, כך שהתשובה שלהם תישאר בהקשר של ההודעה המקורית. |
GROUPED_MESSAGES |
מרחבים משותפים עם שמות שבהם השיחות מחולקות לפי נושאים. הנושאים והתשובות שלהם מקובצים יחד. |
UNTHREADED_MESSAGES |
צ'אטים אישיים (DM) בין שני אנשים ושיחות קבוצתיות עם 3 אנשים או יותר. |
SpaceDetails
פרטים על המרחב המשותף, כולל תיאור וכללים.
ייצוג ב-JSON |
---|
{ "description": string, "guidelines": string } |
שדות | |
---|---|
description |
זה שינוי אופציונלי. תיאור של המרחב המשותף. למשל, אפשר לתאר את נושא השיחה, המטרה התפעולית או רשימת המשתתפים במרחב המשותף. יש תמיכה ב-150 תווים לכל היותר. |
guidelines |
זה שינוי אופציונלי. הכללים, הציפיות והנימוסים של המרחב. אפשר להזין עד 5,000 תווים. |
HistoryState
מצב ההיסטוריה של הודעות ומרחבים משותפים. קובעת למשך כמה זמן הודעות ושרשראות של שיחות יישמרו אחרי היצירה שלהן.
טיפוסים בני מנייה (enum) | |
---|---|
HISTORY_STATE_UNSPECIFIED |
ערך ברירת המחדל. אין להשתמש בו. |
HISTORY_OFF |
ההיסטוריה מושבתת. ההודעות והשרשורים נשמרים למשך 24 שעות. |
HISTORY_ON |
ההיסטוריה מופעלת. כללי השמירה ב-Vault של הארגון קובעים למשך כמה זמן ההודעות והשרשורים יישמרו. |
MembershipCount
מספר החברים במרחב המשותף, שמקובצים לקטגוריות.
ייצוג ב-JSON |
---|
{ "joinedDirectHumanUserCount": integer, "joinedGroupCount": integer } |
שדות | |
---|---|
joined |
פלט בלבד. מספר המשתמשים האנושיים שהצטרפו למרחב המשותף ישירות, לא כולל משתמשים שהצטרפו כי הם חברים בקבוצה שהצטרפה למרחב המשותף. |
joined |
פלט בלבד. מספר הקבוצות שהצטרפו ישירות למרחב המשותף. |
AccessSettings
מייצג את הגדרת הגישה של המרחב המשותף.
ייצוג ב-JSON |
---|
{
"accessState": enum ( |
שדות | |
---|---|
access |
פלט בלבד. מציין את סטטוס הגישה למרחב המשותף. |
audience |
זה שינוי אופציונלי. שם המשאב של קהל היעד שיכול למצוא את המרחב המשותף, להצטרף אליו ולראות תצוגה מקדימה של ההודעות במרחב המשותף. אם המדיניות לא מוגדרת, רק משתמשים וקבוצות Google שהוזמנו או נוספו למרחב המשותף בנפרד יכולים לגשת אליו. מידע נוסף זמין במאמר הפיכת מרחב משותף לגלוי לקהל יעד. פורמט: כדי להשתמש בקהל היעד שמוגדר כברירת מחדל לארגון ב-Google Workspace, צריך להגדיר את הערך אלה הנתונים שנתמכים בקריאת קהל היעד:
השדה הזה לא מאוכלס כשמשתמשים בהיקף ההרשאות כדי להגדיר את קהל היעד, נדרש אימות משתמש. |
AccessState
מצב הגישה של המרחב המשותף.
טיפוסים בני מנייה (enum) | |
---|---|
ACCESS_STATE_UNSPECIFIED |
סטטוס הגישה לא ידוע או לא נתמך ב-API הזה. |
PRIVATE |
רק משתמשים וקבוצות ב-Google שנוספו או הוזמנו על ידי משתמשים אחרים או אדמינים ב-Google Workspace יכולים למצוא את המרחב המשותף ולגשת אליו. |
DISCOVERABLE |
אחד ממנהלי המרחב המשותף העניק לקהל היעד גישה למרחב המשותף. גם משתמשים וקבוצות Google שנוספו או הוזמנו למרחב המשותף בנפרד יכולים למצוא אותו ולגשת אליו. מידע נוסף זמין במאמר איך מגדירים מרחב משותף כך שיהיה גלוי למשתמשים ספציפיים. כדי ליצור מרחבים משותפים שגלויים לכולם, צריך לבצע אימות של המשתמש. |
PredefinedPermissionSettings
הגדרות של הרשאות מוגדרות מראש שאפשר לבחור רק כשיוצרים מרחב משותף עם שם. יכול להיות שנוסיף הגדרות נוספות בעתיד. למידע נוסף על ההגדרות של ההרשאות למרחבים משותפים עם שם, אפשר לעיין במאמר מידע על מרחבים משותפים.
טיפוסים בני מנייה (enum) | |
---|---|
PREDEFINED_PERMISSION_SETTINGS_UNSPECIFIED |
לא צוין. אין להשתמש בו. |
COLLABORATION_SPACE |
הגדרה זו הופכת את המרחב המשותף למרחב משותף שבו כל המשתתפים יכולים לפרסם הודעות. |
ANNOUNCEMENT_SPACE |
הגדרה שמאפשרת להפוך את המרחב המשותף למרחב משותף לעדכונים, שבו רק מנהלי המרחב המשותף יכולים לפרסם הודעות. |
PermissionSettings
הגדרות הרשאות שאפשר לציין כשמעדכנים מרחב משותף קיים בעל שם.
כדי לקבוע את ההגדרות של ההרשאות כשיוצרים מרחב משותף, צריך לציין את השדה PredefinedPermissionSettings
בבקשה.
ייצוג ב-JSON |
---|
{ "manageMembersAndGroups": { object ( |
שדות | |
---|---|
manage |
זה שינוי אופציונלי. הגדרה לניהול המשתתפים והקבוצות במרחב המשותף. |
modify |
זה שינוי אופציונלי. הגדרה לעדכון השם, הדמות, התיאור וההנחיות של המרחב המשותף. |
toggle |
זה שינוי אופציונלי. הגדרה להפעלה ולהשבתה של ההיסטוריה של המרחב המשותף. |
use |
זה שינוי אופציונלי. ההגדרה של השימוש ב-'הכול' במרחב משותף. |
manage |
זה שינוי אופציונלי. הגדרה לניהול האפליקציות במרחב המשותף. |
manage |
זה שינוי אופציונלי. הגדרה לניהול ה-webhooks במרחבים משותפים. |
post |
פלט בלבד. ההגדרה הזו קובעת אם אפשר לפרסם הודעות במרחב המשותף. |
reply |
זה שינוי אופציונלי. הגדרה של מענה להודעות במרחב המשותף. |
PermissionSetting
מייצג הגדרת הרשאה במרחב משותף.
ייצוג ב-JSON |
---|
{ "managersAllowed": boolean, "membersAllowed": boolean } |
שדות | |
---|---|
managers |
זה שינוי אופציונלי. אם למנהלי המרחבים המשותפים יש את ההרשאה הזו. |
members |
זה שינוי אופציונלי. אם לחברים שאינם מנהלים יש את ההרשאה הזו. |
שיטות |
|
---|---|
|
משלים את תהליך הייבוא של המרחב שצוין והופך אותו לגלוי למשתמשים. |
|
יצירת מרחב משותף בלי משתתפים. |
|
מחיקה של מרחב משותף עם שם. |
|
הפונקציה מחזירה את הצ'אט האישי הקיים עם המשתמש שצוין. |
|
הפונקציה מחזירה פרטים על מרחב משותף. |
|
רשימה של המרחבים המשותפים שבהם המשתמש שמתקשר הוא חבר. |
|
לעדכן את המרחב המשותף. |
|
הפונקציה מחזירה רשימה של מרחבים משותפים בארגון ב-Google Workspace לפי החיפוש של האדמין. |
|
יצירת מרחב משותף והוספת משתמשים ספציפיים אליו. |