Method: contactGroups.members.modify

تعديل أعضاء مجموعة جهات اتصال يملكها مستخدم تمت مصادقته

مجموعات جهات اتصال النظام الوحيدة التي يمكن إضافة أعضاء إليها هي contactGroups/myContacts وcontactGroups/starred. تم إيقاف مجموعات جهات اتصال النظام الأخرى نهائيًا، ولا يمكن سوى إزالة جهات الاتصال فقط.

طلب HTTP

POST https://people.googleapis.com/v1/{resourceName=contactGroups/*}/members:modify

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

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

المَعلمات
resourceName

string

مطلوبة. اسم المورد لمجموعة جهات الاتصال المراد تعديلها.

نص الطلب

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

تمثيل JSON 
{
  "resourceNamesToAdd": [
    string
  ],
  "resourceNamesToRemove": [
    string
  ]
}
الحقول
resourceNamesToAdd[]

string

اختياريّ. تمثّل هذه السمة أسماء الموارد لجهة الاتصال المطلوب إضافتها على شكل people/{person_id}. يجب أن يكون إجمالي عدد أسماء الموارد في resourceNamesToAdd وresourceNamesToRemove أقل من أو يساوي 1000.
resourceNamesToRemove[]

string

اختياريّ. تمثّل هذه السمة أسماء الموارد لجهة الاتصال المطلوب إزالتها في شكل people/{person_id}. يجب أن يكون إجمالي عدد أسماء الموارد في resourceNamesToAdd وresourceNamesToRemove أقل من أو يساوي 1000.

نص الاستجابة

الرد على طلب تعديل أعضاء مجموعة جهات الاتصال.

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

تمثيل JSON 
{
  "notFoundResourceNames": [
    string
  ],
  "canNotRemoveLastContactGroupResourceNames": [
    string
  ]
}
الحقول
notFoundResourceNames[]

string

أسماء موارد جهات الاتصال التي لم يتم العثور عليها
canNotRemoveLastContactGroupResourceNames[]

string

أسماء موارد جهات الاتصال التي لا يمكن إزالتها من مجموعة جهات الاتصال الأخيرة.

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

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

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

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