REST Resource: spaces

משאב: מרחב

מקום וירטואלי שבו מתקיימים כנסים. בכל רגע נתון יכולה להתקיים רק שיחת ועידה פעילה אחת במרחב.

ייצוג JSON 
{
  "name": string,
  "meetingUri": string,
  "meetingCode": string,
  "config": {
    object (SpaceConfig)
  },
  "activeConference": {
    object (ActiveConference)
  },
  "phoneAccess": [
    {
      object (PhoneAccess)
    }
  ],
  "gatewaySipAccess": [
    {
      object (GatewaySipAccess)
    }
  ]
}
שדות
name

string

אי אפשר לשנות. שם המשאב של המרחב.

פורמט: spaces/{space}

‫{space} הוא מזהה המשאב של המרחב. זהו מזהה ייחודי שנוצר בשרת, והוא תלוי באותיות רישיות. לדוגמה, jQCFfuBOdN5z.

מידע נוסף זמין במאמר איך Meet מזהה את מרחב הפגישות.
meetingUri

string

פלט בלבד. ‫URI שמשמש להצטרפות לפגישות, שכולל את https://meet.google.com/ ואחריו את meetingCode. לדוגמה, https://meet.google.com/abc-mnop-xyz.
meetingCode

string

פלט בלבד. מחרוזת ייחודית ידידותית למשתמש שמשמשת להצטרפות לפגישה.

פורמט: [a-z]+-[a-z]+-[a-z]+ לדוגמה, abc-mnop-xyz.

האורך המקסימלי הוא 128 תווים.

אפשר להשתמש בו רק ככינוי של שם המרחב כדי לקבל את המרחב.
config

object (SpaceConfig)

ההגדרה שקשורה למרחב לפגישה.
activeConference

object (ActiveConference)

הוועידה הפעילה, אם קיימת.
phoneAccess[]

object (PhoneAccess)

פלט בלבד. כל השיטות לגישה טלפונית אזורית למרחב הפגישה הזה. אפשר להשאיר את השדה ריק.
gatewaySipAccess[]

object (GatewaySipAccess)

פלט בלבד. שיטות הגישה שמבוססות על SIP שאפשר להשתמש בהן כדי להצטרף לשיחת הוועידה. אפשר להשאיר את השדה ריק.

SpaceConfig

ההגדרה שקשורה למרחב לפגישה.

ייצוג JSON 
{
  "accessType": enum (AccessType),
  "entryPointAccess": enum (EntryPointAccess),
  "moderation": enum (Moderation),
  "moderationRestrictions": {
    object (ModerationRestrictions)
  },
  "attendanceReportGenerationType": enum (AttendanceReportGenerationType),
  "artifactConfig": {
    object (ArtifactConfig)
  }
}
שדות
accessType

enum (AccessType)

סוג הגישה למרחב הפגישה שקובע מי יכול להצטרף בלי לשלוח בקשת הצטרפות. ברירת מחדל: הגדרות הגישה שמוגדרות כברירת מחדל למשתמש. הגישה מוגבלת או נשלטת על ידי האדמין של המשתמשים הארגוניים.
entryPointAccess

enum (EntryPointAccess)

ההגדרה הזו מגדירה את נקודות הכניסה שבהן אפשר להשתמש כדי להצטרף לפגישות שמתארחות במרחב הזה. ברירת מחדל: EntryPointAccess.ALL
moderation

enum (Moderation)

מצב הניהול המוגדר מראש לפגישה. ברירת מחדל: נשלט על ידי המדיניות של המשתמש.
moderationRestrictions

object (ModerationRestrictions)

כשההגדרה 'הפעלת ניהול' מופעלת, ההגבלות האלה חלות על הפגישה. כשההגדרה moderation.OFF, תאופס להגדרה ModerationRestrictions.
attendanceReportGenerationType

enum (AttendanceReportGenerationType)

האם דוח הנוכחות מופעל במתחם הפגישות.
artifactConfig

object (ArtifactConfig)

ההגדרה שקשורה לתוצרי הפגישה שנוצרו באופן אוטומטי שהפגישה תומכת בהם.

AccessType

סוגי הגישה האפשריים למתחם ישיבות.

טיפוסים בני מנייה (enum)
ACCESS_TYPE_UNSPECIFIED ערך ברירת המחדל שצוין על ידי הארגון של המשתמש. הערה: הערך הזה אף פעם לא מוחזר, כי במקומו מוחזרת הגדרת סוג הגישה.
OPEN כל מי שיש לו את פרטי ההצטרפות (לדוגמה, כתובת ה-URL או פרטי הגישה לטלפון) יכול להצטרף בלי לדפוק.
TRUSTED חברים בארגון של המארח, משתמשים חיצוניים שהוזמנו ומשתמשים שהתקשרו לפגישה יכולים להצטרף בלי לשלוח בקשת הצטרפות. כל השאר צריכים לשלוח בקשת הצטרפות.
RESTRICTED רק מי שהוזמן יכול להצטרף בלי לשלוח בקשת הצטרפות. כל השאר צריכים לשלוח בקשת הצטרפות.

