يمكنك إنشاء مجموعة جهات اتصال جديدة يملكها المستخدم الذي تمت المصادقة عليه.
يجب أن تكون أسماء مجموعات جهات الاتصال التي تم إنشاؤها فريدة لمجموعات جهات اتصال المستخدمين. ستؤدي محاولة إنشاء مجموعة باسم مكرر إلى عرض خطأ HTTP 409.
يجب إرسال طلبات التبديل للمستخدم نفسه بشكل تسلسلي لتجنُّب زيادة وقت الاستجابة وعمليات الإخفاق.
طلب HTTP
POST https://people.googleapis.com/v1/contactGroups
يستخدم عنوان URL بنية تحويل الترميز gRPC.
نص الطلب
يحتوي نص الطلب على بيانات بالبنية التالية:
تمثيل JSON |
---|
{
"contactGroup": {
object ( |
الحقول | |
---|---|
contactGroup |
مطلوبة. مجموعة جهات الاتصال المراد إنشاؤها |
readGroupFields |
اختياريّ. قناع حقل لتقييد الحقول التي يتم عرضها في المجموعة يتم ضبط الإعدادات التلقائية على
|
نص الاستجابة
إذا كانت الاستجابة ناجحة، يحتوي نص الاستجابة على مثيل ContactGroup
تم إنشاؤه حديثًا.
نطاقات التفويض
يجب توفير نطاق OAuth التالي:
https://www.googleapis.com/auth/contacts
لمزيد من المعلومات، يُرجى الاطّلاع على دليل التفويض.