الانتقال إلى المحتوى الرئيسي
تقدّم Ayrshare نشرًا مباشرًا لفيديوهات TikTok وإدارة للتعليقات واسترجاعًا للتحليلات المتقدّمة لأيٍّ من حسابك الشخصي أو التجاري على TikTok باستخدام TikTok API.يعالج TikTok الفيديو والصور بشكل غير متزامن، لذا ستكون استجابة JSON بحالة status: “pending” لكلٍّ من المنشورات الفورية والمجدولة. بمجرد أن ينتهي TikTok من المعالجة، سيتمّ استدعاء Scheduled Action webhook المسجّل لديك.

منشور فيديو TikTok

JSON لمنشور فيديو TikTok أساسي يُنشر مباشرة:
TikTok Video Post
مثال على استجابة JSON للمنشور:
TikTok Video Post Response
  • لا يدعم TikTok حاليًا فواصل الأسطر في نص المنشور. سيتم تجاهل فواصل الأسطر المضمّنة.
  • يمكن نشر فيديو واحد أو ما يصل إلى 35 صورة. لا يدعم TikTok مزيجًا من الفيديو والصور. يُرجى الاطلاع أدناه لمزيد من التفاصيل.
  • إذا لم ينتهِ الفيديو بامتداد معروف، فاستخدم isVideo.
  • يدعم TikTok أيضًا إرسال الوسائط دون نص المنشور. إذا كنت لا ترغب في تضمين نص المنشور أرسل سلسلة فارغة post: "".
  • راجع إرشادات وسائط TikTok وتفويض TikTok لمزيد من المعلومات.

متطلبات فيديو TikTok

  • يُرجى الاطلاع على متطلبات فيديو TikTok.
  • يجب أن ينتهي الفيديو بامتداد فيديو معروف مثل mp4. يُرجى إمّا عكس وكيل عنوان URL أو إضافة عنوان URL جميل مع CDN أو استخدام نقطة النهاية /media.
  • حدّ أحرف نص منشور TikTok هو 2,200.
يحدّ TikTok من نشر فيديو API إلى 6 فيديوهات في الدقيقة بحدّ أقصى 15 فيديو في اليوم.

منشور صورة TikTok

JSON لمنشور صورة (صورة فوتوغرافية) TikTok أساسي يُنشر مباشرة:
TikTok Image Post
مثال على استجابة JSON:
TikTok Image Post Response
  • لا يدعم TikTok حاليًا فواصل الأسطر في نص المنشور. سيتم تجاهل فواصل الأسطر المضمّنة.
  • يمكن نشر فيديو واحد أو ما يصل إلى 35 صورة.
  • لا يدعم TikTok مزيجًا من الفيديو والصور. يُرجى الاطلاع أدناه لمزيد من التفاصيل.
  • يجب أن تكون الصور من نوع JPG أو JPEG أو WEBP. لا يقبل TikTok ملفات وسائط PNG.
  • يمكنك أيضًا تحديد إحدى الصور كصورة غلاف باستخدام imageCoverIndex. افتراضيًا، يتم استخدام الصورة الأولى. يُرجى الاطلاع أدناه للتفاصيل.

متطلبات صور TikTok

  • يُرجى الاطلاع على متطلبات صور TikTok.
  • يمكن تضمين ما يصل إلى 35 صورة في منشور، بحجم 20 ميجابايت لكل صورة.
  • يجب أن تكون الصور من نوع JPG أو JPEG أو WEBP. لا يقبل TikTok ملفات وسائط PNG.
  • حدّ أحرف نص منشور TikTok هو 2,200.
يحدّ TikTok من نشر فيديو API إلى 6 صور في الدقيقة بحدّ أقصى 15 صورة في اليوم.

معالجة TikTok

