Method: people.batchCreateContacts

قم بإنشاء مجموعة من جهات الاتصال الجديدة وعرض PersonResponses لأول مرة

يجب إرسال طلبات التبديل للمستخدم نفسه بشكل تسلسلي لتجنُّب زيادة وقت الاستجابة وعمليات الإخفاق.

طلب HTTP

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

يستخدم عنوان URL بنية تحويل الترميز gRPC.

نص الطلب

يحتوي نص الطلب على بيانات بالبنية التالية:

تمثيل JSON 
{
  "contacts": [
    {
      object (ContactToCreate)
    }
  ],
  "readMask": string,
  "sources": [
    enum (ReadSourceType)
  ]
}
الحقول
contacts[]

object (ContactToCreate)

مطلوبة. جهة الاتصال المطلوب إنشاؤها السماح بما يصل إلى 200 جهة اتصال في طلب واحد
readMask

string (FieldMask format)

مطلوبة. قناع حقل لتقييد الحقول التي يتم عرضها في الرد لكل مستخدم يمكن تحديد عدة حقول من خلال الفصل بينها بفواصل. في حال ترك قناع القراءة فارغًا، يتم تخطي مرحلة post-mutate-get ولن يتم عرض أي بيانات في الردّ. القيم الصالحة هي:

  • عنوان واحد
  • ageRanges
  • السير الذاتية
  • أعياد الميلاد
  • calendarUrls
  • clientData
  • coverPhotos
  • emailAddresses
  • الفعاليات
  • externalIds
  • أنواع
  • imClients
  • الاهتمامات
  • locales
  • المواقع الجغرافية
  • للقناة
  • البيانات الوصفية
  • miscKeywords
  • names
  • الألقاب
  • المهن
  • organizations
  • phoneNumbers
  • صور
  • علاقات
  • sipAddresses
  • مهارات
  • urls
  • userDefined
sources[]

enum (ReadSourceType)

اختياريّ. صورة لأنواع المصادر المطلوب عرضها في قراءة المشاركة بعد التبديل. ويتم ضبط الإعدادات التلقائية على READ_SOURCE_TYPE_CONTACT وREAD_SOURCE_TYPE_PROFILE إذا لم يتم ضبطها.

نص الاستجابة

إذا لم تنجح هذه العملية، سيتم عرض الخطأ BatchCreateContactsErrorDetails الذي يحتوي على قائمة بالأخطاء لكل جهة اتصال غير صالحة.

الاستجابة لطلب إنشاء مجموعة من جهات الاتصال.

إذا كانت الاستجابة ناجحة، سيحتوي نص الاستجابة على بيانات بالبنية التالية:

تمثيل JSON 
{
  "createdPeople": [
    {
      object (PersonResponse)
    }
  ]
}
الحقول
createdPeople[]

object (PersonResponse)

جهات الاتصال التي تم إنشاؤها، ما لم يكن الطلب readMask فارغًا

نطاقات التفويض

يجب توفير نطاق OAuth التالي:

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

لمزيد من المعلومات، يُرجى الاطّلاع على دليل التفويض.

ContactToCreate

برنامج تضمين يحتوي على بيانات المستخدم لتعبئة مصدر تم إنشاؤه حديثًا.

تمثيل JSON 
{
  "contactPerson": {
    object (Person)
  }
}
الحقول
contactPerson

object (Person)

مطلوبة. بيانات الشخص لتعبئة مصدر تم إنشاؤه حديثًا.