Profiles
الحصول على ملفات تعريف المستخدمين
احصل على جميع الملفات الشخصية المرتبطة بالملف الأساسي.
GET
احصل على جميع الملفات الشخصية المرتبطة بالملف الأساسي. لا يتم إرجاع الملف الأساسي في النتائج.
للأمان، لا يتم إرجاع Profile Keys عبر استدعاء GET هذا. يُرجى الاطلاع هنا لمزيد من المعلومات.
معلمات الرأس
معلمات الاستعلام
أعِد فقط الملف الشخصي المرتبط بالعنوان المشفَّر بصيغة URL.
أعِد فقط الملف الشخصي المرتبط بـ
refId المحدّد. تم إرجاع refId أثناء إنشاء
الملف الشخصي أو من نقطة النهاية /user.إذا كانت القيمة
true فأعد فقط الملفات الشخصية التي تحتوي على حساب اجتماعي واحد متّصل على الأقل
(طول activeSocialAccounts أكبر من صفر). إذا كانت false فأعد فقط الملفات الشخصية التي تحتوي على صفر
من الحسابات الاجتماعية المتّصلة (طول activeSocialAccounts هو صفر).تصفية الملفات الشخصية لتضمين تلك التي تحتوي
activeSocialAccounts الخاصّة بها على جميع منصّات وسائل التواصل الاجتماعي المحدّدة في قائمة includesActiveSocialAccounts. يمكن أن تحتوي الملفات الشخصية على منصّات إضافية في activeSocialAccounts بخلاف تلك المدرَجة في includesActiveSocialAccounts وأن تبقى مضمّنة في النتائج المفلترة.القيم: bluesky وfacebook وgmb وinstagram وlinkedin وpinterest وreddit وsnapchat وtelegram وthreads وtiktok وtwitter وyoutube.تصفية الملفات الشخصية حسب حالة ترحيل BYOK (Bring Your Own Key). إذا كانت
true، فأعد فقط الملفات الشخصية التي أكملت ترحيل BYOK. إذا كانت false، فأعد فقط الملفات الشخصية التي تحتوي على منصّة مؤهّلة لـ BYOK متّصلة ولكن لم يتم ترحيلها بعد. يتم استبعاد الملفات الشخصية التي لا تحتوي على منصّة مؤهّلة لـ BYOK عند تعيين هذا المرشّح. عند حذفه، تتم إعادة جميع الملفات الشخصية بغضّ النظر عن حالة BYOK. ينطبق حاليًا على X/Twitter BYOK.إعادة سجل إجراءات إنشاء وحذف ملف تعريف المستخدم لآخر 60 يومًا وعدد المستخدمين النشطين المستخدم للفوترة لآخر 60 يومًا. ملاحظة:
- Action Log: لن يتم إرجاع العنوان والوسوم لسجل الإجراءات قبل مارس 2025.
- User Profile Report: قد لا تتوافق الفترة الزمنية مع فترة الفوترة الخاصة بك. على سبيل المثال، قد تبدأ فترة الفوترة الخاصة بك وتنتهي في العاشر من الشهر. يُرجى الاطلاع على فواتيرك للاطلاع على فترة الفوترة والتفاصيل الأخرى.
actionLog=10 سجل الإجراءات لآخر 10 أيام وعدد المستخدمين النشطين المُبلَّغ عنه
لآخر 10 أيام. الفترة الزمنية المسموح بها من 1 يوم إلى 365 يومًا.حدّد عدد الملفات الشخصية المعادة. الافتراضي والحد الأقصى هو 5000.
إذا كان هناك ملفات شخصية إضافية للإرجاع وكان علم
hasMore هو true، فسيتم إرجاع nextCursor في الاستجابة.
مرّر هذا المؤشر إلى معلمة الاستعلام cursor لإرجاع المجموعة التالية من الملفات الشخصية.إعادة بيانات ملف شخصي موسّعة لاستكشاف الأخطاء وإصلاحها. تتطلّب معلمة
refId (بحث ملف شخصي واحد).القيم (سلسلة مفصولة بفواصل أو مصفوفة): suspension وsocialHealth وlinkingErrors وactivity وquota وunlinkHistory وactionLog.suspension- isSuspended, reason, suspendedAt, unsuspendAt, suspensionCountsocialHealth- لكل منصّة: linked, linkedAt, relinkRecommended, messagingEnabled, tokenExpiresAtlinkingErrors- لكل منصّة: code, message, details, createdAtactivity- lastApiCall, lastPost timestampsquota- used, limitunlinkHistory- آخر إلغاء ربط: platform, source (user/system), details, createdAtactionLog- سجل إجراءات الملف الشخصي (create/update/delete)
