Method: contactGroups.create

يمكنك إنشاء مجموعة جهات اتصال جديدة يملكها المستخدم الذي تمت المصادقة عليه.

يجب أن تكون أسماء مجموعات جهات الاتصال التي تم إنشاؤها فريدة لمجموعات جهات اتصال المستخدمين. ستؤدي محاولة إنشاء مجموعة باسم مكرر إلى عرض خطأ HTTP 409.

يجب إرسال طلبات التبديل للمستخدم نفسه بشكل تسلسلي لتجنُّب زيادة وقت الاستجابة وعمليات الإخفاق.

طلب HTTP

POST https://people.googleapis.com/v1/contactGroups

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

نص الطلب

يحتوي نص الطلب على بيانات بالبنية التالية:

تمثيل JSON 
{
  "contactGroup": {
    object (ContactGroup)
  },
  "readGroupFields": string
}
الحقول
contactGroup

object (ContactGroup)

مطلوبة. مجموعة جهات الاتصال المراد إنشاؤها
readGroupFields

string (FieldMask format)

اختياريّ. قناع حقل لتقييد الحقول التي يتم عرضها في المجموعة يتم ضبط الإعدادات التلقائية على metadata وgroupType وname إذا لم يتم ضبط السياسة أو تم ضبطها على "فارغ". الحقول الصالحة هي:

  • clientData
  • groupType
  • البيانات الوصفية
  • اسم

نص الاستجابة

إذا كانت الاستجابة ناجحة، يحتوي نص الاستجابة على مثيل ContactGroup تم إنشاؤه حديثًا.

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

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

  • https://www.googleapis.com/auth/contacts

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