Method: otherContacts.copyOtherContactToMyContactsGroup

یک "مخاطب دیگر" را در یک مخاطب جدید در گروه "myContacts" کاربر کپی می کند

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

درخواست HTTP

POST https://people.googleapis.com/v1/{resourceName=otherContacts/*}:copyOtherContactToMyContactsGroup

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

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

مولفه های
resourceName

string

ضروری. نام منبع "دیگر مخاطب" برای کپی کردن.

درخواست بدن

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

نمایندگی JSON
{
  "copyMask": string,
  "readMask": string,
  "sources": [
    enum (ReadSourceType)
  ]
}
زمینه های
copyMask

string ( FieldMask format)

ضروری. یک فیلد ماسک برای محدود کردن اینکه کدام فیلدها در مخاطب جدید کپی شوند. مقادیر معتبر عبارتند از:

  • آدرس ایمیل
  • نام ها
  • شماره تلفن ها
readMask

string ( FieldMask format)

اختیاری. یک فیلد ماسک برای محدود کردن اینکه کدام فیلدها بر روی شخص بازگردانده می شوند. چندین فیلد را می توان با جدا کردن آنها با کاما مشخص کرد. در صورت تنظیم نشدن، به طور پیش‌فرض به ماسک کپی با فیلدهای فراداده و عضویت می‌رسد. مقادیر معتبر عبارتند از:

  • آدرس ها
  • محدوده سنی
  • بیوگرافی ها
  • تولدها
  • calendarUrls
  • کلاینت دیتا
  • عکسهای روی جلد
  • آدرس ایمیل
  • مناسبت ها
  • شناسه های خارجی
  • جنسیت ها
  • imClients
  • منافع
  • مناطق
  • مکان ها
  • عضویت ها
  • فراداده
  • کلمات کلیدی اشتباه
  • نام ها
  • نام مستعار
  • مشاغل
  • سازمان های
  • شماره تلفن ها
  • عکس ها
  • روابط
  • آدرس های sip
  • مهارت ها
  • آدرس های اینترنتی
  • تعریف شده توسط کاربر
sources[]

enum ( ReadSourceType )

اختیاری. ماسکی از نوع منبع برای بازگشت. در صورت تنظیم نشدن، پیش‌فرض READ_SOURCE_TYPE_CONTACT و READ_SOURCE_TYPE_PROFILE .

بدن پاسخگو

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

محدوده مجوز

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

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

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