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)

نوع الوصول إلى مساحة الاجتماع الذي يحدّد المستخدمين الذين يمكنهم الانضمام بدون طلب الانضمام الإعداد التلقائي: إعدادات الوصول التلقائية للمستخدم يتحكّم فيه مشرف المستخدمين في المؤسسة أو يكون RESTRICTED.
entryPointAccess

enum (EntryPointAccess)

تحدّد هذه السمة نقاط الدخول التي يمكن استخدامها للانضمام إلى الاجتماعات المستضافة في مساحة الاجتماع هذه. القيمة التلقائية: EntryPointAccess.ALL
moderation

enum (Moderation)

وضع التنسيق الذي تم ضبطه مسبقًا للاجتماع القيمة التلقائية: يتم التحكّم فيها من خلال سياسات المستخدم.
moderationRestrictions

object (ModerationRestrictions)

عندما تكون ميزة "الإشراف" مفعّلة، تسري هذه القيود على الاجتماع. عندما تكون قيمة moderation.OFF، ستتم إعادة ضبطها على ModerationRestrictions التلقائية.
attendanceReportGenerationType

enum (AttendanceReportGenerationType)

تُستخدَم لتحديد ما إذا كان تقرير الحضور مفعَّلاً لمساحة الاجتماع.
artifactConfig

object (ArtifactConfig)

إعدادات تتعلّق بالبيانات التي يتم إنشاؤها تلقائيًا والتي يتيحها الاجتماع

AccessType

أنواع الأذونات المحتملة لمساحة الاجتماعات

عمليات التعداد
ACCESS_TYPE_UNSPECIFIED القيمة التلقائية التي تحدّدها مؤسسة المستخدِم ملاحظة: لا يتم عرض هذا الحقل أبدًا، بل يتم عرض نوع الإذن الذي تم ضبطه بدلاً منه.
OPEN يمكن لأي شخص لديه معلومات الانضمام (مثل عنوان URL أو معلومات الوصول عبر الهاتف) الانضمام بدون طلب الانضمام.
TRUSTED يمكن لأعضاء مؤسسة المضيف والمستخدمين الخارجيين المدعوين والمستخدمين الذين يتصلون هاتفيًا الانضمام إلى الاجتماع بدون طلب إذن. وعلى أي شخص آخر أن يطلب الانضمام إلى الاجتماع.
RESTRICTED يمكن للمدعوين فقط الانضمام بدون طلب إذن. وعلى أي شخص آخر أن يطلب الانضمام إلى الاجتماع.

EntryPointAccess

نقاط الدخول التي يمكن استخدامها للانضمام إلى اجتماع مثال: meet.google.com أو حزمة تطوير البرامج (SDK) لميزة "تضمين Meet" على الويب أو تطبيق على الأجهزة الجوّالة

عمليات التعداد
ENTRY_POINT_ACCESS_UNSPECIFIED غير مستخدَم
ALL يُسمح بجميع نقاط الدخول.
CREATOR_APP_ONLY يمكن استخدام نقاط الدخول التي يملكها مشروع على السحابة الإلكترونية في Google الذي أنشأ المساحة فقط للانضمام إلى الاجتماعات في هذه المساحة. يمكن للتطبيقات استخدام حِزم SDK على الويب أو الأجهزة الجوّالة في Meet لإنشاء نقاط دخول مملوكة.

الإشراف

وضع تنسيق الاجتماع عند تفعيل وضع الإشراف، يمكن لمالك الاجتماع التحكّم فيه بشكل أكبر باستخدام ميزات مثل إدارة المضيفين المشاركين (راجِع الرسالة Member) وقيود الميزات (راجِع الرسالة ModerationRestrictions).

عمليات التعداد
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

يحدّد هذا الإعداد المستخدمين الذين لديهم إذن باستخدام ميزة معيّنة.

عمليات التعداد
RESTRICTION_TYPE_UNSPECIFIED القيمة التلقائية المحدّدة من خلال سياسة المستخدم ولا يُفترَض أن يتم عرض هذا الخطأ أبدًا.
HOSTS_ONLY يجب أن يكون لدى مالك الاجتماع والمضيف المشارك الإذن.
NO_RESTRICTION يملك جميع المشاركين أذونات.

DefaultJoinAsViewerType

سينضم المستخدمون تلقائيًا كمساهمين. يمكن للمستضيفين حصر إمكانية انضمام المستخدمين كمشاهدين فقط. ملاحظة: إذا تم ضبط دور صريح للمستخدمين في مورد "العضو"، سينضم المستخدم بهذا الدور.

عمليات التعداد
DEFAULT_JOIN_AS_VIEWER_TYPE_UNSPECIFIED القيمة التلقائية المحدّدة من خلال سياسة المستخدم ولا يُفترَض أن يتم عرض هذا الخطأ أبدًا.
ON سينضم المستخدمون تلقائيًا كمشاهدين.
OFF سينضم المستخدمون تلقائيًا كمساهمين.

AttendanceReportGenerationType

الحالات المحتملة لما إذا كان تقرير الحضور مفعَّلاً لمساحة الاجتماع.

عمليات التعداد
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

تحدّد هذه السمة ما إذا كان يمكن إنشاء عنصر تلقائيًا في مساحة الاجتماع.

عمليات التعداد
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 الخاص بالبلد المرتبط بإمكانية الوصول إلى الهاتف هذه يجب أن يتم تحليلها بواسطة أداة i18n RegionCode. مثال: "SE" للسويد.
languageCode

string

رمز اللغة BCP 47/LDML للغة المرتبطة بإذن الوصول إلى الهاتف هذا. يجب أن يتم تحليلها بواسطة أداة LanguageCode المساعدة الخاصة بتدويل التطبيقات. أمثلة: "es-419" للإسبانية في أمريكا اللاتينية، و"fr-CA" للفرنسية الكندية.

GatewaySipAccess

تفاصيل حول كيفية الانضمام إلى مكالمة الفيديو من خلال بوابة SIP

تمثيل JSON 
{
  "uri": string,
  "sipAccessCode": string
}
الحقول
uri

string

معرّف الموارد المنتظم (URI) لبروتوكول بدء الجلسة (SIP) الذي يمكن الوصول إلى المؤتمر من خلاله

تكون السلسلة بأحد التنسيقات التالية:

حيث USER_ID هو رقم التعريف الشخصي العالمي المكوّن من 13 رقمًا (مع خيار مستقبلي يتيح استخدام رمز اجتماع Meet أيضًا)، وGATEWAY_ADDRESS هو عنوان صالح يمكن تحديده باستخدام بحث DNS SRV أو رباعي منقّط.
sipAccessCode

string

الرمز الرقمي الدائم الذي يتم إدخاله يدويًا على الأجهزة التي تم ضبطها خصيصًا

الطُرق

create

 تنشئ هذه الطريقة مساحة.

endActiveConference

 لإنهاء اجتماع فيديو نشط (إذا كان هناك اجتماع).

get

 تعرض هذه الطريقة تفاصيل حول مساحة اجتماع.

patch

 تعدّل هذه الطريقة تفاصيل حول مساحة اجتماع.