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 أقل من أو يساوي 1,000.
resourceNamesToRemove[]

string

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

نص الاستجابة

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

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

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

string

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

string

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

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

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

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

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