Method: people.batchCreateContacts

יצירת קבוצה של אנשי קשר חדשים והחזרת ThreeResponses

בקשות שינוי עבור אותו משתמש צריכות להישלח ברצף כדי למנוע זמן אחזור ארוך יותר וכשלים.

בקשת HTTP

POST https://people.googleapis.com/v1/people:batchCreateContacts

בכתובת ה-URL נעשה שימוש בתחביר המרת קידוד של gRPC.

גוף הבקשה

גוף הבקשה מכיל נתונים במבנה הבא:

ייצוג JSON 
{
  "contacts": [
    {
      object (ContactToCreate)
    }
  ],
  "readMask": string,
  "sources": [
    enum (ReadSourceType)
  ]
}
שדות
contacts[]

object (ContactToCreate)

חובה. איש הקשר שיש ליצור. מאפשר עד 200 אנשי קשר בבקשה אחת.
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.

גוף התשובה

אם הפעולה נכשלה, הפונקציה מחזירה את הערך BatchCreateContactsErrorDetails שמכיל רשימת שגיאות עבור כל איש קשר לא חוקי.

תגובה לבקשה ליצור קבוצה של אנשי קשר.

אם הפעולה בוצעה ללא שגיאות, גוף התגובה יכיל נתונים במבנה הבא:

ייצוג JSON 
{
  "createdPeople": [
    {
      object (PersonResponse)
    }
  ]
}
שדות
createdPeople[]

object (PersonResponse)

אנשי הקשר שנוצרו, אלא אם הבקשה readMask ריקה.

היקפי ההרשאות

נדרש היקף ההרשאות הבא של OAuth:

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

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

ContactToCreate

wrapper שמכיל את נתוני האדם כדי לאכלס מקור חדש שנוצר.

ייצוג JSON 
{
  "contactPerson": {
    object (Person)
  }
}
שדות
contactPerson

object (Person)

חובה. נתוני האדם שצריך לאכלס מקור חדש שנוצר.