یک مخاطب جدید ایجاد کنید و منبع شخصی آن مخاطب را برگردانید.
در صورتی که بیش از یک فیلد در فیلدی که برای منابع تماس تک تن است مشخص شده باشد، درخواست خطای 400 را برمی گرداند:
- بیوگرافی ها
- تولدها
- جنسیت ها
- نام ها
درخواست های جهش برای همان کاربر باید به صورت متوالی ارسال شوند تا از افزایش تاخیر و خرابی جلوگیری شود.
درخواست HTTP
POST https://people.googleapis.com/v1/people:createContact
URL از دستور GRPC Transcoding استفاده می کند.
پارامترهای پرس و جو
| مولفه های | |
|---|---|
personFields | ضروری. یک فیلد ماسک برای محدود کردن اینکه کدام فیلد برای هر فرد بازگردانده می شود. چندین فیلد را می توان با جدا کردن آنها با کاما مشخص کرد. در صورت تنظیم نشدن، همه فیلدها پیش‌فرض است. مقادیر معتبر عبارتند از:
|
sources[] | اختیاری. ماسکی از نوع منبع برای بازگشت. در صورت تنظیم نشدن، پیش‌فرض |
درخواست بدن
بدنه درخواست شامل نمونه ای از Person است.
بدن پاسخگو
در صورت موفقیت آمیز بودن، بدنه پاسخ حاوی نمونه ای از Person است.
محدوده مجوز
به محدوده OAuth زیر نیاز دارد:
-
https://www.googleapis.com/auth/contacts
برای اطلاعات بیشتر، به راهنمای مجوز مراجعه کنید.