- المرجع: شخص
- تمثيل JSON
- PersonMetadata
- المصدر
- SourceType
- ProfileMetadata
- ObjectType
- UserType
- العنوان
- FieldMetadata
- AgeRange
- AgeRangeType
- السيرة الذاتية
- ContentType
- تاريخ الميلاد
- التاريخ
- BraggingRights
- CalendarUrl
- ClientData
- CoverPhoto
- EmailAddress
- فعالية
- ExternalId
- FileAs
- الجنس
- ImClient
- الاهتمام
- اللغة
- الموقع الجغرافي
- الاشتراك
- ContactGroupMembership
- DomainMembership
- MiscKeyword
- KeywordType
- الاسم
- اللقب
- NicknameType
- الوظيفة
- المؤسسة
- PhoneNumber
- الصورة
- العلاقة
- RelationshipInterest
- RelationshipStatus
- الإقامة
- SipAddress
- المهارة
- سطر الوصف
- عنوان URL
- UserDefined
- الطُرق
المرجع: شخص
معلومات حول شخص تم دمجها من مصادر بيانات مختلفة، مثل جهات اتصال المستخدم الذي تمت المصادقة عليه وبيانات الملف الشخصي.
يمكن أن تتضمّن معظم الحقول عناصر متعدّدة. ولا تتضمّن العناصر المدرَجة في أحد الحقول ترتيبًا مضمونًا، ولكن يمكن ضمان أن يحتوي كل حقل غير فارغ على حقل واحد فقط مع ضبط metadata.primary
على "صحيح".
تمثيل 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[] |
تمثّل هذه السمة البيانات التي يحدّدها المستخدم للشخص. |
PersonMetadata
بيانات التعريف حول شخص ما.
تمثيل JSON |
---|
{ "sources": [ { object ( |
الحقول | |
---|---|
sources[] |
مصادر البيانات للشخص. |
previousResourceNames[] |
النتائج فقط. أي أسماء موارد سابقة لدى هذا الشخص وتتم تعبئة هذا الحقل لطلبات قد يتغيّر اسم المورد عند إضافة أو إزالة الحقول التي تربط جهة اتصال وملف شخصي، مثل عنوان بريد إلكتروني تمّ إثبات ملكيته أو رقم هاتف تمّ إثبات ملكيته أو عنوان URL لملف شخصي. |
linkedPeopleResourceNames[] |
النتائج فقط. أسماء الموارد للأشخاص المرتبطين بهذا المورد |
deleted |
النتائج فقط. صحيح إذا تم حذف مورد الشخص. تتم تعبئة هذا الحقل فقط لطلبات مزامنة |
objectType |
النتائج فقط. تم الإيقاف (يُرجى استخدام نوع كائن الشخص. |
المصدر
مصدر الحقل.
تمثيل JSON |
---|
{ "type": enum ( |
الحقول | |
---|---|
type |
نوع المصدر |
id |
المعرّف الفريد ضمن نوع المصدر الذي ينشئه الخادم. |
etag |
تتم تعبئة هذا الحقل فقط في علامة كيان HTTP للمصدر. يُستخدم للتحقّق من ذاكرة التخزين المؤقت على الويب. |
updateTime |
النتائج فقط. تتم تعبئة هذا الحقل فقط في الطابع الزمني لآخر تعديل لهذا المصدر طابع زمني بتنسيق RFC3339 UTC "Zulu" ، مع دقة نانوثانية وما يصل إلى تسعة أرقام كسرية. أمثلة: |
حقل الاتحاد بيانات التعريف حول المصدر يمكن أن يكون الحقل " |
|
profileMetadata |
النتائج فقط. تتم تعبئة هذا الحقل فقط في بيانات التعريف حول مصدر من النوع PROFILE. |
SourceType
نوع المصدر
عمليات التعداد | |
---|---|
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. |
ProfileMetadata
البيانات الوصفية حول الملف الشخصي.
تمثيل JSON |
---|
{ "objectType": enum ( |
الحقول | |
---|---|
objectType |
النتائج فقط. نوع كائن الملف الشخصي. |
userTypes[] |
النتائج فقط. أنواع المستخدمين. |
ObjectType
تمثّل هذه السمة نوع كائن شخص.
عمليات التعداد | |
---|---|
OBJECT_TYPE_UNSPECIFIED |
غير محدد |
PERSON |
شخص. |
PAGE |
صفحة Currents: |
UserType
نوع المستخدم.
عمليات التعداد | |
---|---|
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. |
FieldMetadata
بيانات التعريف عن أحد المجالات.
تمثيل JSON |
---|
{
"primary": boolean,
"sourcePrimary": boolean,
"verified": boolean,
"source": {
object ( |
الحقول | |
---|---|
primary |
النتائج فقط. True إذا كان الحقل هو الحقل الأساسي لكل المصادر في الشخص. يجب أن يكون لكل مستخدم حقل واحد على الأكثر مع ضبط |
sourcePrimary |
True إذا كان الحقل هو الحقل الأساسي لـ |
verified |
النتائج فقط. صحيح إذا تم التحقق من الحقل، وخطأ إذا لم يتم التحقق من الحقل. عادةً ما يكون الحقل الذي تم إثبات ملكيته هو اسم أو عنوان بريد إلكتروني أو رقم هاتف أو موقع إلكتروني تم تأكيد ملكيته للمستخدم. |
source |
مصدر الحقل. |
AgeRange
تم الإيقاف (يُرجى استخدام person.ageRanges
بدلاً من ذلك)
الفئة العمرية للشخص.
عمليات التعداد | |
---|---|
AGE_RANGE_UNSPECIFIED |
غير محدد |
LESS_THAN_EIGHTEEN |
أصغر من ثمانية عشر عامًا. |
EIGHTEEN_TO_TWENTY |
بَيْنَ ثَمَانِي عَشْرَةَ وَأَرْبَعٍ وَعِشْرِينَ دَرَجَة. |
TWENTY_ONE_OR_OLDER |
واحد وعشرون وأكثر. |
AgeRangeType
الفئة العمرية للشخص.
تمثيل JSON |
---|
{ "metadata": { object ( |
الحقول | |
---|---|
metadata |
بيانات التعريف حول الفئة العمرية. |
ageRange |
الفئة العمرية. |
سيرة ذاتية
السيرة الذاتية القصيرة لشخص ما.
تمثيل JSON |
---|
{ "metadata": { object ( |
الحقول | |
---|---|
metadata |
بيانات وصفية حول السيرة الذاتية |
value |
السيرة الذاتية القصيرة. |
contentType |
تمثّل هذه السمة نوع محتوى السيرة الذاتية. |
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 لتحديد عام بحد ذاته أو العام والشهر اللذين لا يكون فيهما اليوم أهمية. |
BraggingRights
تم إيقافها: لن يتم إرجاع حقوق الشخص الذي يتباهى به.
تمثيل JSON |
---|
{
"metadata": {
object ( |
الحقول | |
---|---|
metadata |
بيانات وصفية حول الحقوق التي تتباهى بها |
value |
بعض الأشياء التي يجب التباهي بها، على سبيل المثال |
CalendarUrl
عنوان URL لتقويم المستخدم
تمثيل JSON |
---|
{
"metadata": {
object ( |
الحقول | |
---|---|
metadata |
البيانات الوصفية حول عنوان URL للتقويم |
url |
عنوان URL للتقويم |
type |
نوع عنوان URL للتقويم. ويمكن أن يكون النوع مخصّصًا أو أحد القيم التالية المحدّدة مسبقًا:
|
formattedType |
النتائج فقط. تشير هذه السمة إلى نوع عنوان URL للتقويم الذي تمت ترجمة تنسيقه وتنسيقه في لغة حساب المشاهد أو لغة عنوان HTTP |
ClientData
بيانات العميل العشوائية التي تتم تعبئتها من قِبل العملاء. يُسمح بالمفاتيح والقيم المكررة.
تمثيل JSON |
---|
{
"metadata": {
object ( |
الحقول | |
---|---|
metadata |
بيانات التعريف حول بيانات العميل. |
key |
حدَّد العميل مفتاح بيانات العميل. |
value |
القيمة المحدّدة للعميل لبيانات العميل. |
CoverPhoto
صورة غلاف المستخدم صورة كبيرة يتم عرضها على صفحة الملف الشخصي للشخص وتمثِّل هويته أو ما يهتم به.
تمثيل JSON |
---|
{
"metadata": {
object ( |
الحقول | |
---|---|
metadata |
البيانات الوصفية حول صورة الغلاف |
url |
تمثّل هذه السمة عنوان URL لصورة الغلاف. |
default |
صحيح إذا كانت صورة الغلاف هي صورة الغلاف التلقائية، وخطأ إذا كانت صورة الغلاف هي صورة غلاف مقدّمة من المستخدم. |
EmailAddress
تمثّل هذه السمة عنوان البريد الإلكتروني لأحد المستخدمين.
تمثيل JSON |
---|
{
"metadata": {
object ( |
الحقول | |
---|---|
metadata |
بيانات التعريف حول عنوان البريد الإلكتروني. |
value |
عنوان البريد الإلكتروني |
type |
نوع عنوان البريد الإلكتروني. ويمكن أن يكون النوع مخصّصًا أو أحد القيم التالية المحدّدة مسبقًا:
|
formattedType |
النتائج فقط. تمثّل هذه السمة نوع عنوان البريد الإلكتروني الذي تمت ترجمته وتنسيقه بلغة حساب المُشاهد أو لغة عنوان HTTP |
displayName |
الاسم المعروض للرسالة الإلكترونية. |
حدث
حدث متعلق بالشخص.
تمثيل JSON |
---|
{ "metadata": { object ( |
الحقول | |
---|---|
metadata |
البيانات الوصفية حول الحدث. |
date |
تاريخ الحدث. |
type |
نوع الحدث ويمكن أن يكون النوع مخصّصًا أو أحد القيم التالية المحدّدة مسبقًا:
|
formattedType |
النتائج فقط. نوع الحدث المترجَم وتنسيقه في لغة حساب المُشاهد أو لغة عنوان HTTP |
ExternalId
معرّف من كيان خارجي مرتبط بالشخص.
تمثيل JSON |
---|
{
"metadata": {
object ( |
الحقول | |
---|---|
metadata |
البيانات الوصفية حول المعرّف الخارجي |
value |
قيمة المعرّف الخارجي. |
type |
نوع المعرّف الخارجي. ويمكن أن يكون النوع مخصّصًا أو أحد القيم التالية المحدّدة مسبقًا:
|
formattedType |
النتائج فقط. نوع الحدث المترجَم وتنسيقه في لغة حساب المُشاهد أو لغة عنوان HTTP |
FileAs
الاسم الذي يجب استخدامه لترتيب الشخص في قائمة.
تمثيل JSON |
---|
{
"metadata": {
object ( |
الحقول | |
---|---|
metadata |
بيانات التعريف حول الملف باسم. |
value |
تشير قيمة file-as إلى ... |
الجنس
جنس المستخدم
تمثيل JSON |
---|
{
"metadata": {
object ( |
الحقول | |
---|---|
metadata |
بيانات التعريف عن الجنس. |
value |
تمثّل هذه السمة الجنس للشخص. ويمكن أن يكون الجنس مخصّصًا أو إحدى القيم المحدّدة مسبقًا التالية:
|
formattedValue |
النتائج فقط. قيمة الجنس التي تمت ترجمتها وتنسيقها في لغة حساب المُشاهد أو لغة عنوان HTTP |
addressMeAs |
حقل نصي يتضمّن تصميمًا مجانيًا للضمائر التي يجب استخدامها لمخاطبة الأشخاص القيم الشائعة هي:
|
ImClient
برنامج المراسلة الفورية لأحد الأشخاص.
تمثيل JSON |
---|
{
"metadata": {
object ( |
الحقول | |
---|---|
metadata |
بيانات وصفية عن عميل المراسلة الفورية |
username |
اسم المستخدم في برنامج المراسلة الفورية |
type |
نوع عميل المراسلة الفورية ويمكن أن يكون النوع مخصّصًا أو أحد القيم التالية المحدّدة مسبقًا:
|
formattedType |
النتائج فقط. نوع برنامج الرسائل الفورية المترجَم وتنسيقه في لغة حساب المُشاهد أو لغة عنوان 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 |
النتائج فقط. عضوية النطاق. |
ContactGroupMembership
اشتراك في مجموعة "جهات اتصال Google"
تمثيل JSON |
---|
{ "contactGroupId": string, "contactGroupResourceName": string } |
الحقول | |
---|---|
contactGroupId |
النتائج فقط. رقم تعريف مجموعة جهات الاتصال لعضوية مجموعة جهات الاتصال. |
contactGroupResourceName |
اسم المورد لمجموعة جهات الاتصال، الذي يعينه الخادم. تمثّل هذه السمة سلسلة ASCII على شكل |
DomainMembership
اشتراك في نطاق Google Workspace:
تمثيل JSON |
---|
{ "inViewerDomain": boolean } |
الحقول | |
---|---|
inViewerDomain |
صحيح إذا كان المستخدم ضمن نطاق Google Workspace للمُشاهد. |
MiscKeyword
الكلمة الرئيسية المتنوعة لأحد الأشخاص.
تمثيل JSON |
---|
{ "metadata": { object ( |
الحقول | |
---|---|
metadata |
البيانات الوصفية عن الكلمات الرئيسية المتنوعة |
value |
قيمة الكلمة الرئيسية المتنوعة. |
type |
نوع الكلمات الرئيسية المتنوعة. |
formattedType |
النتائج فقط. نوع الكلمة الرئيسية المتنوعة التي تمت ترجمتها وتنسيقها في لغة حساب المشاهد أو لغة عنوان HTTP |
KeywordType
نوع كلمة رئيسية متنوعة.
عمليات التعداد | |
---|---|
TYPE_UNSPECIFIED |
غير محدد |
OUTLOOK_BILLING_INFORMATION |
حقل Outlook لمعلومات الفوترة. |
OUTLOOK_DIRECTORY_SERVER |
حقل Outlook لخادم الدليل. |
OUTLOOK_KEYWORD |
حقل Outlook للكلمة الرئيسية. |
OUTLOOK_MILEAGE |
حقل توقعات للمسافة المقطوعة |
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 |
تمثّل هذه السمة نوع اللقب. |
NicknameType
تمثّل هذه السمة نوع اللقب.
عمليات التعداد | |
---|---|
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 |
النسبة المئوية للملليِن بدوام كامل للشخص داخل المؤسسة (100,000 = 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 Accept-Language |
RelationshipInterest
تم إيقافها: لن يتم عرض أي بيانات عن علاقة الشخص .
تمثيل JSON |
---|
{
"metadata": {
object ( |
الحقول | |
---|---|
metadata |
بيانات وصفية حول العلاقة بين المعلِن |
value |
نوع العلاقة التي يبحث عنها الشخص. يمكن أن تكون القيمة مخصّصة أو إحدى القيم المحدّدة مسبقًا التالية:
|
formattedValue |
النتائج فقط. قيمة العلاقة بالعلاقة التي تتم ترجمتها وتنسيقها في لغة حساب المشاهد أو اللغة المحدّدة في عنوان HTTP الخاص بالموافقة على اللغة. |
RelationshipStatus
تم إيقافها: لن يتم عرض أي بيانات عن الحالة الاجتماعية للشخص.
تمثيل JSON |
---|
{
"metadata": {
object ( |
الحقول | |
---|---|
metadata |
بيانات التعريف حول حالة العلاقة. |
value |
حالة العلاقة. يمكن أن تكون القيمة مخصّصة أو إحدى القيم المحدّدة مسبقًا التالية:
|
formattedValue |
النتائج فقط. قيمة حالة العلاقة تتم ترجمتها وتنسيقها في لغة حساب المُشاهد أو لغة عنوان HTTP |
الإقامة
تم إيقافها: يُرجى استخدام person.locations
بدلاً منها. مكان الإقامة السابق أو الحالي للشخص
تمثيل JSON |
---|
{
"metadata": {
object ( |
الحقول | |
---|---|
metadata |
بيانات وصفية حول مكان الإقامة. |
value |
تمثّل هذه السمة عنوان الإقامة. |
current |
صحيح إذا كان مكان الإقامة هو محل الإقامة الحالي للشخص، وعلى خطأ إذا كان مكان الإقامة هو محل إقامة سابق. |
SipAddress
عنوان 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 |
UserDefined
بيانات المستخدمين العشوائية التي يملأها المستخدمون.
تمثيل JSON |
---|
{
"metadata": {
object ( |
الحقول | |
---|---|
metadata |
بيانات التعريف حول البيانات التي يحددها المستخدم. |
key |
مفتاح تحديد المستخدم النهائي للبيانات التي يحدِّدها المستخدم. |
value |
القيمة المحدّدة للمستخدم النهائي للبيانات التي يحدِّدها المستخدم. |
الطُرق |
|
---|---|
|
قم بإنشاء مجموعة من جهات الاتصال الجديدة وعرض PersonResponses لأول مرة يجب إرسال طلبات التبديل للمستخدم نفسه بشكل تسلسلي لتجنُّب زيادة وقت الاستجابة وعمليات الإخفاق. |
|
حذف مجموعة من جهات الاتصال |
|
قم بتحديث مجموعة من جهات الاتصال وإرجاع خريطة لأسماء الموارد إلى PersonResponses لجهات الاتصال التي تم تحديثها. |
|
إنشاء جهة اتصال جديدة وعرض مورد الشخص لجهة الاتصال هذه. |
|
حذف جهة اتصال |
|
حذف صورة جهة اتصال |
|
توفر معلومات عن أحد الأشخاص من خلال تحديد اسم مورد. |
|
يوفر معلومات عن قائمة أشخاص محددين عن طريق تحديد قائمة بأسماء الموارد المطلوبة. |
|
يوفّر هذا الإعداد قائمة بملفات النطاق الشخصية وجهات اتصال النطاق في دليل نطاق المستخدم الذي تمت المصادقة عليه. |
|
توفّر هذه السياسة قائمة بجهات الاتصال في جهات الاتصال المجمَّعة للمستخدم الذي تمت المصادقة عليه والتي تتطابق مع طلب البحث. |
|
توفّر هذه السياسة قائمة بملفات النطاق الشخصية وجهات اتصال النطاق في دليل نطاق المستخدم الذي تمت المصادقة عليه والذي يطابق طلب البحث. |
|
تعديل بيانات جهة الاتصال لجهة اتصال حالية |
|
تعديل صورة جهة الاتصال |