سرد جميع مجموعات جهات الاتصال التي يملكها المستخدم الذي تمت المصادقة عليه لا تتم تعبئة أعضاء مجموعات جهات الاتصال.
طلب HTTP
GET https://people.googleapis.com/v1/contactGroups
يستخدم عنوان URL بنية تحويل الترميز gRPC.
معلمات طلب البحث
المَعلمات | |
---|---|
pageToken |
اختياريّ. قيمة nextPageToken التي تم إرجاعها من استدعاء سابق إلى contactGroups.list. لطلب الصفحة التالية من الموارد. |
pageSize |
اختياريّ. الحد الأقصى لعدد الموارد المطلوب عرضها. تتراوح القيم الصالحة بين 1 و1000، بشكل شامل. يتم ضبط القيمة على 30 تلقائيًا إذا لم يتم ضبطها أو تم ضبطها على 0. |
syncToken |
اختياريّ. رمز مميز للمزامنة، تم عرضه من خلال مكالمة سابقة إلى |
groupFields |
اختياريّ. قناع حقل لتقييد الحقول التي يتم عرضها في المجموعة ويتم ضبط الإعدادات التلقائية على
|
نص الطلب
يجب أن يكون نص الطلب فارغًا.
نص الاستجابة
الرد على طلب لمجموعات جهات اتصال قائمة.
إذا كانت الاستجابة ناجحة، سيحتوي نص الاستجابة على بيانات بالبنية التالية:
تمثيل JSON |
---|
{
"contactGroups": [
{
object ( |
الحقول | |
---|---|
contactGroups[] |
قائمة مجموعات جهات الاتصال. لا تتم تعبئة أعضاء مجموعات جهات الاتصال. |
totalItems |
إجمالي عدد العناصر في القائمة بدون التقسيم على صفحات. |
nextPageToken |
الرمز المميز الذي يمكن استخدامه لاسترداد الصفحة التالية من النتائج. |
nextSyncToken |
الرمز المميّز الذي يمكن استخدامه لاسترداد التغييرات منذ آخر طلب. |
نطاقات التفويض
يتطلب استخدام أحد نطاقات OAuth التالية:
https://www.googleapis.com/auth/contacts
https://www.googleapis.com/auth/contacts.readonly
لمزيد من المعلومات، يُرجى الاطّلاع على دليل التفويض.