نسخ "جهة اتصال أخرى" إلى جهة اتصال جديدة في مجموعة "myContacts" لدى المستخدم
يجب إرسال طلبات التبديل للمستخدم نفسه بشكل تسلسلي لتجنُّب زيادة وقت الاستجابة وعمليات الإخفاق.
طلب HTTP
POST https://people.googleapis.com/v1/{resourceName=otherContacts/*}:copyOtherContactToMyContactsGroup
يستخدم عنوان URL بنية تحويل الترميز gRPC.
معلمات المسار
المَعلمات | |
---|---|
resourceName |
مطلوبة. اسم المورد لـ "جهة الاتصال الأخرى" المطلوب نسخه. |
نص الطلب
يحتوي نص الطلب على بيانات بالبنية التالية:
تمثيل JSON |
---|
{
"copyMask": string,
"readMask": string,
"sources": [
enum ( |
الحقول | |
---|---|
copyMask |
مطلوبة. قناع حقل لتقييد الحقول التي يتم نسخها إلى جهة الاتصال الجديدة. القيم الصالحة هي:
|
readMask |
اختياريّ. قناع حقل لتقييد الحقول التي يتم عرضها على المستخدم يمكن تحديد عدة حقول من خلال الفصل بينها بفواصل. ويتم الضبط تلقائيًا على قناع النسخ مع حقول البيانات الوصفية وحقول الاشتراك إذا لم يتم ضبطه. القيم الصالحة هي:
|
sources[] |
اختياريّ. قناع لأنواع المصادر المطلوب عرضها. ويتم ضبط الإعدادات التلقائية على |
نص الاستجابة
إذا كانت الاستجابة ناجحة، يحتوي نص الاستجابة على مثال Person
.
نطاقات التفويض
يتطلب استخدام أحد نطاقات OAuth التالية:
https://www.googleapis.com/auth/contacts.other.readonly
https://www.googleapis.com/auth/contacts
لمزيد من المعلومات، يُرجى الاطّلاع على دليل التفويض.