إدراج جميع "جهات الاتصال الأخرى"، أي جهات الاتصال التي ليست في مجموعة جهات اتصال. عادةً ما تكون "جهات الاتصال الأخرى" جهات اتصال يتم إنشاؤها تلقائيًا من التفاعلات.
تنتهي صلاحية الرموز المميّزة للمزامنة بعد 7 أيام من المزامنة الكاملة. إذا كان الطلب يتضمّن رمزًا مميّزًا للمزامنة منتهي الصلاحية، ستظهر رسالة خطأ تتضمّن google.rpc.ErrorInfo مع السبب "EXPIRED_SYNC_TOKEN". في حال حدوث هذا الخطأ، على البرامج إجراء طلب مزامنة كاملة بدون
.syncToken
تحتوي الصفحة الأولى من طلب المزامنة الكاملة على حصة إضافية. وإذا تم تجاوز الحصة، سيتم عرض خطأ 429. هذه الحصة ثابتة ولا يمكن زيادتها.
عند تحديد
، سيتم إرجاع الموارد المحذوفة منذ آخر مزامنة كشخص تم ضبط syncToken
على "صحيح".PersonMetadata.deleted
عند تحديد
أو pageToken
، يجب أن تتطابق جميع مَعلمات الطلب الأخرى مع الاستدعاء الأول.syncToken
قد يتأخر نشر طلبات المزامنة لعدة دقائق. عمليات المزامنة التدريجية غير مخصصة لحالات الاستخدام للقراءة بعد الكتابة.
يمكنك الاطّلاع على مثال للاستخدام في إدراج جهات الاتصال الأخرى للمستخدم التي تم تغييرها.
طلب HTTP
GET https://people.googleapis.com/v1/otherContacts
يستخدم عنوان URL بنية تحويل الترميز gRPC.
معلمات طلب البحث
المَعلمات | |
---|---|
pageToken |
اختياريّ. رمز مميّز للصفحة تم استلامه من ردّ سابق عند التقسيم على صفحات، يجب أن تتطابق جميع المَعلمات الأخرى المقدّمة إلى |
pageSize |
اختياريّ. عدد "جهات الاتصال الأخرى" المطلوب تضمينها في الرد تتراوح القيم الصالحة بين 1 و1000، بشكل شامل. يتم ضبط القيمة تلقائيًا على 100 إذا لم يتم ضبطها أو تم ضبطها على 0. |
requestSyncToken |
اختياريّ. ما إذا كان يجب أن يعرض الردّ الرمز يمكنك الاطّلاع على مزيد من التفاصيل حول طريقة المزامنة على الرابط |
syncToken |
اختياريّ. رمز مميز للمزامنة تم استلامه من رد سابق عند المزامنة، يجب أن تتطابق جميع المَعلمات الأخرى المقدّمة إلى يمكنك الاطّلاع على مزيد من التفاصيل حول طريقة المزامنة على الرابط |
readMask |
مطلوبة. قناع حقل لتقييد الحقول التي يتم عرضها لكل مستخدم يمكن تحديد عدة حقول من خلال الفصل بينها بفواصل. تعتمد القيم الصالحة على ما يتم استخدامه من ReadSourceType. في حال استخدام READ_SOURCE_TYPE_CONTACT، تكون القيم الصالحة كما يلي:
في حالة استخدام READ_SOURCE_TYPE_PROFILE، تكون القيم الصالحة كما يلي:
|
sources[] |
اختياريّ. قناع لأنواع المصادر المطلوب عرضها. يتم ضبط السياسة تلقائيًا على في ما يلي القيم المحتمَلة لهذا الحقل: ولا يُسمح بتحديد |
نص الطلب
يجب أن يكون نص الطلب فارغًا.
نص الاستجابة
الرد على طلب بخصوص "جهات الاتصال الأخرى" لدى المستخدم الذي تمت المصادقة عليه.
إذا كانت الاستجابة ناجحة، سيحتوي نص الاستجابة على بيانات بالبنية التالية:
تمثيل JSON |
---|
{
"otherContacts": [
{
object ( |
الحقول | |
---|---|
otherContacts[] |
تم عرض قائمة "جهات الاتصال الأخرى" كموارد للأشخاص. تتيح "جهات الاتصال الأخرى" استخدام مجموعة فرعية محدودة من الحقول. راجع ListOtherContactsRequest.request_mask للحصول على معلومات أكثر تفصيلاً. |
nextPageToken |
هو رمز مميّز يمكن إرساله على أنّه |
nextSyncToken |
هو رمز مميّز يمكن إرساله على أنّه |
totalSize |
إجمالي عدد جهات الاتصال الأخرى في القائمة بدون تقسيمها على صفحات. |
نطاقات التفويض
يجب توفير نطاق OAuth التالي:
https://www.googleapis.com/auth/contacts.other.readonly
لمزيد من المعلومات، يُرجى الاطّلاع على دليل التفويض.