Method: contactGroups.create

یک گروه تماس جدید متعلق به کاربر تأیید شده ایجاد کنید.

نام گروه مخاطب ایجاد شده باید منحصر به گروه مخاطبین کاربران باشد. تلاش برای ایجاد یک گروه با نام تکراری، خطای HTTP 409 را برمی‌گرداند.

درخواست های جهش برای همان کاربر باید به صورت متوالی ارسال شوند تا از افزایش تاخیر و خرابی جلوگیری شود.

درخواست HTTP

POST https://people.googleapis.com/v1/contactGroups

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

درخواست بدن

بدنه درخواست حاوی داده هایی با ساختار زیر است:

نمایندگی JSON 
{
  "contactGroup": {
    object (ContactGroup)
  },
  "readGroupFields": string
}
فیلدها
contactGroup

object ( ContactGroup )

مورد نیاز. گروه تماس برای ایجاد.

readGroupFields

string ( FieldMask format)

اختیاری. یک فیلد ماسک برای محدود کردن اینکه کدام فیلدها در گروه بازگردانده شوند. پیش‌فرض metadata ، groupType ، و name اگر تنظیم نشده باشد یا خالی باشد. فیلدهای معتبر عبارتند از:

  • کلاینت دیتا
  • نوع گروه
  • فراداده
  • نام

بدن پاسخگو

در صورت موفقیت آمیز بودن، بدنه پاسخ حاوی یک نمونه تازه ایجاد شده از ContactGroup است.

محدوده مجوز

به محدوده OAuth زیر نیاز دارد:

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

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