EntryPointAccess

נקודות כניסה שאפשר להשתמש בהן כדי להצטרף לפגישה. דוגמה: meet.google.com, Meet Embed SDK Web או אפליקציה לנייד.

טיפוסים בני מנייה (enum)
ENTRY_POINT_ACCESS_UNSPECIFIED לא בשימוש.
ALL כל נקודות הכניסה מותרות.
CREATOR_APP_ONLY אפשר להצטרף לפגישות במרחב הזה רק דרך נקודות כניסה שנמצאות בבעלות פרויקט בענן של Google שיצר את המרחב. אפליקציות יכולות להשתמש ב-Meet Embed SDK Web או ב-Meet SDKs לנייד כדי ליצור נקודות כניסה בבעלותן.

ניהול תגובות

מצב הניהול של הפגישה. כשמצב הניהול מופעל, לבעלי הפגישה יש יותר שליטה בפגישה באמצעות תכונות כמו ניהול מארחים נוספים (ראו הודעה Member) והגבלות על תכונות (ראו הודעה ModerationRestrictions).

טיפוסים בני מנייה (enum)
MODERATION_UNSPECIFIED לא צוין סוג הניהול. המאפיין הזה משמש לציון מצב שבו המשתמש לא ציין ערך כי הוא לא מתכוון לעדכן את המצב. המשתמשים לא יכולים להגדיר את הערך כלא מוגדר.
OFF הניהול מושבת.
ON הנחייה מופעלת.

ModerationRestrictions

הגדרת הגבלות על תכונות כשהפגישה מנוהלת.

ייצוג JSON 
{
  "chatRestriction": enum (RestrictionType),
  "reactionRestriction": enum (RestrictionType),
  "presentRestriction": enum (RestrictionType),
  "defaultJoinAsViewerType": enum (DefaultJoinAsViewerType)
}
שדות
chatRestriction

enum (RestrictionType)

ההגדרה הזו קובעת למי יש הרשאה לשלוח הודעות בצ'אט במרחב הפגישה.
reactionRestriction

enum (RestrictionType)

ההגדרה הזו מגדירה למי יש הרשאה לשלוח תגובות במרחב הפגישה.
presentRestriction

enum (RestrictionType)

ההגדרה הזו קובעת למי יש הרשאה לשתף את המסך במרחב הפגישה.
defaultJoinAsViewerType

enum (DefaultJoinAsViewerType)

ההגדרה הזו קובעת אם להגביל את תפקיד ברירת המחדל שמוקצה למשתמשים לתפקיד צופה.

RestrictionType

ההגדרה קובעת למי יש הרשאה להשתמש בתכונה מסוימת.

טיפוסים בני מנייה (enum)
RESTRICTION_TYPE_UNSPECIFIED ערך ברירת המחדל שצוין במדיניות המשתמש. הערך הזה לא אמור לחזור אף פעם.
HOSTS_ONLY לבעלים של הפגישה ולמארחים הנוספים יש את ההרשאה.
NO_RESTRICTION לכל המשתתפים יש הרשאות.

DefaultJoinAsViewerType

כברירת מחדל, המשתמשים מצטרפים כמשתתפים. המארחים יכולים להגביל את המשתמשים כך שהם יוכלו להצטרף כצופים בלבד. הערה: אם תפקיד מוגדר במפורש למשתמש במשאב Member, המשתמש יצטרף עם התפקיד הזה.

טיפוסים בני מנייה (enum)
DEFAULT_JOIN_AS_VIEWER_TYPE_UNSPECIFIED ערך ברירת המחדל שצוין במדיניות המשתמש. הערך הזה לא אמור לחזור אף פעם.
ON ברירת המחדל היא שהמשתמשים יצטרפו כצופים.
OFF ברירת המחדל היא שהמשתמשים יצטרפו כמשתתפים.

AttendanceReportGenerationType

המצבים האפשריים של ההגדרה 'דוח נוכחות' במרחב הפגישות.

טיפוסים בני מנייה (enum)
ATTENDANCE_REPORT_GENERATION_TYPE_UNSPECIFIED ערך ברירת המחדל שצוין במדיניות המשתמש. הערך הזה לא אמור לחזור אף פעם.
GENERATE_REPORT דוח הנוכחות ייווצר ויישלח ל-Drive או לאימייל.
DO_NOT_GENERATE לא ייווצר דוח נוכחות.

ArtifactConfig

הגדרות שקשורות לפריטי מידע מהפגישה שאולי נוצרו במרחב הזה.

ייצוג JSON 
{
  "recordingConfig": {
    object (RecordingConfig)
  },
  "transcriptionConfig": {
    object (TranscriptionConfig)
  },
  "smartNotesConfig": {
    object (SmartNotesConfig)
  }
}
שדות
recordingConfig