يقوم TikTok بمعالجة غير متزامنة للفيديوهات والصور، لذلك ستحتوي الاستجابة على حقل id مُعيَّن إلى "pending". بعد أن يكمل TikTok المعالجة، عادة خلال 1 - 2 دقيقة، سيتم تحديث حقل id بمعرّف فيديو TikTok id وسيتم إضافة postUrl.
  • يمكنك استرداد الحالة النهائية لمنشور TikTok باستخدام webhooks أو نقطة النهاية /history وعادة ما يستغرق ذلك 1-2 دقيقة ليكون متاحًا.
  • عندما ينشر المستخدم الفيديو في تطبيق TikTok للجوّال، سيتمّ إرسال webhook “مجدول” مع subAction: "tikTokPublished".
  • يتم تأجيل التعليق الأول على منشور TikTok: يتم نشره تلقائيًا بمجرد أن يحلّ webhook tikTokPublished id الفيديو الحقيقي، وليس عند وقت النشر. يجب أن تكون visibility الفيديو public، وإلا فلن يمكن نشر التعليق الأول ويتم إرجاع خطأ تعليق.
  • في حالة حدوث خطأ، مثل عدم قدرة TikTok على معالجة الفيديو أو فشل اختبارات Ayrshare الداخلية، فسيتم تعيين حقل id إلى “failed” وسيحتوي حقل errors على تفاصيل الخطأ.
  • يُستخدم idShare للإشارة الداخلية إلى الفيديو المعلَّق.

خيارات TikTok

عند نشر فيديو أو صور TikTok، تتوفّر خيارات إضافية. مثال على نشر فيديو:
TikTok Video Publishing
مثال على نشر صورة:
TikTok Image Publishing

الخيارات

الخيارات التالية متاحة لمنشورات TikTok. يجب إضافتها إلى كائن tikTokOptions. يُرجى الاطلاع أدناه لمزيد من التفاصيل حول كل خيار.
TikTok Options
autoAddMusic
boolean
افتراضي:false
ما إذا كانت الموسيقى الموصى بها ستتم إضافتها تلقائيًا إلى المنشور. إذا قمت بتعيين هذا الحقل إلى true، فيمكنك تغيير الموسيقى لاحقًا في تطبيق TikTok.نوع الوسائط: image
disableComments
boolean
افتراضي:false
ما إذا كان سيتم تعطيل التعليقات على المنشور المنشور.نوع الوسائط: video, image
disableDuet
boolean
افتراضي:false
تعطيل duets على الفيديو المنشور.نوع الوسائط: video
disableStitch
boolean
افتراضي:false
تعطيل stitch على الفيديو المنشور.نوع الوسائط: video
draft
boolean
افتراضي:false
ما إذا كنت ستنشئ منشور مسودة.راجع خيارات المسودة لمزيد من المعلومات.نوع الوسائط: video or image
isAIGenerated
boolean
افتراضي:false
ما إذا كان سيتم تمكين تبديل المحتوى المولَّد بالذكاء الاصطناعي لمنشور الفيديو.إذا قمت بتمكين التبديل، فسيتم تصنيف الفيديو الخاص بك على أنه “Creator labeled as AI-generated” بمجرد نشره ولا يمكن تغييره. تشير علامة “Creator labeled as AI-generated” إلى أن المحتوى تم إنشاؤه بالكامل بواسطة الذكاء الاصطناعي أو تم تحريره بشكل كبير باستخدام الذكاء الاصطناعي.
لن يؤثّر تشغيل إعداد المحتوى المولَّد بالذكاء الاصطناعي على توزيع الفيديو الخاص بك طالما أنه لا ينتهك إرشادات مجتمع TikTok.
نوع الوسائط: video
isBrandedContent
boolean
افتراضي:false
ما إذا كان سيتم تمكين تبديل Branded Content. إذا تم تعيين هذا الحقل إلى true، فسيتم تصنيف الفيديو على أنه Branded Content، مما يشير إلى أنك في شراكة مدفوعة مع علامة تجارية. سيتم إرفاق علامة “Paid partnership” بالفيديو.نوع الوسائط: video, image
isBrandOrganic
boolean
افتراضي:false
ما إذا كان سيتم تمكين تبديل Brand Organic Content. إذا تم تعيين هذا الحقل إلى true، فسيتم تصنيف الفيديو على أنه Brand Organic Content، مما يشير إلى أنك تروّج لنفسك أو لأعمالك الخاصة. سيتم إرفاق علامة “Promotional content” بالفيديو.نوع الوسائط: video, image
imageCoverIndex
number
افتراضي:"0"
فهرس mediaUrls الذي سيتم استخدامه كغلاف للمنشور.نوع الوسائط: image
title
string
عنوان المنشور.نوع الوسائط: image
thumbNailOffset
number
الإطار الذي سيتم استخدامه لغلاف الفيديو.راجع خيارات الصورة المصغّرة للفيديو لمزيد من المعلومات.نوع الوسائط: video
visibility
string
افتراضي:"public"
كيف تتم مشاركة المنشور ومن يمكنه رؤيته.القيم: public أو private أو followers أو friends.راجع خيارات الرؤية لمزيد من المعلومات.نوع الوسائط: image

