Method: people.get

لتقديم معلومات حول شخص من خلال تحديد اسم مورد. استخدِم people/me للإشارة إلى المستخدم الذي تمت المصادقة عليه.

يعرض الطلب خطأ 400 إذا لم يتم تحديد "personFields".

طلب HTTP

GET https://people.googleapis.com/v1/{resourceName=people/*}

يستخدم عنوان URL بنية تحويل ترميز gRPC.

معلمات المسار

المَعلمات
resourceName

string

مطلوبة. اسم مورد الشخص لتقديم معلومات عنه.

  • للحصول على معلومات حول المستخدم الذي تمت المصادقة عليه، حدِّد people/me.
  • للحصول على معلومات حول حساب Google، حدد people/{account_id}.
  • للحصول على معلومات عن جهة اتصال، حدد اسم المورد الذي يحدد جهة الاتصال على أنه تم إرجاعه من قِبل people.connections.list.

معامِلات طلب البحث

المَعلمات
requestMask
(deprecated)

object (RequestMask)

تم الإيقاف (يُرجى استخدام personFields بدلاً من ذلك)

قناع لحصر النتائج بمجموعة فرعية من حقول الأشخاص.
personFields

string (FieldMask format)

مطلوبة. قناع حقل لتقييد الحقول المعروضة على الشخص. يمكن تحديد حقول متعددة من خلال فصلها بفواصل. القيم الصالحة هي:

  • عنوان واحد
  • الفئات العمرية
  • سير ذاتية
  • أعياد ميلاد
  • عناوين URL للتقويم
  • بيانات العميل
  • صور الغلاف
  • عناوين البريد الإلكتروني
  • فعاليات
  • المعرّفات الخارجية
  • أنواع
  • عملاء IIM
  • الاهتمامات
  • اللغات
  • مواقع جغرافية
  • للقناة
  • البيانات الوصفية
  • كلمات رئيسية متنوعة
  • أسماء
  • الألقاب
  • مهن
  • المؤسسات
  • أرقام الهاتف
  • صور
  • علاقات
  • sipAddresses
  • مهارات
  • عناوين url
  • من تحديد المستخدم
sources[]

enum (ReadSourceType)

اختياريّ. قناع لأنواع المصادر التي يتم عرضها. إعداد القيمة التلقائية على READ_SOURCE_TYPE_PROFILE وREAD_SOURCE_TYPE_CONTACT في حال عدم ضبطه.

نص الطلب

يجب أن يكون نص الطلب فارغًا.

نص الاستجابة

إذا كانت الاستجابة ناجحة، يحتوي نص الاستجابة على مثال Person.

نطاقات الأذونات

لا يلزم الحصول على إذن للوصول إلى البيانات العامة. بالنسبة إلى البيانات الخاصة، يجب استخدام أحد نطاقات OAuth التالية:

  • https://www.googleapis.com/auth/contacts
  • https://www.googleapis.com/auth/contacts.readonly
  • https://www.googleapis.com/auth/directory.readonly
  • https://www.googleapis.com/auth/profile.agerange.read
  • https://www.googleapis.com/auth/profile.emails.read
  • https://www.googleapis.com/auth/profile.language.read
  • https://www.googleapis.com/auth/user.addresses.read
  • https://www.googleapis.com/auth/user.birthday.read
  • https://www.googleapis.com/auth/user.emails.read
  • https://www.googleapis.com/auth/user.gender.read
  • https://www.googleapis.com/auth/user.organization.read
  • https://www.googleapis.com/auth/user.phonenumbers.read
  • https://www.googleapis.com/auth/userinfo.email
  • https://www.googleapis.com/auth/userinfo.profile

لمزيد من المعلومات، راجع دليل التفويض.