الانتقال إلى المحتوى الرئيسي
POST
استرجع تحليلات المنشورات التي لم تنشأ عبر Ayrshare عن طريق توفير معرف المنشور الاجتماعي منخفض المستوى. يتم إرجاع هذا المعرف في حقل postIds من نقطة نهاية /post. يجب أن يكون الحساب المرتبط هو مالك المنشور لاسترجاع التحليلات (استثناء: YouTube؛ راجع أدناه). المنصات المدعومة: Facebook وInstagram وLinkedIn وThreads وTikTok وTwitter وYouTube.
  • الاستدعاء هو نفسه نقطة نهاية التحليلات على منشور. الفرق الرئيسي هو أنك تستخدم معرف المنشور الذي تُرجعه الشبكة الاجتماعية بدلاً من معرف Ayrshare. تضمّن أيضًا المعلمة searchPlatformId: true لإعلام نقطة النهاية بأنك تبحث بواسطة معرف المنشور الاجتماعي.
  • استخدم نقطة نهاية الحصول على كل سجل المنشورات لاسترجاع المنشورات والمعرفات التي نشأت خارج Ayrshare والموجودة في حقل id.
  • يُنصح باستخدامها فقط للمنشورات التي لم تُرسل عبر Ayrshare. بالنسبة للمنشورات المُرسلة عبر Ayrshare، استخدم نقطة نهاية التحليلات.
  • التحليلات على منشورات Instagram التي نُشرت قبل تحويل حساب المستخدم إلى حساب أعمال من حساب شخصي لها تحليلات محدودة.
  • عند استرجاع تحليلات YouTube لمنشور لا ينتمي إلى قناتك باستخدام طريقة المعرف الاجتماعي، ستُرجع واجهة برمجة التطبيقات بيانات وصفية عن المحتوى بينما تعرض أصفارًا لجميع المقاييس الرقمية. سيتم تعبئة المعلومات الوصفية مثل العنوان والوصف والوسوم وعنوان القناة وحالة الخصوصية وعناوين URL للصور المصغرة بشكل صحيح، مما يوفر سياقًا حول محتوى الفيديو. ومع ذلك، فإن جميع مقاييس الأداء الرقمية بما في ذلك المشاهدات والإعجابات والتعليقات والمشاركات وتغيرات المشتركين ومدة المشاهدة وإضافات قائمة التشغيل ستُرجع كقيم صفرية.
  • عند استخدام postIds لسلاسل X/Twitter، يجب توفير معرف المنشور الاجتماعي لكل تغريدة بشكل فردي؛ لا يتم تضمين تغريدات السلسلة تلقائيًا عند الاستعلام عن المنشور الأصلي.

معلمات الترويسة

معلمات النص

يجب توفير إما id أو postIds. استخدم id لمنشور واحد أو postIds لاسترجاع تحليلات لعدة منشورات في طلب واحد.
id
string
معرف المنشور الاجتماعي الذي يتم إرجاعه من نقطة نهاية /post. هذا هو حقل id لشبكة اجتماعية فردية موجودة في مصفوفة postIds. إما id أو postIds مطلوب.
postIds
array
مصفوفة من معرفات المنشور الاجتماعي لاسترجاع التحليلات لعدة منشورات في طلب واحد. يُسمح بحد أقصى 100 معرف. إما id أو postIds مطلوب.
platforms
array
مطلوب
مصفوفة سلاسل من المنصات لاسترجاع التحليلات. يُسمح بقيمة واحدة فقط.القيم المتاحة:
searchPlatformId
boolean
افتراضي:false
مطلوب
اضبط على true للبحث بواسطة معرف المنشور الاجتماعي.
عندما تكون المقاييس التراكمية (مثل الإعجابات والتعليقات والمشاهدات) غير متوفرة مؤقتًا من الشبكة الاجتماعية، تقوم واجهة برمجة التطبيقات تلقائيًا بتعبئتها من البيانات المخزنة. قد يظهر حقلان اختياريان في كائن analytics لكل منصة:
  • backfilledFrom (سلسلة، ISO 8601) — موجود عندما تم استبدال مقياس تراكمي واحد أو أكثر من البيانات المخزنة. يشير الطابع الزمني إلى آخر تحديث للبيانات المخزنة.
  • recoveredFrom (سلسلة، ISO 8601) — موجود عندما تم استرداد استجابة التحليلات بأكملها من البيانات المخزنة بسبب فشل كامل في واجهة برمجة التطبيقات. يشير الطابع الزمني إلى آخر تحديث للبيانات المخزنة.
تُعتبر البيانات المخزنة الأقدم من 4 أيام قديمة ولن تُستخدم للتعبئة أو الاسترداد.