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)

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

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

enum (ReadSourceType)

اختياريّ. قناع لأنواع المصادر التي سيتم عرضها في قراءة mutate التي تعمل على عرضها. ويتم ضبط القيمة التلقائية على 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)

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