REST Resource: people.connections

משאב: אדם

מידע על אדם ממוזג ממקורות נתונים שונים, כמו אנשי הקשר ונתוני הפרופיל של המשתמש המאומת.

ברוב השדות יכולים להיות כמה פריטים. לפריטים בשדה אין סדר מובטח, אבל כל שדה שאינו ריק מובטח שמכיל בדיוק שדה אחד כאשר metadata.primary מוגדר ל-true.

ייצוג JSON 
{
  "resourceName": string,
  "etag": string,
  "metadata": {
    object (PersonMetadata)
  },
  "addresses": [
    {
      object (Address)
    }
  ],
  "ageRange": enum (AgeRange),
  "ageRanges": [
    {
      object (AgeRangeType)
    }
  ],
  "biographies": [
    {
      object (Biography)
    }
  ],
  "birthdays": [
    {
      object (Birthday)
    }
  ],
  "braggingRights": [
    {
      object (BraggingRights)
    }
  ],
  "calendarUrls": [
    {
      object (CalendarUrl)
    }
  ],
  "clientData": [
    {
      object (ClientData)
    }
  ],
  "coverPhotos": [
    {
      object (CoverPhoto)
    }
  ],
  "emailAddresses": [
    {
      object (EmailAddress)
    }
  ],
  "events": [
    {
      object (Event)
    }
  ],
  "externalIds": [
    {
      object (ExternalId)
    }
  ],
  "fileAses": [
    {
      object (FileAs)
    }
  ],
  "genders": [
    {
      object (Gender)
    }
  ],
  "imClients": [
    {
      object (ImClient)
    }
  ],
  "interests": [
    {
      object (Interest)
    }
  ],
  "locales": [
    {
      object (Locale)
    }
  ],
  "locations": [
    {
      object (Location)
    }
  ],
  "memberships": [
    {
      object (Membership)
    }
  ],
  "miscKeywords": [
    {
      object (MiscKeyword)
    }
  ],
  "names": [
    {
      object (Name)
    }
  ],
  "nicknames": [
    {
      object (Nickname)
    }
  ],
  "occupations": [
    {
      object (Occupation)
    }
  ],
  "organizations": [
    {
      object (Organization)
    }
  ],
  "phoneNumbers": [
    {
      object (PhoneNumber)
    }
  ],
  "photos": [
    {
      object (Photo)
    }
  ],
  "relations": [
    {
      object (Relation)
    }
  ],
  "relationshipInterests": [
    {
      object (RelationshipInterest)
    }
  ],
  "relationshipStatuses": [
    {
      object (RelationshipStatus)
    }
  ],
  "residences": [
    {
      object (Residence)
    }
  ],
  "sipAddresses": [
    {
      object (SipAddress)
    }
  ],
  "skills": [
    {
      object (Skill)
    }
  ],
  "taglines": [
    {
      object (Tagline)
    }
  ],
  "urls": [
    {
      object (Url)
    }
  ],
  "userDefined": [
    {
      object (UserDefined)
    }
  ]
}
שדות
resourceName

string

שם המשאב של המשתמש, שהוקצה על ידי השרת. מחרוזת ASCII בפורמט people/{person_id}.
etag

string

תג ישות ה-HTTP של המשאב. משמש לאימות מטמון אינטרנט.
metadata

object (PersonMetadata)

פלט בלבד. מטא-נתונים על האדם.
addresses[]

object (Address)

כתובות הרחוב של אותו אדם.
ageRange
(deprecated)

enum (AgeRange)

פלט בלבד. הוצא משימוש (במקום זאת, יש להשתמש ב-person.ageRanges)

טווח הגילאים של המשתמש.
ageRanges[]

object (AgeRangeType)

פלט בלבד. טווחי הגילאים של המשתמש.
biographies[]

object (Biography)

הביוגרפיות של האדם. בשדה הזה יש מקטע יחיד עבור מקורות של אנשי קשר.
birthdays[]

