Method: people.updateContact

• طلب HTTP
• معلمات المسار
• معامِلات طلب البحث
• نص الطلب
• نص الاستجابة
• نطاقات التفويض
• جرِّبه الآن

تحديث بيانات جهة الاتصال لجهة اتصال حالية. ولن يتم تعديل أية بيانات بخلاف جهات الاتصال. وسيتم تجاهل أي بيانات لا تتعلق بجهة الاتصال في الشخص الذي سيتم تحديثه. سيتم استبدال جميع الحقول المحددة في updateMask.

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

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

يعرض الخادم خطأ 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) مطلوبة. قناع حقل لتقييد الحقول على الشخص التي يتم تحديثها. يمكن تحديد حقول متعددة من خلال فصلها بفواصل. سيتم استبدال جميع الحقول المعدَّلة. القيم الصالحة هي: عنوان واحد سير ذاتية أعياد ميلاد عناوين URL للتقويم بيانات العميل عناوين البريد الإلكتروني فعاليات المعرّفات الخارجية أنواع عملاء IIM الاهتمامات اللغات مواقع جغرافية للقناة كلمات رئيسية متنوعة أسماء الألقاب مهن المؤسسات أرقام الهاتف علاقات sipAddresses عناوين url من تحديد المستخدم
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

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