يتم إنشاء مساحة وإضافة مستخدمين محدّدين إليها. تتم إضافة المستخدم المتصل تلقائيًا إلى المساحة، ويجب عدم تحديده كعضوية في الطلب. على سبيل المثال، يُرجى الاطّلاع على إعداد مساحة تتضمن الأعضاء الأولين.
لتحديد الأعضاء المطلوب إضافتهم، أضِف العضويات باستخدام السمة membership.member.name
المناسبة. لإضافة مستخدم، استخدِم users/{user}
، حيث يمكن أن يكون {user}
عنوان البريد الإلكتروني للمستخدم. بالنسبة إلى المستخدمين في مؤسسة Workspace نفسها، يمكن أن يكون {user}
أيضًا id
للمستخدم من People API أو id
للمستخدم في Directory API. على سبيل المثال، إذا كان رقم تعريف الملف الشخصي للمستخدم في People API في user@example.com
هو 123456789
، يمكنك إضافة المستخدم إلى المساحة من خلال ضبط membership.member.name
على users/user@example.com
أو users/123456789
.
لتحديد مجموعات Google المطلوب إضافتها، أضِف العضويات باستخدام الرمز membership.group_member.name
المناسب. لإضافة مجموعة Google أو دعوتها، استخدِم groups/{group}
، حيث يكون {group}
هو id
للمجموعة من Cloud Identity Groups API. على سبيل المثال، يمكنك استخدام Cloud Identity Groups lookup API لاسترداد المعرّف 123456789
لعنوان البريد الإلكتروني للمجموعة group@example.com
، ثم يمكنك إضافة المجموعة إلى المساحة من خلال ضبط membership.group_member.name
على groups/123456789
. البريد الإلكتروني للمجموعة غير متاح ولا يمكن إضافة "مجموعات Google" إلا كأعضاء في المساحات المُعنونة.
بالنسبة إلى مساحة مُسمّاة أو محادثة جماعية، إذا حظر المتصل بعض الأعضاء أو حظروا المتصل، أو إذا لم يكن لديه الإذن بإضافة بعض الأعضاء، لن تتم إضافة هؤلاء الأعضاء إلى المساحة التي تم إنشاؤها.
لإنشاء رسالة مباشرة بين المستخدم المتصل ومستخدم آخر، حدِّد عضوية واحدة بالضبط لتمثيل المستخدم. إذا حظر أحد المستخدمين الآخر، لن يتمكّن المستخدم من الطلب ولا يتم إنشاء الرسالة المباشرة.
لإنشاء رسالة مباشرة بين المستخدم المتصل والتطبيق المتصل، اضبط Space.singleUserBotDm
على true
ولا تحدِّد أي عضويات. يمكنك فقط استخدام هذه الطريقة لإعداد رسالة مباشرة باستخدام تطبيق الاتصال. لإضافة تطبيق الاتصال كعضو في مساحة أو رسالة مباشرة حالية بين مستخدمَين، يمكنك الاطّلاع على مقالة دعوة مستخدم أو تطبيق أو إضافتهما إلى مساحة.
إذا كانت هناك رسالة مباشرة بين مستخدمَين، حتى إذا حظر أحدهما الآخر في وقت تقديم الطلب، سيتم عرض الرسالة المباشرة الحالية.
المساحات التي تحتوي على ردود ضمن سلاسل غير متاحة. إذا ظهرت لك رسالة الخطأ ALREADY_EXISTS
عند إعداد مساحة، جرِّب استخدام displayName
آخر. قد تستخدم مساحة حالية في مؤسسة Google Workspace هذا الاسم المعروض.
يتطلب مصادقة المستخدم.
طلب HTTP
POST https://chat.googleapis.com/v1/spaces:setup
يستخدِم عنوان URL بنية تحويل ترميز gRPC.
نص الطلب
يحتوي نص الطلب على بيانات بالبنية التالية:
تمثيل JSON |
---|
{ "space": { object ( |
الحقول | |
---|---|
space |
مطلوب. يجب ملء الحقل لإنشاء مساحة، يجب ضبط لإنشاء محادثة جماعية، اضبط لإنشاء محادثة بين شخصين، اضبط لإنشاء محادثة فردية بين مستخدم وتطبيق Chat الذي يجري الاتصال، اضبط إذا كانت مساحة |
request |
اختياريّ. معرّف فريد لهذا الطلب. يُنصح باستخدام معرّف UUID عشوائي. يؤدي تحديد رقم تعريف طلب حالي إلى عرض المساحة التي تم إنشاؤها باستخدام رقم التعريف هذا بدلاً من إنشاء مساحة جديدة. يؤدي تحديد معرّف طلب حالي من تطبيق Chat نفسه باستخدام مستخدم تمّت مصادقته بشكل مختلف إلى ظهور خطأ. |
memberships[] |
اختياريّ. مستخدمو Google Chat أو المجموعات المطلوب دعوتها للانضمام إلى المساحة احذف اسم المستخدم المتصل لأنّه تتم إضافته تلقائيًا. تتيح المجموعة حاليًا ما يصل إلى 20 اشتراكًا داعمًا (بالإضافة إلى المتصل). بالنسبة إلى الاشتراكات البشرية، يجب أن يحتوي الحقل بالنسبة إلى اشتراك مجموعة Google، يجب أن يحتوي حقل اختيارية عند ضبط مطلوبة عند ضبط مطلوبة عند ضبط السمة يجب أن يكون هذا الحقل فارغًا عند إنشاء محادثة بين مستخدم وتطبيق Chat الذي يجري الاتصال (عند ضبط |
نص الاستجابة
إذا كانت الاستجابة ناجحة، يحتوي نص الاستجابة على مثال Space
.
نطاقات التفويض
يتطلب أحد نطاقات OAuth التالية:
https://www.googleapis.com/auth/chat.spaces
https://www.googleapis.com/auth/chat.spaces.create
لمزيد من المعلومات، يُرجى الاطّلاع على دليل التفويض.