object (Birthday)

ימי ההולדת של אותו אדם. בשדה הזה יש מקטע יחיד עבור מקורות של אנשי קשר.
braggingRights[]
(deprecated)

object (BraggingRights)

הוצא משימוש: לא יוחזרו נתונים לגבי מקורות הגאווה של אותו אדם.
calendarUrls[]

object (CalendarUrl)

כתובות ה-URL של היומנים של אותו אדם.
clientData[]

object (ClientData)

נתוני הלקוחות של אותו אדם.
coverPhotos[]

object (CoverPhoto)

פלט בלבד. תמונות השער של האדם הזה.
emailAddresses[]

object (EmailAddress)

כתובות האימייל של המשתמש הרצוי. מספר כתובות האימייל ב-people.connections.list וב-otherContacts.list מוגבל ל-100. אם לאותו אדם יש יותר כתובות אימייל, אפשר לקבל את הקבוצה כולה על ידי התקשרות אל people.getBatchGet.
events[]

object (Event)

אירועים של אותו אדם
externalIds[]

object (ExternalId)

המזהים החיצוניים של המשתמש.
fileAses[]

object (FileAs)

ה-file-as של אותו אדם.
genders[]

object (Gender)

המגדרים של המשתמש. בשדה הזה יש מקטע יחיד עבור מקורות של אנשי קשר.
imClients[]

object (ImClient)

לקוחות העברת ההודעות המיידיות של אותו אדם.
interests[]

object (Interest)

תחומי העניין של המשתמש.
locales[]

object (Locale)

העדפות הלוקאל של המשתמש.
locations[]

object (Location)

המיקומים של המשתמש.
memberships[]

object (Membership)

החברים בקבוצות של אותו משתמש.
miscKeywords[]

object (MiscKeyword)

מילות המפתח השונות של המשתמש.
names[]

object (Name)

שמות האנשים. בשדה הזה יש מקטע יחיד עבור מקורות של אנשי קשר.
nicknames[]

object (Nickname)

הכינויים של האנשים.
occupations[]

object (Occupation)

המקצועות של אותו אדם.
organizations[]

object (Organization)

ארגונים בעבר או בהווה של אותו אדם.
phoneNumbers[]

object (PhoneNumber)

מספרי הטלפון של אותם אנשים. מספר מספרי הטלפון בpeople.connections.list וב-otherContacts.list מוגבל ל-100. אם למשתמש יש יותר מספרי טלפון, אפשר להתקשר למספר people.getBatchGet כדי לקבל את המספר המלא.
photos[]

object (Photo)

פלט בלבד. התמונות של אותו אדם.
relations[]

object (Relation)

הקשרים של אותו אדם
relationshipInterests[]
(deprecated)

object (RelationshipInterest)

פלט בלבד. הוצא משימוש: לא יוחזרו נתונים תחומי העניין של אותו אדם שקשורים ליחסים.
relationshipStatuses[]
(deprecated)

object (RelationshipStatus)

פלט בלבד. הוצא משימוש: לא יוחזרו נתונים לגבי סטטוס הקשרים של האדם הזה.
residences[]
(deprecated)

object (Residence)

הוצא משימוש: (במקום זאת, יש להשתמש ב-person.locations) כתובת המגורים של המשתמש.
sipAddresses[]

object (SipAddress)

כתובות ה-SIP של אותם משתמשים.
skills[]

object (Skill)

הכישורים של אותו אדם.
taglines[]
(deprecated)

object (Tagline)

פלט בלבד. הוצא משימוש: לא יוחזרו נתונים התיאורים הקצרים של האדם.
urls[]

object (Url)

כתובות ה-URL שמשויכות לאותו משתמש.
userDefined[]

object (UserDefined)

נתונים בהגדרת המשתמש של המשתמש.

שיטות

list

 מספקת רשימה של אנשי הקשר של המשתמשים המאומתים.