Method: people.updateContact

اطلاعات تماس را برای یک فرد مخاطب موجود به روز کنید. هر گونه داده غیر تماسی اصلاح نخواهد شد. هر گونه داده غیر تماسی در شخص مورد نظر برای به روز رسانی نادیده گرفته می شود. همه فیلدهای مشخص شده در updateMask جایگزین خواهند شد.

اگر person.metadata.sources برای به‌روزرسانی مخاطب مشخص نشده باشد یا منبع تماسی وجود نداشته باشد، سرور یک خطای 400 برمی‌گرداند.

اگر person.metadata.sources.etag با برچسب مخاطب متفاوت باشد، سرور یک خطای 400 را با دلیل "failedPrecondition" برمی‌گرداند که نشان می‌دهد مخاطب از زمان خوانده شدن داده‌هایش تغییر کرده است. مشتریان باید آخرین فرد را دریافت کنند و به روز رسانی های خود را با آخرین فرد ادغام کنند.

اگر memberships در حال به‌روزرسانی هستند و هیچ عضویت گروه مخاطبی روی شخص مشخص نشده باشد، سرور یک خطای 400 را برمی‌گرداند.

اگر بیش از یک فیلد در فیلدی که برای منابع تماس تک تن است مشخص شده باشد، سرور یک خطای 400 برمی‌گرداند:

  • بیوگرافی ها
  • تولدها
  • جنسیت ها
  • نام ها

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

درخواست HTTP

PATCH https://people.googleapis.com/v1/{person.resourceName=people/*}:updateContact

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

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

مولفه های
person.resourceName

string

نام منبع برای شخص، اختصاص داده شده توسط سرور. یک رشته ASCII به شکل people/{person_id} .

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

مولفه های
updatePersonFields

string ( FieldMask format)

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

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

string ( FieldMask format)

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

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

enum ( ReadSourceType )

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

درخواست بدن

بدنه درخواست شامل نمونه ای از Person است.

بدن پاسخگو

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

محدوده مجوز

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

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

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