قم بإنشاء مجموعة من جهات الاتصال الجديدة وعرض PersonResponses لأول مرة
يجب إرسال طلبات التبديل للمستخدم نفسه بشكل تسلسلي لتجنُّب زيادة وقت الاستجابة وعمليات الإخفاق.
طلب HTTP
POST https://people.googleapis.com/v1/people:batchCreateContacts
يستخدم عنوان URL بنية تحويل الترميز gRPC.
نص الطلب
يحتوي نص الطلب على بيانات بالبنية التالية:
تمثيل JSON |
---|
{ "contacts": [ { object ( |
الحقول | |
---|---|
contacts[] |
مطلوبة. جهة الاتصال المطلوب إنشاؤها السماح بما يصل إلى 200 جهة اتصال في طلب واحد |
readMask |
مطلوبة. قناع حقل لتقييد الحقول التي يتم عرضها في الرد لكل مستخدم يمكن تحديد عدة حقول من خلال الفصل بينها بفواصل. في حال ترك قناع القراءة فارغًا، يتم تخطي مرحلة post-mutate-get ولن يتم عرض أي بيانات في الردّ. القيم الصالحة هي:
|
sources[] |
اختياريّ. صورة لأنواع المصادر المطلوب عرضها في قراءة المشاركة بعد التبديل. ويتم ضبط الإعدادات التلقائية على |
نص الاستجابة
إذا لم تنجح هذه العملية، سيتم عرض الخطأ BatchCreateContactsErrorDetails
الذي يحتوي على قائمة بالأخطاء لكل جهة اتصال غير صالحة.
الاستجابة لطلب إنشاء مجموعة من جهات الاتصال.
إذا كانت الاستجابة ناجحة، سيحتوي نص الاستجابة على بيانات بالبنية التالية:
تمثيل JSON |
---|
{
"createdPeople": [
{
object ( |
الحقول | |
---|---|
createdPeople[] |
جهات الاتصال التي تم إنشاؤها، ما لم يكن الطلب |
نطاقات التفويض
يجب توفير نطاق OAuth التالي:
https://www.googleapis.com/auth/contacts
لمزيد من المعلومات، يُرجى الاطّلاع على دليل التفويض.
ContactToCreate
برنامج تضمين يحتوي على بيانات المستخدم لتعبئة مصدر تم إنشاؤه حديثًا.
تمثيل JSON |
---|
{
"contactPerson": {
object ( |
الحقول | |
---|---|
contactPerson |
مطلوبة. بيانات الشخص لتعبئة مصدر تم إنشاؤه حديثًا. |