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

فقط خروجی. رشته منحصر به فرد مورد استفاده برای پیوستن به جلسه را تایپ کنید.

قالب: [az]+-[az]+-[az]+ . به عنوان مثال، abc-mnop-xyz .

حداکثر طول ۱۲۸ کاراکتر است.

فقط می‌تواند به عنوان نام مستعار نام فاصله برای دریافت فاصله استفاده شود.

config

object ( SpaceConfig )

پیکربندی مربوط به فضای جلسه.

activeConference

object ( ActiveConference )

کنفرانس فعال، در صورت وجود.

phoneAccess[]

object ( PhoneAccess )

فقط خروجی. تمام روش‌های دسترسی تلفنی منطقه‌ای برای این فضای جلسه. می‌تواند خالی باشد.

gatewaySipAccess[]

object ( GatewaySipAccess )

فقط خروجی. روش‌های دسترسی مبتنی بر SIP که می‌توانند برای پیوستن به کنفرانس استفاده شوند. می‌تواند خالی باشد.

پیکربندی فضا

پیکربندی مربوط به فضای جلسه.

نمایش 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.ON باشد، این محدودیت‌ها برای جلسه اعمال می‌شوند. وقتی moderation.OFF باشد، به محدودیت‌های پیش‌فرض ModerationRestrictions بازنشانی می‌شوند.

attendanceReportGenerationType

enum ( AttendanceReportGenerationType )

آیا گزارش حضور و غیاب برای فضای جلسه فعال است یا خیر.

artifactConfig

object ( ArtifactConfig )

پیکربندی مربوط به مصنوعات خودکار تولید شده که جلسه از آنها پشتیبانی می‌کند.

نوع دسترسی

انواع دسترسی‌های ممکن برای فضای جلسه.

انوم‌ها
ACCESS_TYPE_UNSPECIFIED مقدار پیش‌فرضی که توسط سازمان کاربر مشخص شده است. توجه: این مقدار هرگز بازگردانده نمی‌شود، زیرا نوع دسترسی پیکربندی‌شده به جای آن بازگردانده می‌شود.
OPEN هر کسی که اطلاعات عضویت (مثلاً آدرس اینترنتی یا اطلاعات دسترسی به تلفن) را داشته باشد، می‌تواند بدون در زدن عضو شود.
TRUSTED اعضای سازمان میزبان، کاربران خارجی دعوت‌شده و کاربران dial-in می‌توانند بدون در زدن وارد شوند. بقیه باید در بزنند.
RESTRICTED فقط مدعوین می‌توانند بدون در زدن وارد شوند. بقیه باید در بزنند.

ورودی نقطه دسترسی

نقاط ورودی که می‌توان از آنها برای پیوستن به جلسه استفاده کرد. مثال: meet.google.com ، کیت توسعه نرم‌افزار Meet Embed تحت وب یا یک اپلیکیشن موبایل.

انوم‌ها
ENTRY_POINT_ACCESS_UNSPECIFIED استفاده نشده.
ALL تمام نقاط ورود مجاز است.
CREATOR_APP_ONLY فقط نقاط ورودی متعلق به پروژه Google Cloud که این فضا را ایجاد کرده است، می‌توانند برای پیوستن به جلسات در این فضا استفاده شوند. برنامه‌ها می‌توانند از Meet Embed SDK وب یا Meet SDKهای موبایل برای ایجاد نقاط ورودی متعلق به خود استفاده کنند.

اعتدال

حالت مدیریت برای یک جلسه. وقتی حالت مدیریت روشن است، صاحب جلسه با ویژگی‌هایی مانند مدیریت میزبان مشترک (به پیام «عضو» مراجعه کنید) و محدودیت‌های ویژگی (به پیام «محدودیت‌های مدیریت» مراجعه کنید) کنترل بیشتری بر جلسه دارد.

انوم‌ها
MODERATION_UNSPECIFIED نوع مدیریت مشخص نشده است. این نشان می‌دهد که کاربر هیچ مقداری را مشخص نکرده است زیرا کاربر قصد به‌روزرسانی وضعیت را ندارد. کاربران مجاز به تنظیم مقدار نامشخص نیستند.
OFF اعتدال خاموش است.
ON اعتدال برقرار است.

