Method: people.updateContact

تعديل بيانات جهة الاتصال لجهة اتصال حالية ولن يتم تعديل أي بيانات غير تابعة لجهات الاتصال. سيتم تجاهل أي بيانات غير تابعة لجهات الاتصال في الشخص المطلوب تعديله. سيتم استبدال جميع الحقول المحدّدة في updateMask.

يعرض الخادم الخطأ 400 إذا لم يتم تحديد person.metadata.sources لجهة الاتصال المراد تحديثها أو في حال عدم وجود مصدر جهة اتصال.

يعرض الخادم خطأ 400 السبب "failedPrecondition" إذا كان person.metadata.sources.etag مختلفًا عن العلامة الإلكترونية لجهة الاتصال، ما يشير إلى أنّ جهة الاتصال قد تغيّرت منذ قراءة بياناتها. يجب أن يحصل العملاء على أحدث مستخدم ودمج تعديلاتهم في آخر مستخدم.

يعرض الخادم الخطأ 400 إذا تم تحديث memberships ولم يتم تحديد عضويات في مجموعة جهات اتصال للمستخدم.

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

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

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

طلب HTTP

PATCH https://people.googleapis.com/v1/{person.resourceName=people/*}:updateContact

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

معلمات المسار

المَعلمات
person.resourceName

string

اسم المورد للمستخدم، الذي يعينه الخادم. سلسلة ASCII على شكل people/{person_id}.

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

المَعلمات
updatePersonFields

string (FieldMask format)

مطلوبة. قناع حقل لتقييد الحقول التي يتم تعديلها على المستخدم يمكن تحديد عدة حقول من خلال الفصل بينها بفواصل. سيتم استبدال جميع الحقول المعدَّلة. القيم الصالحة هي:

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

string (FieldMask format)

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

  • عنوان واحد
  • 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 إذا لم يتم ضبطها.

نص الطلب

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

نص الاستجابة

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

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

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

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

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