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)

ملفات الملف للمستخدم.

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

يقدم قائمة بجهات اتصال المستخدم الذي تمت المصادقة عليه.