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
  • תחומי עניין
  • לוקאלים
  • locations
  • מועדוני חברים
  • מטא נתונים
  • miscKeywords
  • שמות
  • כינויים
  • מקצועות
  • ארגונים
  • phoneNumbers
  • תמונות, תצלומים, צילומים, פוטוס
  • קשרים
  • sipAddresses
  • מיומנויות
  • כתובות אתרים
  • 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

מידע נוסף זמין במדריך להרשאות.