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

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