يمكنك تعديل أعضاء مجموعة جهات اتصال يمتلكها المستخدم الذي تمت مصادقته.
مجموعتا جهات اتصال النظام الوحيدان اللذان يمكن إضافة أعضاء إليهما هما contactGroups/myContacts
وcontactGroups/starred
. يتم إيقاف مجموعات جهات اتصال النظام الأخرى نهائيًا ويمكن إزالة جهات الاتصال فقط منها.
طلب HTTP
POST https://people.googleapis.com/v1/{resourceName=contactGroups/*}/members:modify
يستخدِم عنوان URL بنية تحويل ترميز gRPC.
مَعلمات المسار
المعلمات | |
---|---|
resourceName |
مطلوب. اسم المورد لمجموعة جهات الاتصال المطلوب تعديلها. |
نص الطلب
يحتوي نص الطلب على بيانات بالبنية التالية:
تمثيل JSON |
---|
{ "resourceNamesToAdd": [ string ], "resourceNamesToRemove": [ string ] } |
الحقول | |
---|---|
resourceNamesToAdd[] |
اختياريّ. أسماء الموارد لجهات الاتصال المطلوب إضافتها في شكل |
resourceNamesToRemove[] |
اختياريّ. تمثّل هذه السمة أسماء الموارد لجهات الاتصال المطلوب إزالتها في شكل |
نص الاستجابة
الرد على طلب تعديل أعضاء مجموعة جهات الاتصال.
إذا كانت الاستجابة ناجحة، سيحتوي نص الاستجابة على بيانات بالبنية التالية:
تمثيل JSON |
---|
{ "notFoundResourceNames": [ string ], "canNotRemoveLastContactGroupResourceNames": [ string ] } |
الحقول | |
---|---|
notFoundResourceNames[] |
أسماء موارد جهات الاتصال التي لم يتم العثور عليها |
canNotRemoveLastContactGroupResourceNames[] |
أسماء موارد جهات الاتصال التي لا يمكن إزالتها من مجموعة جهات الاتصال الأخيرة |
نطاقات الأذونات
يجب توفير نطاق OAuth التالي:
https://www.googleapis.com/auth/contacts
لمزيد من المعلومات، يُرجى الاطّلاع على دليل التفويض.