- المورد: الشخص
- تمثيل JSON
- البيانات الوصفية للشخص
- المصدر
- نوع المصدر
- البيانات الوصفية للملف الشخصي
- نوع العنصر
- نوع المستخدم
- العنوان
- البيانات الوصفية للحقل
- النطاق الزمني
- AgeRangeType
- السيرة الذاتية
- نوع المحتوى
- تاريخ الميلاد
- التاريخ
- الأشياء التي تتباهى بها
- CalendarUrl
- بيانات العميل
- صورة الغلاف
- عناوين البريد الإلكتروني
- فعالية
- معرّف خارجي
- ملف باسم
- الجنس
- برنامج ImClient
- الاهتمام
- اللغة
- الموقع الجغرافي
- الاشتراك
- ContactGroupMember
- عضوية النطاق
- MiscKeyword
- KeywordType
- الاسم
- اللقب
- اللقب
- المهنة
- المؤسسة
- رقم الهاتف
- صورة
- العلاقة
- اهتمامات العلاقة
- الحالة
- الإقامة
- SipAddress
- المهارات
- سطر الوصف
- عنوان URL
- من تحديد المستخدم
- الطُرق
المورد: الشخص
معلومات عن شخص تم دمجه من مصادر بيانات متنوعة، مثل جهات اتصال المستخدم الذي تمت مصادقته وبيانات الملف الشخصي
يمكن أن تحتوي معظم الحقول على عناصر متعددة. لا تضمن العناصر الموجودة في أحد الحقول ترتيبًا مضمونًا، ولكن يضمن كل حقل غير فارغ أن يحتوي على حقل واحد فقط مع ضبط metadata.primary
على true.
تمثيل JSON |
---|
{ "resourceName": string, "etag": string, "metadata": { object ( |
الحقول | |
---|---|
resourceName |
اسم المورد للشخص الذي يعيّنه الخادم. سلسلة ASCII على شكل |
etag |
علامة كيان HTTP للمورد. يتم استخدامه للتحقق من ذاكرة التخزين المؤقت على الويب. |
metadata |
الإخراج فقط. البيانات الوصفية للشخص |
addresses[] |
عناوين الشوارع للشخص. |
ageRange |
الإخراج فقط. تم الإيقاف (يُرجى استخدام الفئة العمرية للشخص. |
ageRanges[] |
الإخراج فقط. الفئات العمرية للشخص. |
biographies[] |
السير الذاتية للشخص. هذا الحقل مخصص لمصادر جهات الاتصال. |
birthdays[] |
أعياد ميلاد الشخص. هذا الحقل مخصص لمصادر جهات الاتصال. |
braggingRights[] |
متوقّف: لن يتم عرض أي بيانات تتعلّق بمميزات التباهي بذلك الشخص. |
calendarUrls[] |
عناوين URL لتقويم الشخص. |
clientData[] |
بيانات عميل الشخص. |
coverPhotos[] |
الإخراج فقط. صور غلاف الشخص. |
emailAddresses[] |
عناوين البريد الإلكتروني للشخص. بالنسبة إلى |
events[] |
أحداث الشخص. |
externalIds[] |
المعرّفات الخارجية للشخص. |
fileAses[] |
ملفات الملف للمستخدم. |
genders[] |
جنس الشخص. هذا الحقل مخصص لمصادر جهات الاتصال. |
imClients[] |
برامج المراسلة الفورية للشخص. |
interests[] |
اهتمامات الشخص. |
locales[] |
تفضيلات اللغة للشخص. |
locations[] |
مواقع الشخص. |
memberships[] |
عضويات المجموعة للشخص. |
miscKeywords[] |
الكلمات الرئيسية المتنوعة للشخص. |
names[] |
أسماء الشخص. هذا الحقل مخصص لمصادر جهات الاتصال. |
nicknames[] |
ألقاب الشخص. |
occupations[] |
مهن الشخص. |
organizations[] |
المؤسسات السابقة أو الحالية للشخص. |
phoneNumbers[] |
أرقام هواتف الشخص. بالنسبة إلى |
photos[] |
الإخراج فقط. صور الشخص. |
relations[] |
علاقات الشخص. |
relationshipInterests[] |
الإخراج فقط. متوقف: لن يتم عرض أي بيانات لاهتمامات الشخص المتعلقة بالعلاقة. |
relationshipStatuses[] |
الإخراج فقط. متوقّف: لن يتم عرض أي بيانات لحالات علاقات الشخص. |
residences[] |
متوقف: (الرجاء استخدام |
sipAddresses[] |
عناوين SIP للمستخدم. |
skills[] |
مهارات الشخص. |
taglines[] |
الإخراج فقط. مُعطل: لن يتم عرض أي بيانات شعارات ترويجية للشخص. |
urls[] |
عناوين URL المرتبطة بهذا الشخص |
userDefined[] |
البيانات التي يحددها المستخدم. |
البيانات الوصفية للأشخاص
البيانات الوصفية عن شخص
تمثيل JSON |
---|
{ "sources": [ { object ( |
الحقول | |
---|---|
sources[] |
مصادر البيانات لهذا الشخص. |
previousResourceNames[] |
الإخراج فقط. أي أسماء موارد سابقة يملكها هذا الشخص. وتتم التعبئة فقط لطلبات قد يتغير اسم المورد عند إضافة أو إزالة الحقول التي تربط بين جهة اتصال والملف الشخصي مثل بريد إلكتروني تم التحقق منه أو رقم هاتف تم التحقق منه أو عنوان URL للملف الشخصي. |
linkedPeopleResourceNames[] |
الإخراج فقط. أسماء الموارد للأشخاص المرتبطين بهذا المورد. |
deleted |
الإخراج فقط. صحيح إذا تم حذف مورد الشخص. وتتم التعبئة فقط لعدد |
objectType |
الإخراج فقط. تم الإيقاف (يُرجى استخدام نوع كائن الشخص. |
المصدر
مصدر الحقل.
تمثيل JSON |
---|
{ "type": enum ( |
الحقول | |
---|---|
type |
نوع المصدر. |
id |
المعرّف الفريد ضمن نوع المصدر الذي أنشأه الخادم. |
etag |
يتم التعبئة في علامة كيان HTTP للمصدر. يتم استخدامه للتحقق من ذاكرة التخزين المؤقت على الويب. |
updateTime |
الإخراج فقط. يتم التعبئة في الطابع الزمني للتحديث الأخير لهذا المصدر. طابع زمني بتنسيق RFC3339 UTC "Zulu"، مع دقة نانوثانية وما يصل إلى تسعة أرقام كسرية. أمثلة: |
profileMetadata |
الإخراج فقط. يتم التعبئة في البيانات الوصفية حول مصدر من النوع PROFILE. |
نوع المصدر
نوع المصدر.
عمليات التعداد | |
---|---|
SOURCE_TYPE_UNSPECIFIED |
غير محدد |
ACCOUNT |
حساب Google. |
PROFILE |
الملف الشخصي في Google. يمكنك عرض الملف الشخصي على https://profiles.google.com/{id}، حيث يمثل {id} الرقم التعريفي للمصدر. |
DOMAIN_PROFILE |
الملف الشخصي في نطاق Google Workspace. |
CONTACT |
جهة اتصال Google. يمكنك عرض جهة الاتصال على https://contact.google.com/{id}، حيث يمثل {id} رقم تعريف المصدر. |
OTHER_CONTACT |
جهة اتصال Google الأخرى: |
DOMAIN_CONTACT |
جهة الاتصال المشتركة لنطاق Google Workspace |
البيانات الوصفية للملف الشخصي
البيانات الوصفية المتعلّقة بملف شخصي
تمثيل JSON |
---|
{ "objectType": enum ( |
الحقول | |
---|---|
objectType |
الإخراج فقط. نوع كائن الملف الشخصي. |
userTypes[] |
الإخراج فقط. أنواع المستخدمين. |
نوع الكائن
تمثّل هذه السمة نوع الكائن.
عمليات التعداد | |
---|---|
OBJECT_TYPE_UNSPECIFIED |
غير محدد |
PERSON |
شخص. |
PAGE |
صفحة Currents |
نوع المستخدم
نوع المستخدم.
عمليات التعداد | |
---|---|
USER_TYPE_UNKNOWN |
نوع المستخدم غير معروف. |
GOOGLE_USER |
المستخدم هو أحد مستخدمي Google. |
GPLUS_USER |
المستخدم هو أحد مستخدمي Currents. |
GOOGLE_APPS_USER |
المستخدم هو أحد مستخدمي Google Workspace. |
العنوان
العنوان المادي للشخص. قد يكون صندوق بريد أو عنوان شارع. جميع الحقول اختيارية.
تمثيل JSON |
---|
{
"metadata": {
object ( |
الحقول | |
---|---|
metadata |
البيانات الوصفية عن العنوان |
formattedValue |
القيمة غير المنظّمة للعنوان. إذا لم يعيِّن المستخدم ذلك، فسيتم إنشاؤه تلقائيًا من القيم المنظمة. |
type |
نوع العنوان. يمكن أن يكون النوع مخصّصًا أو إحدى القيم التالية المحدّدة مسبقًا:
|
formattedType |
الإخراج فقط. نوع العنوان الذي تمّت ترجمته وتنسيقه في لغة حساب المشاهد أو في لغة عنوان HTTP التي تتضمّن |
poBox |
صندوق البريد في العنوان. |
streetAddress |
تمثّل هذه السمة عنوان الشارع. |
extendedAddress |
العنوان الموسّع للعنوان، على سبيل المثال، رقم الشقة. |
city |
مدينة العنوان. |
region |
منطقة العنوان؛ على سبيل المثال، الولاية أو المقاطعة. |
postalCode |
الرمز البريدي للعنوان. |
country |
بلد العنوان. |
countryCode |
تمثّل هذه الخاصية رمز البلد للرمز ISO 3166-1 alpha-2 للعنوان. |
حقل البيانات الوصفية
البيانات الوصفية حول الحقل
تمثيل JSON |
---|
{
"primary": boolean,
"sourcePrimary": boolean,
"verified": boolean,
"source": {
object ( |
الحقول | |
---|---|
primary |
الإخراج فقط. صحيح إذا كان الحقل هو الحقل الأساسي لجميع المصادر في الشخص. سيكون لكل شخص حقل واحد على الأكثر، مع ضبط |
sourcePrimary |
True إذا كان الحقل هو الحقل الأساسي لـ |
verified |
الإخراج فقط. True إذا تم التحقق من الحقل، وfalse إذا لم يتم إثبات ملكية الحقل. عادةً ما يكون الحقل الذي تم التحقق منه اسمًا أو عنوان بريد إلكتروني أو رقم هاتف أو موقع ويب تم التأكد من أنه مملوك للشخص. |
source |
مصدر الحقل. |
معدل العمر
تم الإيقاف (يُرجى استخدام person.ageRanges
بدلاً من ذلك)
الفئة العمرية للشخص.
عمليات التعداد | |
---|---|
AGE_RANGE_UNSPECIFIED |
غير محدد |
LESS_THAN_EIGHTEEN |
أقل من ثمانية عشر عامًا. |
EIGHTEEN_TO_TWENTY |
بَيْنَ ثَمَانِيَةَ عَشَرَ دَرَجَةْ وَعِشْرِينْ |
TWENTY_ONE_OR_OLDER |
واحد وعشرون عامًا وما فوق. |
الفئة العمرية
الفئة العمرية للشخص.
تمثيل JSON |
---|
{ "metadata": { object ( |
الحقول | |
---|---|
metadata |
البيانات الوصفية عن الفئة العمرية |
ageRange |
الفئة العمرية. |
سيرة ذاتية
سيرة ذاتية قصيرة للشخص.
تمثيل JSON |
---|
{ "metadata": { object ( |
الحقول | |
---|---|
metadata |
البيانات الوصفية عن السيرة الذاتية |
value |
السيرة الذاتية القصيرة. |
contentType |
نوع محتوى السيرة الذاتية. |
نوع المحتوى
نوع المحتوى.
عمليات التعداد | |
---|---|
CONTENT_TYPE_UNSPECIFIED |
غير محدد |
TEXT_PLAIN |
نص عادي. |
TEXT_HTML |
نص HTML. |
تاريخ الميلاد
عيد ميلاد شخص ما. تم تحديد حقل واحد على الأقل من الحقلين date
وtext
. يمثّل الحقلان date
وtext
التاريخ نفسه عادةً، ولكنّهما غير مضمونَين. على العملاء دائمًا ضبط الحقل date
عند تغيير أعياد الميلاد.
تمثيل JSON |
---|
{ "metadata": { object ( |
الحقول | |
---|---|
metadata |
البيانات الوصفية عن تاريخ الميلاد |
date |
التاريخ المنظّم لعيد الميلاد. |
text |
ويُفضَّل استخدام الحقل سلسلة حرة تمثّل تاريخ ميلاد المستخدم. لم يتم التحقق من صحة هذه القيمة. |
التاريخ
يمثل تاريخًا كاملاً أو جزئيًا للتقويم، مثل تاريخ الميلاد. ويتم تحديد الوقت من اليوم والمنطقة الزمنية في مكان آخر أو تكون غير مهمة. ويرتبط التاريخ بالتقويم الميلادي. يمكن أن يمثل ذلك واحدًا مما يلي:
- تاريخ كامل، مع قيم غير صفرية للسنة والشهر واليوم.
- شهر ويوم، بدون عام (على سبيل المثال، ذكرى سنوية).
- عام من تلقاء نفسه، ولا يتضمن أي شهر.
- عام وشهر بدون أي يوم (على سبيل المثال، تاريخ انتهاء صلاحية بطاقة الائتمان).
الأنواع ذات الصلة:
google.type.TimeOfDay
google.type.DateTime
google.protobuf.Timestamp
تمثيل JSON |
---|
{ "year": integer, "month": integer, "day": integer } |
الحقول | |
---|---|
year |
سنة التاريخ يجب أن تتراوح القيمة بين 1 و9999 أو 0 لتحديد تاريخ بدون عام. |
month |
شهر من السنة. يجب أن تتراوح القيمة بين 1 و12 أو 0 لتحديد سنة بدون شهر ويوم. |
day |
يوم من الشهر. يجب أن تتراوح القيمة من 1 إلى 31 وتكون صالحة للسنة والشهر، أو 0 لتحديد سنة بمفردها أو السنة والشهر حيث لا يكون اليوم كبيرًا. |
مغرور
متوقّف: لن يتم إرجاع أي بيانات تتباهى بها جهة معيّنة.
تمثيل JSON |
---|
{
"metadata": {
object ( |
الحقول | |
---|---|
metadata |
بيانات وصفية حول حقوق التباهي بها |
value |
حقوق التباهي، مثل |
عنوان URL للتقويم
عنوان URL لتقويم شخص.
تمثيل JSON |
---|
{
"metadata": {
object ( |
الحقول | |
---|---|
metadata |
البيانات الوصفية حول عنوان URL للتقويم |
url |
عنوان URL للتقويم. |
type |
نوع عنوان URL للتقويم. يمكن أن يكون النوع مخصّصًا أو إحدى القيم التالية المحدّدة مسبقًا:
|
formattedType |
الإخراج فقط. ترجمة عنوان URL للتقويم وتنسيقه في لغة حساب المشاهد أو في لغة عنوان HTTP التي تتضمّن |
بيانات العميل
بيانات العملاء العشوائية التي تتم تعبئتها بواسطة العملاء يسمح بالمفاتيح والقيم المكررة.
تمثيل JSON |
---|
{
"metadata": {
object ( |
الحقول | |
---|---|
metadata |
البيانات الوصفية عن بيانات العميل |
key |
مفتاح العميل المحدّد لبيانات العميل. |
value |
القيمة المحدّدة لبيانات العميل |
صورة الغلاف
صورة غلاف شخص صورة كبيرة تُعرض على صفحة الملف الشخصي للشخص وتمثل هويته أو ما يهتم به.
تمثيل JSON |
---|
{
"metadata": {
object ( |
الحقول | |
---|---|
metadata |
البيانات الوصفية حول صورة الغلاف. |
url |
عنوان URL لصورة الغلاف. |
default |
صحيح إذا كانت صورة الغلاف هي صورة الغلاف الافتراضية، وfalse إذا كانت صورة الغلاف هي صورة غلاف يوفرها المستخدم. |
عنوان البريد الإلكتروني
عنوان البريد الإلكتروني لشخص.
تمثيل JSON |
---|
{
"metadata": {
object ( |
الحقول | |
---|---|
metadata |
البيانات الوصفية لعنوان البريد الإلكتروني |
value |
عنوان البريد الإلكتروني. |
type |
نوع عنوان البريد الإلكتروني. يمكن أن يكون النوع مخصّصًا أو إحدى القيم التالية المحدّدة مسبقًا:
|
formattedType |
الإخراج فقط. تمت ترجمة نوع عنوان البريد الإلكتروني وتنسيقه في لغة حساب المشاهد أو في لغة عنوان HTTP التي تتضمّن |
displayName |
الاسم المعروض للبريد الإلكتروني. |
الحدث
حدث يتعلق بالشخص.
تمثيل JSON |
---|
{ "metadata": { object ( |
الحقول | |
---|---|
metadata |
البيانات الوصفية للحدث |
date |
تاريخ الحدث. |
type |
نوع الحدث. يمكن أن يكون النوع مخصّصًا أو إحدى القيم التالية المحدّدة مسبقًا:
|
formattedType |
الإخراج فقط. تمت ترجمة نوع الحدث وتنسيقه في لغة حساب المشاهد أو في لغة عنوان HTTP التي تتضمّن |
الرقم التعريفي الخارجي
معرّف من كيان خارجي مرتبط بالشخص.
تمثيل JSON |
---|
{
"metadata": {
object ( |
الحقول | |
---|---|
metadata |
البيانات الوصفية عن المعرّف الخارجي |
value |
قيمة المعرّف الخارجي. |
type |
نوع المعرّف الخارجي. يمكن أن يكون النوع مخصّصًا أو إحدى القيم التالية المحدّدة مسبقًا:
|
formattedType |
الإخراج فقط. تمت ترجمة نوع الحدث وتنسيقه في لغة حساب المشاهد أو في لغة عنوان HTTP التي تتضمّن |
ملف باسم
الاسم الذي يجب استخدامه لترتيب الشخص في قائمة.
تمثيل JSON |
---|
{
"metadata": {
object ( |
الحقول | |
---|---|
metadata |
البيانات الوصفية لملف بتنسيق. |
value |
القيمة كملف |
الجنس
جنس الشخص.
تمثيل JSON |
---|
{
"metadata": {
object ( |
الحقول | |
---|---|
metadata |
البيانات الوصفية حول الجنس |
value |
جنس الشخص. يمكن أن يكون الجنس مخصصًا أو إحدى القيم التالية المحددة مسبقًا:
|
formattedValue |
الإخراج فقط. قيمة الجنس الذي تمت ترجمته وتنسيقه في لغة حساب المشاهد أو في لغة عنوان HTTP التي تخص |
addressMeAs |
حقل نصي حر للضمائر يجب استخدامه لمخاطبة الشخص. القيم الشائعة هي:
|
إمام
برنامج المراسلة الفورية لأحد الأشخاص.
تمثيل JSON |
---|
{
"metadata": {
object ( |
الحقول | |
---|---|
metadata |
البيانات الوصفية حول عميل المراسلة الفورية. |
username |
اسم المستخدم المستخدم في برنامج الرسائل الفورية. |
type |
نوع برنامج المراسلة الفورية. يمكن أن يكون النوع مخصّصًا أو إحدى القيم التالية المحدّدة مسبقًا:
|
formattedType |
الإخراج فقط. تمت ترجمة نوع برنامج المراسلة الفورية (IM) وتنسيقه في لغة حساب المشاهد أو في لغة عنوان HTTP التي تتضمّن |
protocol |
بروتوكول عميل المراسلة الفورية. يمكن أن يكون البروتوكول مخصصًا أو إحدى القيم التالية المحددة مسبقًا:
|
formattedProtocol |
الإخراج فقط. بروتوكول برنامج المراسلة الفورية بتنسيق في لغة حساب المشاهد أو لغة عنوان HTTP |
الضريبة
أحد اهتمامات الشخص.
تمثيل JSON |
---|
{
"metadata": {
object ( |
الحقول | |
---|---|
metadata |
البيانات الوصفية حول الاهتمام. |
value |
الاهتمام، على سبيل المثال، |
اللغة
تفضيل لغة الشخص.
تمثيل JSON |
---|
{
"metadata": {
object ( |
الحقول | |
---|---|
metadata |
البيانات الوصفية عن اللغة. |
value |
علامة لغة IETF BCP 47 جيدة الصياغة والتي تمثّل اللغة المحلية. |
الموقع الجغرافي
موقع الشخص.
تمثيل JSON |
---|
{
"metadata": {
object ( |
الحقول | |
---|---|
metadata |
البيانات الوصفية عن الموقع. |
value |
القيمة الحرة للموقع. |
type |
نوع الموقع الجغرافي. يمكن أن يكون النوع مخصّصًا أو إحدى القيم التالية المحدّدة مسبقًا:
|
current |
ما إذا كان الموقع هو الموقع الحالي أم لا. |
buildingId |
معرّف المبنى. |
floor |
اسم الطابق أو رقمه. |
floorSection |
قسم الطابق في |
deskCode |
موقع المكتب الفردي. |
الاشتراك
عضوية شخص في مجموعة. لا يمكن تعديل سوى عضويات مجموعة جهات الاتصال.
تمثيل JSON |
---|
{ "metadata": { object ( |
الحقول | |
---|---|
metadata |
البيانات الوصفية حول الاشتراك |
حقل الاتحاد membership . العضوية. يمكن أن يكون membership واحدًا مما يلي فقط: |
|
contactGroupMembership |
عضوية مجموعة جهات الاتصال. |
domainMembership |
الإخراج فقط. عضوية النطاق. |
عضوية ContactGroup
عضوية مجموعة جهات اتصال Google.
تمثيل JSON |
---|
{ "contactGroupId": string, "contactGroupResourceName": string } |
الحقول | |
---|---|
contactGroupId |
الإخراج فقط. رقم تعريف مجموعة جهات الاتصال لعضوية مجموعة جهات الاتصال. |
contactGroupResourceName |
اسم المورد لمجموعة جهات الاتصال، التي تم تعيينها من خلال الخادم. سلسلة ASCII على شكل |
عضوية النطاق
اشتراك في نطاق Google Workspace
تمثيل JSON |
---|
{ "inViewerDomain": boolean } |
الحقول | |
---|---|
inViewerDomain |
صحيح إذا كان الشخص في نطاق Google Workspace للمشاهد. |
كلمة رئيسية متنوعة
الكلمة الرئيسية المتنوعة لأحد الأشخاص.
تمثيل JSON |
---|
{ "metadata": { object ( |
الحقول | |
---|---|
metadata |
بيانات وصفية عن الكلمة الرئيسية المتنوعة. |
value |
قيمة الكلمة الرئيسية المتنوعة. |
type |
نوع الكلمة الرئيسية المتنوع. |
formattedType |
الإخراج فقط. تمت ترجمة نوع الكلمة الرئيسية المتنوعة وتنسيقها في لغة حساب المشاهد أو في لغة عنوان HTTP التي تخص |
نوع الكلمة الرئيسية
نوع الكلمة الرئيسية المتنوعة.
عمليات التعداد | |
---|---|
TYPE_UNSPECIFIED |
غير محدد |
OUTLOOK_BILLING_INFORMATION |
حقل Outlook لمعلومات الفوترة. |
OUTLOOK_DIRECTORY_SERVER |
حقل Outlook لخادم الدليل. |
OUTLOOK_KEYWORD |
Outlook في حقل الكلمة الرئيسية. |
OUTLOOK_MILEAGE |
حقل Outlook للمسافة بالميل. |
OUTLOOK_PRIORITY |
حقل Outlook للأولوية. |
OUTLOOK_SENSITIVITY |
حقل Outlook للحساسية. |
OUTLOOK_SUBJECT |
حقل Outlook للموضوع. |
OUTLOOK_USER |
حقل Outlook للمستخدم. |
HOME |
المنزل. |
WORK |
العمل. |
OTHER |
غير ذلك |
الاسم
اسم شخص. إذا كان الاسم مختصرًا، يكون اسم العائلة فارغًا.
تمثيل JSON |
---|
{
"metadata": {
object ( |
الحقول | |
---|---|
metadata |
البيانات الوصفية للاسم |
displayName |
الإخراج فقط. اسم العرض المنسّق وفقًا للغة التي يحدّدها حساب المشاهد أو عنوان HTTP الذي يتضمّن |
displayNameLastFirst |
الإخراج فقط. الاسم الأول الذي تم تنسيقه باستخدام الاسم الأخير وفقًا للغة المحدّدة من قِبل حساب المشاهد أو عنوان HTTP |
unstructuredName |
قيمة اسم النموذج الحر. |
familyName |
اسم العائلة. |
givenName |
الاسم المحدد. |
middleName |
الاسم(الأسماء) الأوسط. |
honorificPrefix |
البادئات التكريمية، مثل |
honorificSuffix |
اللاحقات الشرفية، مثل |
phoneticFullName |
الاسم بالكامل هجائي كما يبدو. |
phoneticFamilyName |
اسم العائلة مكتوب كما يبدو. |
phoneticGivenName |
الاسم المُعطى هجائي كما يبدو. |
phoneticMiddleName |
الاسم الأوسط(الأسماء الوسطى) مكتوب كما يبدو. |
phoneticHonorificPrefix |
تمت كتابة البادئات الشرفية بالشكل الذي تبدو عليه. |
phoneticHonorificSuffix |
وتُكتب اللاحقات الشرفية بالشكل الصحيح. |
اللقب
لقب أحد الأشخاص.
تمثيل JSON |
---|
{ "metadata": { object ( |
الحقول | |
---|---|
metadata |
البيانات الوصفية حول اللقب |
value |
اللقب. |
type |
نوع اللقب |
اللقب
نوع اللقب
عمليات التعداد | |
---|---|
DEFAULT |
لقب عام. |
MAIDEN_NAME |
اسم الأم أو اسم العائلة. تُستخدم عند تغيير اسم عائلة الشخص نتيجةً للزواج. |
INITIALS |
الأحرف الأولى من الاسم |
GPLUS |
لقب الملف الشخصي في +Google. |
OTHER_NAME |
ارتباط مهني أو اسم آخر، مثل |
ALTERNATE_NAME |
الاسم البديل للشخص معروف. |
SHORT_NAME |
نسخة أقصر من اسم الشخص. |
المهنة
مهنة الشخص.
تمثيل JSON |
---|
{
"metadata": {
object ( |
الحقول | |
---|---|
metadata |
البيانات الوصفية للمهنة. |
value |
الوظيفة، على سبيل المثال، |
مؤسسة
المؤسسة السابقة أو الحالية للشخص. السماح بالنطاقات الزمنية المتداخلة.
تمثيل JSON |
---|
{ "metadata": { object ( |
الحقول | |
---|---|
metadata |
البيانات الوصفية عن المؤسسة |
type |
نوع المؤسسة. يمكن أن يكون النوع مخصّصًا أو إحدى القيم التالية المحدّدة مسبقًا:
|
formattedType |
الإخراج فقط. نوع المؤسسة الذي تمت ترجمته وتنسيقه في لغة حساب المشاهد أو في لغة عنوان HTTP التي تتضمّن |
startDate |
تاريخ البدء الذي انضم فيه الشخص إلى المؤسسة. |
endDate |
تاريخ الانتهاء عندما غادر الشخص المؤسسة. |
current |
صحيح إذا كانت المؤسسة هي المؤسسة الحالية للشخص أم خطأ إذا كانت المؤسسة في الماضي مؤسسة. |
name |
اسم المؤسسة |
phoneticName |
الاسم اللفظي للمؤسسة. |
department |
قسم الشخص في المؤسسة. |
title |
تمثّل هذه الخاصية المسمّى الوظيفي للشخص في المؤسسة. |
jobDescription |
تمثّل هذه الخاصية الوصف الوظيفي للشخص في المؤسسة. |
symbol |
الرمز المرتبط بالمؤسسة، مثل رمز مؤشر الأسهم أو الاختصار أو الاختصار. |
domain |
اسم النطاق المرتبط بالمؤسسة، على سبيل المثال، |
location |
موقع مكتب المؤسسة الذي يعمل فيه الشخص. |
costCenter |
مركز تكلفة الشخص في المؤسسة. |
fullTimeEquivalentMillipercent |
القيمة المئوية بالملي ثانية التي يعمل بها الشخص بدوام كامل في المؤسسة (100000 = 100%). |
PhoneNumber
رقم هاتف شخص
تمثيل JSON |
---|
{
"metadata": {
object ( |
الحقول | |
---|---|
metadata |
البيانات الوصفية حول رقم الهاتف. |
value |
رقم الهاتف. |
canonicalForm |
الإخراج فقط. نموذج ITU-T E.164 الأساسي لرقم الهاتف |
type |
نوع رقم الهاتف. يمكن أن يكون النوع مخصّصًا أو إحدى القيم التالية المحدّدة مسبقًا:
|
formattedType |
الإخراج فقط. نوع رقم الهاتف الذي تمت ترجمته وتنسيقه في لغة حساب المشاهد أو في لغة عنوان HTTP التي تتضمّن |
الصورة
صورة شخص صورة معروضة بجانب اسم المستخدم لمساعدة الآخرين في التعرّف عليه.
تمثيل JSON |
---|
{
"metadata": {
object ( |
الحقول | |
---|---|
metadata |
البيانات الوصفية حول الصورة. |
url |
عنوان URL للصورة. يمكنك تغيير الحجم المطلوب من خلال إلحاق معلمة طلب البحث |
default |
True إذا كانت الصورة هي الصورة الافتراضية، وfalse إذا كانت الصورة قدمها المستخدم. |
العلاقة
علاقة الشخص بشخص آخر.
تمثيل JSON |
---|
{
"metadata": {
object ( |
الحقول | |
---|---|
metadata |
البيانات الوصفية حول العلاقة |
person |
اسم الشخص الآخر الذي تشير إليه هذه العلاقة. |
type |
علاقة الشخص بالشخص الآخر. يمكن أن يكون النوع مخصّصًا أو إحدى القيم التالية المحدّدة مسبقًا:
|
formattedType |
الإخراج فقط. نوع العلاقة المترجَمة والمنسقة في لغة حساب المشاهد أو اللغة المحدّدة في رأس HTTP التي تقبل اللغة. |
الاهتمام بالعلاقات
مُعطل: لن يتم عرض أي بيانات لمصلحة علاقة الشخص .
تمثيل JSON |
---|
{
"metadata": {
object ( |
الحقول | |
---|---|
metadata |
البيانات الوصفية حول الاهتمام بالعلاقة |
value |
نوع العلاقة التي يبحث عنها الشخص. يمكن أن تكون القيمة مخصصة أو إحدى القيم التالية المحددة مسبقًا:
|
formattedValue |
الإخراج فقط. قيمة علاقة الاهتمام مترجمة وتنسيقها في لغة حساب المشاهد أو اللغة المحددة في رأس قبول اللغة HTTP. |
حالة العلاقة
تم الإيقاف: لن يتم عرض أي بيانات عن حالة علاقة الشخص.
تمثيل JSON |
---|
{
"metadata": {
object ( |
الحقول | |
---|---|
metadata |
البيانات الوصفية حول حالة العلاقة |
value |
حالة العلاقة. يمكن أن تكون القيمة مخصصة أو إحدى القيم التالية المحددة مسبقًا:
|
formattedValue |
الإخراج فقط. تمت ترجمة قيمة حالة العلاقة وتنسيقها في لغة حساب المشاهد أو في لغة عنوان HTTP التي تخص |
الإقامة
متوقف: الرجاء استخدام person.locations
بدلاً من ذلك. مكان إقامة المستخدم السابق أو الحالي
تمثيل JSON |
---|
{
"metadata": {
object ( |
الحقول | |
---|---|
metadata |
بيانات وصفية حول مكان الإقامة |
value |
عنوان مكان الإقامة. |
current |
صحيح إذا كان مكان الإقامة هو مقر إقامة الشخص الحالي أم خطأ إذا كان محل الإقامة سابقًا. |
عنوان SIP
عنوان SIP للشخص. يتم استخدام عناوين البروتوكول الأولي للجلسة لاتصالات VoIP لإجراء مكالمات صوتية أو مكالمات فيديو عبر الإنترنت.
تمثيل JSON |
---|
{
"metadata": {
object ( |
الحقول | |
---|---|
metadata |
البيانات الوصفية لعنوان SIP. |
value |
عنوان SIP بتنسيق معرِّف الموارد المنتظم (URI) لبروتوكول SIP RFC 3261 19.1. |
type |
نوع عنوان SIP. يمكن أن يكون النوع مخصّصًا أو إحدى القيم التالية المحدّدة مسبقًا:
|
formattedType |
الإخراج فقط. تمت ترجمة تنسيق عنوان SIP وتنسيقه في لغة حساب المشاهد أو في لغة عنوان HTTP التي تتضمّن |
المهارة
مهارة يمتلكها الشخص.
تمثيل JSON |
---|
{
"metadata": {
object ( |
الحقول | |
---|---|
metadata |
بيانات وصفية حول المهارة |
value |
المهارة، على سبيل المثال، |
الجملة الترويجية
متوقف: لن يتم عرض أي بيانات وصف مختصر من سطر واحد للشخص.
تمثيل JSON |
---|
{
"metadata": {
object ( |
الحقول | |
---|---|
metadata |
البيانات الوصفية حول الجملة الترويجية. |
value |
الجملة الترويجية. |
عنوان URL
عناوين URL المرتبطة بأحد المستخدمين.
تمثيل JSON |
---|
{
"metadata": {
object ( |
الحقول | |
---|---|
metadata |
البيانات الوصفية عن عنوان URL. |
value |
عنوان URL. |
type |
نوع عنوان URL. يمكن أن يكون النوع مخصّصًا أو إحدى القيم التالية المحدّدة مسبقًا:
|
formattedType |
الإخراج فقط. تمت ترجمة نوع عنوان URL وتنسيقه في لغة حساب المشاهد أو في لغة عنوان HTTP التي تتضمّن |
من تحديد المستخدم
بيانات المستخدمين العشوائية التي تتم تعبئتها بواسطة المستخدمين
تمثيل JSON |
---|
{
"metadata": {
object ( |
الحقول | |
---|---|
metadata |
البيانات الوصفية عن البيانات التي يحددها المستخدم. |
key |
مفتاح المستخدم المحدد للبيانات التي يحددها المستخدم. |
value |
القيمة التي يحدّدها المستخدم للبيانات التي حدّدها المستخدم. |
الطُرق |
|
---|---|
|
إنشاء مجموعة من جهات الاتصال الجديدة وعرض PersonResponses لطلب البحث يجب إرسال طلبات التبديل للمستخدم نفسه بالتتابع لتجنب زيادة وقت الاستجابة والإخفاقات. |
|
حذف مجموعة من جهات الاتصال. |
|
حدِّث مجموعة من جهات الاتصال واعرض خريطة بأسماء الموارد على PersonResponses لجهات الاتصال المحدَّثة. |
|
أنشئ جهة اتصال جديدة وارجع مورد الشخص لجهة الاتصال هذه. |
|
حذف جهة اتصال. |
|
حذف صورة جهة اتصال. |
|
لتقديم معلومات حول شخص من خلال تحديد اسم مورد. |
|
يوفر معلومات حول قائمة بأسماء أشخاص محددين عن طريق تحديد قائمة بأسماء الموارد المطلوبة. |
|
توفر قائمة بالملفات الشخصية للنطاق وجهات اتصال النطاق في دليل نطاق المستخدم الذي تمت المصادقة عليه. |
|
لتقديم قائمة بجهات الاتصال في جهات الاتصال المجمّعة للمستخدم الذي تمت المصادقة عليها والتي تطابق طلب البحث. |
|
يقدم قائمة بالملفات الشخصية للنطاق وجهات اتصال النطاق في دليل نطاق المستخدم الذي تمت مصادقته والتي تطابق طلب البحث. |
|
تحديث بيانات جهة الاتصال لجهة اتصال حالية. |
|
تحديث صورة جهة اتصال. |