Method: people.updateContact

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

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

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

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

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

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

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

طلب 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
  • الاهتمامات
  • اللغات
  • مواقع جغرافية
  • للقناة
  • miscKeywords
  • الأسماء
  • الألقاب
  • المهن
  • المؤسسات
  • phoneNumbers
  • العلاقات
  • sipAddresses
  • عناوين url
  • userDefined
personFields

string (FieldMask format)

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

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

enum (ReadSourceType)

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

نص الطلب

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

نص الاستجابة

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

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

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

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

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