Method: otherContacts.copyOtherContactToMyContactsGroup

نسخ "جهة اتصال أخرى" إلى جهة اتصال جديدة في مجموعة "myContacts" لدى المستخدم

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

طلب HTTP

POST https://people.googleapis.com/v1/{resourceName=otherContacts/*}:copyOtherContactToMyContactsGroup

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

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

المَعلمات
resourceName

string

مطلوبة. اسم المورد لـ "جهة الاتصال الأخرى" المطلوب نسخه.

نص الطلب

يحتوي نص الطلب على بيانات بالبنية التالية:

تمثيل JSON 
{
  "copyMask": string,
  "readMask": string,
  "sources": [
    enum (ReadSourceType)
  ]
}
الحقول
copyMask

string (FieldMask format)

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

  • emailAddresses
  • names
  • phoneNumbers
readMask

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.

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

يتطلب استخدام أحد نطاقات OAuth التالية:

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

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