محدودیت‌های مدیریت

محدودیت‌هایی را برای ویژگی‌ها هنگام مدیریت جلسه تعریف می‌کند.

نمایش 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 )

تعریف می‌کند که آیا نقش پیش‌فرض اختصاص داده شده به کاربران به عنوان بیننده محدود شود یا خیر.

نوع محدودیت

مشخص می‌کند چه کسی اجازه استفاده از یک ویژگی خاص را دارد.

انوم‌ها
RESTRICTION_TYPE_UNSPECIFIED مقدار پیش‌فرض توسط سیاست کاربر مشخص شده است. این مقدار هرگز نباید بازگردانده شود.
HOSTS_ONLY صاحب جلسه و میزبان مشترک این اجازه را دارند.
NO_RESTRICTION همه شرکت‌کنندگان مجوز دارند.

DefaultJoinAsViewerType

به طور پیش‌فرض، کاربران به عنوان مشارکت‌کننده ملحق می‌شوند. میزبان‌ها می‌توانند کاربران را محدود کنند که به عنوان بیننده ملحق شوند. توجه: اگر در منبع Member، نقش صریحی برای یک کاربر تعیین شده باشد، کاربر به عنوان آن نقش ملحق خواهد شد.

انوم‌ها
DEFAULT_JOIN_AS_VIEWER_TYPE_UNSPECIFIED مقدار پیش‌فرض توسط سیاست کاربر مشخص شده است. این مقدار هرگز نباید بازگردانده شود.
ON کاربران به طور پیش‌فرض به عنوان بیننده (viewer) ملحق می‌شوند.
OFF کاربران به طور پیش‌فرض به عنوان مشارکت‌کننده عضو می‌شوند.

نوع تولید گزارش حضور و غیاب

حالت‌های احتمالی فعال بودن گزارش حضور و غیاب برای فضای جلسه.

انوم‌ها
ATTENDANCE_REPORT_GENERATION_TYPE_UNSPECIFIED مقدار پیش‌فرض توسط سیاست کاربر مشخص شده است. این مقدار هرگز نباید بازگردانده شود.
GENERATE_REPORT گزارش حضور و غیاب تهیه و به درایو/ایمیل ارسال خواهد شد.
DO_NOT_GENERATE گزارش حضور و غیاب ایجاد نخواهد شد.

پیکربندی مصنوعات

پیکربندی مربوط به مصنوعات جلسه که به طور بالقوه توسط این فضای جلسه ایجاد می‌شوند.

نمایش JSON
{
  "recordingConfig": {
    object (RecordingConfig)
  },
  "transcriptionConfig": {
    object (TranscriptionConfig)
  },
  "smartNotesConfig": {
    object (SmartNotesConfig)
  }
}
فیلدها
recordingConfig

object ( RecordingConfig )

پیکربندی برای ضبط.

transcriptionConfig

object ( TranscriptionConfig )

پیکربندی برای رونویسی خودکار.

smartNotesConfig

object ( SmartNotesConfig )

پیکربندی یادداشت‌های هوشمند خودکار.

پیکربندی ضبط

پیکربندی مربوط به ضبط در فضای جلسه.

نمایش JSON
{
  "autoRecordingGeneration": enum (AutoGenerationType)
}
فیلدها
autoRecordingGeneration

enum ( AutoGenerationType )

تعریف می‌کند که آیا وقتی شخصی با امتیاز ضبط به جلسه می‌پیوندد، فضای جلسه به‌طور خودکار ضبط شود یا خیر.

نوع تولید خودکار

تعیین می‌کند که آیا می‌توان یک مصنوع را به طور خودکار در فضای جلسه تولید کرد یا خیر.

انوم‌ها
AUTO_GENERATION_TYPE_UNSPECIFIED مقدار پیش‌فرض توسط سیاست کاربر مشخص شده است. این مقدار هرگز نباید بازگردانده شود.
ON مصنوع به طور خودکار تولید می‌شود.
OFF مصنوع به طور خودکار تولید نمی‌شود.

پیکربندی رونویسی

