Method: contactGroups.members.modify

اعضای گروه تماس متعلق به کاربر احراز هویت شده را تغییر دهید.

تنها گروه‌های تماس سیستمی که می‌توانند اعضایی اضافه کنند contactGroups/myContacts و contactGroups/starred هستند. سایر گروه‌های مخاطب سیستم منسوخ شده‌اند و فقط می‌توانند مخاطبین را حذف کنند.

درخواست HTTP

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

URL از دستور GRPC Transcoding استفاده می کند.

پارامترهای مسیر

پارامترها
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

برای اطلاعات بیشتر، به راهنمای مجوز مراجعه کنید.