يوفّر معلومات عن قائمة بمستخدمين محدّدين من خلال تحديد قائمة بأسماء الموارد المطلوبة. استخدِم people/me
للإشارة إلى المستخدم الذي تمّت مصادقته.
يعرض الطلب خطأ 400 إذا لم يتم تحديد "personFields".
طلب HTTP
GET https://people.googleapis.com/v1/people:batchGet
يستخدِم عنوان URL بنية تحويل ترميز gRPC.
مَعلمات طلب البحث
المعلمات | |
---|---|
resourceNames[] |
مطلوب. أسماء الموارد للأشخاص المطلوب تقديم معلومات عنهم يمكن تكرار الإجراء. يجب أن تكون مَعلمة طلب البحث لعنوان URL
يبلغ الحد الأقصى لعدد أسماء الموارد 200 اسم مورد. |
requestMask |
تم الإيقاف (يُرجى استخدام قناع لتقييد النتائج بمجموعة فرعية من حقول الأشخاص. |
personFields |
مطلوب. قناع حقل لتقييد الحقول التي يتم عرضها لكل شخص يمكن تحديد حقول متعددة من خلال فصلها بفواصل. القيم الصالحة هي:
|
sources[] |
اختياريّ. قناع لأنواع المصادر التي سيتم عرضها ويتم ضبط القيمة التلقائية على |
نص الطلب
يجب أن يكون نص الطلب فارغًا.
نص الاستجابة
ردّ على طلب الحصول على قائمة بالأشخاص حسب اسم المورد
إذا كانت الاستجابة ناجحة، سيحتوي نص الاستجابة على بيانات بالبنية التالية:
تمثيل JSON |
---|
{
"responses": [
{
object ( |
الحقول | |
---|---|
responses[] |
الردّ لكل اسم مورد مطلوب |
نطاقات الأذونات
لا يلزم الحصول على إذن للوصول إلى البيانات العامة. بالنسبة إلى البيانات الخاصة، يجب توفير أحد نطاقات OAuth التالية:
https://www.googleapis.com/auth/contacts
https://www.googleapis.com/auth/contacts.readonly
https://www.googleapis.com/auth/contacts.other.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
https://www.googleapis.com/auth/profile.language.read
لمزيد من المعلومات، يمكنك الاطّلاع على دليل التفويض.