پیکربندی مربوط به رونویسی در فضای جلسه.

نمایش JSON
{
  "autoTranscriptionGeneration": enum (AutoGenerationType)
}
فیلدها
autoTranscriptionGeneration

enum ( AutoGenerationType )

تعریف می‌کند که آیا محتوای جلسه، وقتی شخصی که امتیاز رونویسی دارد به جلسه می‌پیوندد، به‌طور خودکار رونویسی شود یا خیر.

پیکربندی SmartNotes

پیکربندی مربوط به یادداشت‌های هوشمند در فضای جلسه. برای اطلاعات بیشتر در مورد یادداشت‌های هوشمند، به «یادداشت‌برداری برای من» در Google Meet مراجعه کنید.

نمایش JSON
{
  "autoSmartNotesGeneration": enum (AutoGenerationType)
}
فیلدها
autoSmartNotesGeneration

enum ( AutoGenerationType )

تعریف می‌کند که آیا وقتی شخصی با امتیاز فعال کردن یادداشت‌های هوشمند به جلسه می‌پیوندد، به‌طور خودکار خلاصه و جمع‌بندی جلسه برای همه مدعوین در سازمان ایجاد شود یا خیر.

کنفرانس فعال

کنفرانس فعال.

نمایش JSON
{
  "conferenceRecord": string
}
فیلدها
conferenceRecord

string

فقط خروجی. ارجاع به منبع 'ConferenceRecord'. قالب: conferenceRecords/{conferenceRecord} که در آن {conferenceRecord} یک شناسه منحصر به فرد برای هر نمونه از فراخوانی درون یک فاصله است.

دسترسی به تلفن

دسترسی به تلفن شامل اطلاعات مورد نیاز برای تماس با یک کنفرانس با استفاده از شماره تلفن منطقه‌ای و یک پین مختص به آن شماره تلفن است.

نمایش JSON
{
  "phoneNumber": string,
  "pin": string,
  "regionCode": string,
  "languageCode": string
}
فیلدها
phoneNumber

string

شماره تلفن برای تماس با این فضای جلسه در قالب E.164. شماره تلفن کامل با علامت «+» در ابتدای آن.

pin

string

پینی که کاربران پس از شماره‌گیری شماره داده شده باید وارد کنند. این پین فقط از ارقام اعشاری تشکیل شده و طول آن ممکن است متفاوت باشد.

regionCode

string

کد منطقه CLDR/ISO 3166 برای کشور مرتبط با این دسترسی تلفن. برای تجزیه توسط ابزار i18n RegionCode. مثال: "SE" برای سوئد.

languageCode

string

کد زبان BCP 47/LDML برای زبان مرتبط با این دسترسی تلفن. برای تجزیه توسط ابزار i18n LanguageCode. مثال‌ها: "es-419" برای اسپانیایی آمریکای لاتین، "fr-CA" برای فرانسوی کانادایی.

گیت‌وی‌سیپ‌اکسس

جزئیات نحوه پیوستن به کنفرانس از طریق دروازه SIP.

نمایش JSON
{
  "uri": string,
  "sipAccessCode": string
}
فیلدها
uri

string

آدرس اینترنتی پروتکل شروع جلسه (SIP) که از طریق آن می‌توان به کنفرانس دسترسی پیدا کرد.

رشته به یکی از این قالب‌ها است:

که در آن USER_ID پین جهانی ۱۳ رقمی است (و در آینده امکان پشتیبانی از کد جلسه Meet نیز وجود خواهد داشت) و GATEWAY_ADDRESS یک آدرس معتبر است که باید با استفاده از جستجوی DNS SRV یا یک مربع نقطه‌چین تعیین شود.

sipAccessCode

string

کد عددی دائمی برای ورود دستی در دستگاه‌های پیکربندی‌شده‌ی خاص.

روش‌ها

create

فضایی ایجاد می‌کند.

endActiveConference

یک کنفرانس فعال (در صورت وجود) را پایان می‌دهد.

get

جزئیات مربوط به فضای جلسه را دریافت می‌کند.

patch

جزئیات مربوط به فضای جلسه را به‌روزرسانی می‌کند.