REST Resource: people.connections

المرجع: شخص

معلومات حول شخص تم دمجها من مصادر بيانات مختلفة، مثل جهات اتصال المستخدم الذي تمت المصادقة عليه وبيانات الملف الشخصي.

يمكن أن تتضمّن معظم الحقول عناصر متعدّدة. ولا تتضمّن العناصر المدرَجة في أحد الحقول ترتيبًا مضمونًا، ولكن يمكن ضمان أن يحتوي كل حقل غير فارغ على حقل واحد فقط مع ضبط metadata.primary على "صحيح".

تمثيل 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

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