نظرة عامة

يمكنك استخدام واجهة Threads API لتمكين الأشخاص من إنشاء المحتوى ونشره نيابةً عن شخص ما على Threads، وعرض تلك المنشورات داخل تطبيقك بشكل حصري للشخص الذي أنشأها.

تقييد معدلات الاستدعاء

المنشورات

تقتصر ملفات Threads الشخصية على 250 منشور يتم نشره من API خلال فترة متتابعة مدتها 24 ساعة. تُعد الإعلانات الدوّارة منشورًا فرديًا. يتم فرض هذا الحد على نقطة النهاية POST /{threads-user-id}/threads_publish عند محاولة نشر حاوية وسائط. نوصي بأن يفرض تطبيقك أيضًا تقييدًا لمعدلات استدعاء النشر، خاصةً إذا كان تطبيقك يتيح لمستخدمي التطبيق جدولة المنشورات المطلوب نشرها في المستقبل.

للتحقق من استخدام تقييد معدلات استدعاء Threads API الحالية للملف الشخصي، استعلم عن نقطة النهاية GET /{threads-user-id}/threads_publishing_limit.

ملاحظة: تتطلب نقطة النهاية هذه الإذن threads_basic وthreads_content_publish.

الحقول

مثال على الطلب

curl -s -X GET \
  "https:graph.threads.net/v1.0/<THREADS_USER_ID>/threads_publishing_limit?fields=quota_usage,config&access_token=<ACCESS_TOKEN>"

مثال على الاستجابة

{
  "data": [
    {
      "quota_usage": 4,
      "config": {
        "quota_total": 250,
        "quota_duration": 86400
      }
    }
  ]
}

الردود

تقتصر ملفات Threads الشخصية على 1000 رد خلال فترة متتابعة مدتها 24 ساعة.

للتحقق من استخدام تقييد معدلات استدعاء الردود الحالية على Threads للملف الشخصي، استعلم عن نقطة النهاية GET /{threads-user-id}/threads_publishing_limit. لمزيد من المعلومات، راجع إدارة الردود.

ملاحظة: تتطلب نقطة النهاية هذه الأذونات threads_basic وthreads_content_publish وthreads_manage_replies.

الحقول

مثال على الطلب

curl -s -X GET \
  "https://graph.threads.net/v1.0/<THREADS_USER_ID>/threads_publishing_limit?fields=reply_quota_usage,reply_config&access_token=<ACCESS_TOKEN>"

مثال على الاستجابة

{
  "data": [
    {
      "reply_quota_usage": 1,
      "reply_config": {
        "quota_total": 1000,
        "quota_duration": 86400
      }
    }
  ]
}

الحذف

تخضع ملفات Threads الشخصية لتقييد يبلغ 100 عملية حذف خلال فترة متحركة مدتها 24 ساعة.

للتحقق من استخدام تقييد معدلات استدعاء الحذف الحالية على Threads للملف الشخصي، استعلم عن نقطة النهاية GET /{threads-user-id}/threads_publishing_limit. راجع وثائق حذف المنشورات لمزيد من المعلومات.

ملاحظة: تتطلب نقطة النهاية هذه الإذنين threads_basic وthreads_content_publish.

الحقول

مثال على الطلب

curl -s -X GET \
  "https://graph.threads.net/v1.0/<THREADS_USER_ID>/threads_publishing_limit?fields=delete_quota_usage,delete_config&access_token=<ACCESS_TOKEN>"

مثال على الاستجابة

{
  "data": [
    {
      "delete_quota_usage": 1,
      "delete_config": {
        "quota_total": 100,
        "quota_duration": 86400
      }
    }
  ]
}

البحث عن موقع

تخضع ملفات Threads الشخصية لتقييد 500 عملية بحث عن الموقع خلال فترة متحركة مدتها 24 ساعة.

للتحقق من استخدام تقييد معدلات الاستدعاء للبحث عن الموقع الحالي على Threads للملف الشخصي، استعلم عن نقطة النهاية GET /{threads-user-id}/threads_publishing_limit. لمزيد من المعلومات، راجع وثائق البحث عن الموقع.

ملاحظة: تتطلب نقطة النهاية هذه الإذنين threads_basic وthreads_content_publish.

الحقول

مثال على الطلب

curl -s -X GET \
  "https://graph.threads.net/v1.0/<THREADS_USER_ID>/threads_publishing_limit?fields=location_search_quota_usage,location_search_config&access_token=<ACCESS_TOKEN>"

مثال على الاستجابة

{
  "data": [
    {
      "location_search_quota_usage": 1,
      "location_search_config": {
        "quota_total": 500,
        "quota_duration": 86400
      }
    }
  ]
}

القيود والمواصفات

قيود أخرى

• تقتصر المنشورات النصية على 500 حرف.
• يجب أن تحتوي منشورات العناصر الدوّارة على ما يصل إلى 20 منشورًا فرعيًا كحد أقصى ومنشورين فرعيين كحد أدنى.
• لمعرفة المزيد من القيود، راجع مرجع كل نقطة نهاية.

الخطوات التالية

• بدء استخدام Threads API