Method: otherContacts.copyOtherContactToMyContactsGroup

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

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

طلب 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
  • الأسماء
  • phoneNumbers
readMask

string (FieldMask format)

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

  • عناوين
  • ageRanges
  • السير الذاتية
  • أعياد الميلاد
  • calendarUrls
  • clientData
  • coverPhotos
  • emailAddresses
  • الفعاليات
  • externalIds
  • أنواع
  • imClients
  • الاهتمامات
  • اللغات
  • مواقع جغرافية
  • للقناة
  • البيانات الوصفية
  • miscKeywords
  • الأسماء
  • الألقاب
  • المهن
  • المؤسسات
  • phoneNumbers
  • صور
  • علاقات
  • sipAddresses
  • مهارات
  • عناوين url
  • 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

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