Method: people.createContact

أنشئ جهة اتصال جديدة وارجع مورد الشخص لجهة الاتصال هذه.

يعرض الطلب خطأ 400 إذا تم تحديد أكثر من حقل واحد في حقل فردي لمصادر جهات الاتصال:

  • سير ذاتية
  • أعياد ميلاد
  • أنواع
  • أسماء

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

طلب HTTP

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

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

معامِلات طلب البحث

المَعلمات
personFields

string (FieldMask format)

مطلوبة. قناع حقل لتقييد الحقول التي يتم عرضها على كل شخص. يمكن تحديد حقول متعددة من خلال فصلها بفواصل. ضبط القيمة التلقائية على جميع الحقول في حال عدم ضبطها. القيم الصالحة هي:

  • عنوان واحد
  • الفئات العمرية
  • سير ذاتية
  • أعياد ميلاد
  • عناوين URL للتقويم
  • بيانات العميل
  • صور الغلاف
  • عناوين البريد الإلكتروني
  • فعاليات
  • المعرّفات الخارجية
  • أنواع
  • عملاء IIM
  • الاهتمامات
  • اللغات
  • مواقع جغرافية
  • للقناة
  • البيانات الوصفية
  • كلمات رئيسية متنوعة
  • أسماء
  • الألقاب
  • مهن
  • المؤسسات
  • أرقام الهاتف
  • صور
  • علاقات
  • sipAddresses
  • مهارات
  • عناوين url
  • من تحديد المستخدم
sources[]

enum (ReadSourceType)

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

نص الطلب

يحتوي نص الطلب على مثال Person.

نص الاستجابة

إذا كانت الاستجابة ناجحة، يحتوي نص الاستجابة على مثال Person.

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

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

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

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