تعديل بيانات جهة الاتصال لجهة اتصال حالية ولن يتم تعديل أي بيانات غير تابعة لجهات الاتصال. سيتم تجاهل أي بيانات غير تابعة لجهات الاتصال في الشخص المطلوب تعديله. سيتم استبدال جميع الحقول المحدّدة في 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 |
اسم المورد للمستخدم، الذي يعينه الخادم. سلسلة ASCII على شكل |
معلمات طلب البحث
| المَعلمات | |
|---|---|
updatePersonFields |
مطلوبة. قناع حقل لتقييد الحقول التي يتم تعديلها على المستخدم يمكن تحديد عدة حقول من خلال الفصل بينها بفواصل. سيتم استبدال جميع الحقول المعدَّلة. القيم الصالحة هي:
|
personFields |
اختياريّ. قناع حقل لتقييد الحقول التي يتم عرضها لكل مستخدم يمكن تحديد عدة حقول من خلال الفصل بينها بفواصل. يتم ضبط القيمة تلقائيًا على جميع الحقول في حال عدم ضبطها. القيم الصالحة هي:
|
sources[] |
اختياريّ. قناع لأنواع المصادر المطلوب عرضها. ويتم ضبط الإعدادات التلقائية على |
نص الطلب
يحتوي نص الطلب على مثال Person.
نص الاستجابة
إذا كانت الاستجابة ناجحة، يحتوي نص الاستجابة على مثال Person.
نطاقات التفويض
يجب توفير نطاق OAuth التالي:
https://www.googleapis.com/auth/contacts
لمزيد من المعلومات، يُرجى الاطّلاع على دليل التفويض.