خيارات الرؤية

ستظل المنشورات الخاصة في حالة pending ولن يتم إرسال webhook من TikTok حتى يتمّ نشر المنشور علنيًا.

الصورة المصغّرة للفيديو

هناك طريقتان لتعيين صورة مصغّرة، تُعرف أيضًا بصورة الغلاف، لفيديو TikTok:
  1. استخدام معلمة thumbNailOffset لتعيين إطار الصورة المصغّرة.
  2. استخدام معلمة thumbNail لتعيين صورة مصغّرة من عنوان URL.
يتم دعم الفيديوهات فقط لتعيين صورة مصغّرة.

إزاحة الصورة المصغّرة

عيّن صورة مصغّرة لفيديو TikTok باختيار إطار إزاحة.
TikTok Video Thumbnail Offset
الإزاحة هي الموقع بالمللي ثانية لإطار الصورة المصغّرة. القيمة الافتراضية هي 0، وهي الإطار الأول من الفيديو.

عنوان URL للصورة المصغّرة

عيّن صورة مصغّرة لفيديو TikTok برفع صورة من عنوان URL.
TikTok Video Thumbnail URL
إذا استخدمت معلمة thumbNail، فسيتم تجاهل معلمة thumbNailOffset. يُرجى الاطلاع على متطلبات صورة TikTok المصغّرة لمزيد من المعلومات.

إشارات TikTok

اذكر مقبض TikTok آخر بإضافة @handle في نص المنشور. على سبيل المثال:
TikTok Mention
يُرجى مراجعة القواعد المهمّة بشأن الإشارات.

منشور مسودة TikTok

أنشئ منشور مسودة لفيديو أو صورة TikTok، ما يتيح لك تحرير الفيديو أو الصورة قبل النشر.
TikTok Video Draft Post
سيتم العثور على منشور مسودة الفيديو أو الصورة ضمن صندوق الوارد في الإشعارات في الصف السفلي من تطبيق TikTok. ابحث عن رسالة إشعارات النظام ثم انقر على أعلى رسالة Your content from Ayrshare is ready. سيظل postUrl الخاص بـ Ayrshare في حالة pending حتى يتم نشر الفيديو. التعليق الأول غير مدعوم في منشورات المسودة. TikTok Draft Post

تحديث التفويض

يجب إعادة تفويض TikTok كل عام عبر صفحة الحسابات الاجتماعية.
  • سيتم إرسال إشعار عبر البريد الإلكتروني وwebhook social action قبل 15 يومًا من انتهاء صلاحية التفويض.
  • يمكن استرداد تاريخ التحديث المطلوب والأيام المتبقّية من نقطة النهاية /user.

حدود الأحرف

يُرجى الاطلاع على حدود أحرف TikTok لمزيد من المعلومات.

معلومات إضافية

أمثلة إضافية على استخدام TikTok API.