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)

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

object (Birthday)

ימי ההולדת של אותו אדם. השדה הזה הוא Singleton עבור מקורות של אנשי קשר.
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)

שמות הקבצים של האדם.
genders[]

object (Gender)

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

object (ImClient)

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

object (Interest)

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

object (Locale)

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

object (Location)

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

object (Membership)

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

object (MiscKeyword)

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

object (Name)

שמות האדם. השדה הזה הוא Singleton עבור מקורות של אנשי קשר.
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

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