Method: spaces.members.batchUpdate

تعدّل هذه الطريقة أعضاء مساحة واحدة ضمن مجموعة.

طلب HTTP

POST https://meet.googleapis.com/v2/{parent=spaces/*}/members:batchUpdate

يستخدم عنوان URL بنية تحويل الترميز إلى gRPC.

مَعلمات المسار

المعلمات
parent

string

الحقل مطلوب. تم تعديل المرجع الرئيسي الذي يشاركه جميع الأعضاء. التنسيق: spaces/{space}

نص الطلب

يتضمن نص الطلب بيانات بالبنية التالية:

تمثيل JSON 
{
  "requests": [
    {
      object (UpdateMemberRequest)
    }
  ],
  "updateMask": string
}
الحقول
requests[]

object (UpdateMemberRequest)

الحقل مطلوب. رسالة الطلب التي تحدّد الموارد المطلوب تعديلها. يمكن تعديل 500 عضو كحد أقصى في دفعة واحدة.
updateMask

string (FieldMask format)

اختياريّ. قناع الحقل ذو المستوى الأعلى المستخدَم لتحديد الحقول التي سيتم تعديلها في العضو لجميع طلبات UpdateMemberRequests. هناك 4 سيناريوهات محتملة لقناع الحقل على المستوى الأعلى والمستوى الفرعي: 1. عدم توفّر قناع الحقل على المستوى الأعلى والمستوى الفرعي: يتم تعديل جميع الحقول المقدَّمة في الطلبات، بما في ذلك حذف الحقول غير المحدّدة في الطلبات. ‫2- قناع الحقل ذو المستوى الأعلى متوفّر ولكن قناع الحقل الفرعي غير متوفّر: يتم تعديل الحقول المحدّدة في قناع الحقل ذي المستوى الأعلى. ‫3- يتوفّر قناع الحقل على مستوى أعلى ومستوى أدنى: يجب أن يكون قناع الحقل على مستوى أدنى هو نفسه قناع الحقل على مستوى أعلى. ‫4- قناع الحقل ذو المستوى الأعلى غير متوفّر ولكن قناع الحقل الفرعي متوفّر: لا يُتاح ذلك وسيتم عرض خطأ.

نص الاستجابة

ردّ على تعديلات مجمّعة للأعضاء

إذا كانت الاستجابة ناجحة، سيحتوي نص الاستجابة على بيانات بالبنية التالية:

تمثيل JSON 
{
  "members": [
    {
      object (Member)
    }
  ]
}
الحقول
members[]

object (Member)

تم تعديل الأعضاء.

نطاقات الأذونات

يجب توفير نطاق OAuth التالي:

  • https://www.googleapis.com/auth/meetings.space.created

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

UpdateMemberRequest

طلب تعديل عضو

تمثيل JSON 
{
  "member": {
    object (Member)
  },
  "updateMask": string
}
الحقول
member

object (Member)

الحقل مطلوب. تمثّل هذه السمة العضو المطلوب تعديله. التنسيق: spaces/{space}/members/{member}
updateMask

string (FieldMask format)

اختياريّ. قناع الحقل المستخدَم لتحديد الحقول التي سيتم تعديلها في العضو. في حال عدم توفير updateMask(أي لم يتم ضبطه أو تم ضبطه باستخدام مسارات فارغة أو كان يحتوي على "" فقط كمسارات)، سيتم تلقائيًا تعديل جميع الحقول التي تم توفير قيم لها في الطلب. سيؤدي استخدام "*" كـ updateMask إلى تعديل جميع الحقول، بما في ذلك حذف الحقول التي لم يتم ضبطها في الطلب. في حال استخدام BatchUpdate، يجب ألا يكون موجودًا أو أن يكون مطابقًا لـ updateMask في BatchUpdateMembersRequest عند إنشاء UpdateMemberRequest كطلب فرعي من BatchUpdateMembersRequest.