Method: spaces.setup

لإنشاء مساحة وإضافة مستخدمين محدّدين إليها تتم إضافة المستخدم المتصل تلقائيًا إلى المساحة، ويجب عدم تحديده كعضوية في الطلب. على سبيل المثال، يُرجى الاطّلاع على إعداد مساحة تتضمّن أعضاءً أوليين.

لتحديد المستخدمين المطلوب إضافتهم، أضِف العضويات باستخدام membership.member.name المناسب. لإضافة مستخدم، استخدِم users/{user}، حيث يمكن أن يكون {user} عنوان البريد الإلكتروني للمستخدم. بالنسبة إلى المستخدمين في مؤسسة Workspace نفسها، يمكن أن يكون {user} أيضًا id للمستخدم من People API أو id للمستخدم في Directory API. على سبيل المثال، إذا كان رقم تعريف الملف الشخصي للمستخدم user@example.com في People API هو 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)
  },
  "requestId": string,
  "memberships": [
    {
      object (Membership)
    }
  ]
}
الحقول
space

object (Space)

مطلوب. حقل Space.spaceType مطلوب.

لإنشاء مساحة، يجب ضبط Space.spaceType على SPACE وضبط Space.displayName. إذا ظهرت لك رسالة الخطأ ALREADY_EXISTS عند إعداد مساحة، جرِّب displayName مختلفًا. قد تستخدم مساحة حالية ضمن مؤسسة Google Workspace هذا الاسم المعروض.

لإنشاء محادثة جماعية، اضبط Space.spaceType على GROUP_CHAT. لا تضبط Space.displayName.

لإنشاء محادثة بين مستخدمَين، اضبط Space.spaceType على DIRECT_MESSAGE واضبط Space.singleUserBotDm على false. لا تضبط القيمة على Space.displayName أو Space.spaceDetails.

لإنشاء محادثة بين شخص وتطبيق Chat، اضبط Space.spaceType على DIRECT_MESSAGE وSpace.singleUserBotDm على true. لا تضبط القيمة على Space.displayName أو Space.spaceDetails.

إذا كانت مساحة DIRECT_MESSAGE متوفّرة، يتم عرض هذه المساحة بدلاً من إنشاء مساحة جديدة.
requestId

string

اختياريّ. معرّف فريد لهذا الطلب. يُنصح باستخدام معرّف UUID عشوائي. يؤدي تحديد معرّف طلب حالي إلى عرض المساحة التي تم إنشاؤها باستخدام هذا المعرّف بدلاً من إنشاء مساحة جديدة. يؤدي تحديد معرّف طلب حالي من تطبيق Chat نفسه باستخدام مستخدم تمّت مصادقته بشكل مختلف إلى ظهور خطأ.
memberships[]

object (Membership)

اختياريّ. مستخدمو Google Chat أو المجموعات المطلوب دعوتها للانضمام إلى المساحة حذف المستخدم المتصل، لأنّه تتم إضافته تلقائيًا

تتيح المجموعة حاليًا ما يصل إلى 20 اشتراكًا داعمًا (بالإضافة إلى المتصل).

بالنسبة إلى الاشتراكات البشرية، يجب أن يحتوي الحقل Membership.member على user تمّت تعبئة name فيه (التنسيق: users/{user}) وتم ضبط type على User.Type.HUMAN. لا يمكنك إضافة مستخدمين إلا عند إعداد مساحة (لا تتوفّر إضافة تطبيقات Chat إلا لإعداد الرسائل المباشرة باستخدام تطبيق الاتصال). يمكنك أيضًا إضافة أعضاء باستخدام عنوان البريد الإلكتروني للمستخدم كعنوان بديل لـ {user}. على سبيل المثال، يمكن أن يكون user.name هو users/example@gmail.com. لدعوة مستخدمي Gmail أو المستخدمين من نطاقات Google Workspace الخارجية، يجب استخدام عنوان البريد الإلكتروني للمستخدم من أجل {user}.

بالنسبة إلى اشتراكات مجموعات Google، يجب أن يحتوي الحقل Membership.group_member على group تمّت تعبئة name فيه (بالتنسيق groups/{group}). لا يمكنك إضافة مجموعات Google إلا عند ضبط Space.spaceType على SPACE.

اختيارية عند ضبط Space.spaceType على SPACE.

مطلوبة عند ضبط Space.spaceType على GROUP_CHAT، مع عضويتَين على الأقل.

مطلوب عند ضبط Space.spaceType على DIRECT_MESSAGE مع مستخدم بشري، بالإضافة إلى اشتراك واحد بالضبط.

يجب أن تكون فارغة عند إنشاء محادثة بين شخص وتطبيق Chat (عند ضبط Space.spaceType على DIRECT_MESSAGE وSpace.singleUserBotDm على true).

نص الاستجابة

إذا كانت الاستجابة ناجحة، يحتوي نص الاستجابة على مثال Space.

نطاقات التفويض

يتطلب أحد نطاقات OAuth التالية:

  • https://www.googleapis.com/auth/chat.spaces
  • https://www.googleapis.com/auth/chat.spaces.create

لمزيد من المعلومات، يُرجى الاطّلاع على دليل التفويض.