object (RecordingConfig)

הגדרות להקלטה.
transcriptionConfig

object (TranscriptionConfig)

הגדרות לתמלול אוטומטי.
smartNotesConfig

object (SmartNotesConfig)

הגדרת הסיכום החכם האוטומטי.

RecordingConfig

הגדרות שקשורות להקלטה במרחב לפגישות.

ייצוג JSON 
{
  "autoRecordingGeneration": enum (AutoGenerationType)
}
שדות
autoRecordingGeneration

enum (AutoGenerationType)

ההגדרה קובעת אם מרחב הפגישה יוקלט אוטומטית כשמישהו עם הרשאה להקליט יצטרף לפגישה.

AutoGenerationType

קובע אם אפשר ליצור באופן אוטומטי ארטיפקט במרחב הפגישה.

טיפוסים בני מנייה (enum)
AUTO_GENERATION_TYPE_UNSPECIFIED ערך ברירת המחדל שצוין במדיניות המשתמש. הערך הזה לא אמור לחזור אף פעם.
ON הארטיפקט נוצר באופן אוטומטי.
OFF הארטיפקט לא נוצר באופן אוטומטי.

TranscriptionConfig

הגדרות שקשורות לתמלול במרחב לפגישה.

ייצוג JSON 
{
  "autoTranscriptionGeneration": enum (AutoGenerationType)
}
שדות
autoTranscriptionGeneration

enum (AutoGenerationType)

ההגדרה קובעת אם התוכן של הפגישה יתומלל אוטומטית כשמישהו עם הרשאה לתמלל יצטרף לפגישה.

SmartNotesConfig

הגדרות שקשורות לסיכום חכם במרחב לפגישה. מידע נוסף על סיכום חכם זמין במאמר סיכום שיחה חכם ב-Google Meet.

ייצוג JSON 
{
  "autoSmartNotesGeneration": enum (AutoGenerationType)
}
שדות
autoSmartNotesGeneration

enum (AutoGenerationType)

הגדרה של יצירת סיכום אוטומטי של הפגישה לכל המוזמנים בארגון כשמישהו עם הרשאה להפעיל סיכום חכם מצטרף לפגישה.

ActiveConference

שיחת ועידה פעילה.

ייצוג JSON 
{
  "conferenceRecord": string
}
שדות
conferenceRecord

string

פלט בלבד. הפניה למשאב ConferenceRecord. פורמט: conferenceRecords/{conferenceRecord}, כאשר {conferenceRecord} הוא מזהה ייחודי לכל מופע של שיחה במרחב.

PhoneAccess

הגישה לטלפון כוללת את המידע שנדרש כדי להתקשר לוועידה באמצעות מספר טלפון אזורי וקוד אימות שספציפי למספר הטלפון הזה.

ייצוג JSON 
{
  "phoneNumber": string,
  "pin": string,
  "regionCode": string,
  "languageCode": string
}
שדות
phoneNumber

string

מספר הטלפון לחיוג לחדר הפגישות הזה בפורמט E.164. מספר טלפון מלא עם התו '+' בתחילתו.
pin

string

קוד האימות שהמשתמשים צריכים להזין אחרי החיוג למספר שצוין. קוד האימות מורכב רק מספרות עשרוניות, והאורך שלו יכול להשתנות.
regionCode

string

קוד האזור/המדינה לפי תקן CLDR/ISO 3166 שמשויך לגישה לטלפון. כדי שהכלי RegionCode ללוקליזציה ינתח את הערך. דוגמה: 'SE' לשוודיה.
languageCode

string

קוד השפה BCP 47/LDML של השפה שמשויכת לגישה לטלפון הזה. כדי שהכלי LanguageCode של i18n ינתח את הערך. דוגמאות: 'es-419' לספרדית אמריקאית, 'fr-CA' לצרפתית קנדית.

GatewaySipAccess

הסבר על הצטרפות לשיחת הוועידה דרך שער SIP.

ייצוג JSON 
{
  "uri": string,
  "sipAccessCode": string
}
שדות
uri

string

ה-URI של פרוטוקול אתחול הסשן (SIP) שאפשר להגיע לשיחת הוועידה דרכו.

המחרוזת היא באחד מהפורמטים הבאים:

כאשר USER_ID הוא קוד ה-PIN האוניברסלי בן 13 הספרות (בעתיד תהיה אפשרות לתמוך גם בשימוש בקוד הפגישה ב-Meet), ו-GATEWAY_ADDRESS היא כתובת חוקית שצריך לפתור באמצעות חיפוש DNS SRV או כתובת IPv4.
sipAccessCode

string

קוד נומרי קבוע להזנה ידנית במכשירים שהוגדרו במיוחד.

Methods

create

 יצירת מרחב.

endActiveConference

 מסיים שיחה פעילה (אם יש כזו).

get

 קבלת פרטים על מרחב פגישות.

patch

 עדכון הפרטים של מרחב הפגישות.