إعدادات منشورات TikTok عبر API: الخصوصية والتعليقات وDuet وStitch
تأخذ TikTok API for Business إعدادات المنشور في استدعاء النشر، وأغلبها داخل post_info. تقبل الفيديوهات disable_comment وdisable_duet وdisable_stitch، وغلافًا من thumbnail_offset أو custom_thumbnail_url، ووسمَي is_brand_organic وis_branded_content، وis_ai_generated. وتقبل منشورات الصور privacy_level وdisable_comment والوسمين نفسيهما وauto_add_music. ويعيد GET /business/video/settings/ القيم التي يسمح بها كل حساب.
ينشر easyCoexistence فيديوهات TikTok ومنشورات الصور عبر publish_tiktok_post من Claude أو ChatGPT أو من شيفرتك، مع النص المرفق وعنوان منشور الصورة وتفعيل التعليقات أو إيقافها، ويمنح get_social_credentials شيفرتك الرمز لقراءة الإعدادات المسموح بها للحساب.
خيارات الخصوصية لمنشورات الصور في الحساب العام: PUBLIC_TO_EVERYONE وMUTUAL_FOLLOW_FRIENDS وSELF_ONLY.
مستوى الخصوصية الذي يحصل عليه الحساب الخاص بدلًا من PUBLIC_TO_EVERYONE: مرئي لمتابعيه فقط.
القيمة الافتراضية لـ disable_comment وdisable_duet وdisable_stitch، فتبقى التعليقات وDuet وStitch مفعّلة ما لم تُضبط.
أكبر صورة غلاف مخصصة للفيديو، ويجب أن تكون بحجم لا يقل عن 360 x 360 بكسل ولا يتجاوز 20 MB.
الوسم الذي يضيفه is_branded_content، وهو يتقدم عندما يكون is_brand_organic صحيحًا أيضًا.
حقل إلزامي في post_info لمنشور الصورة، ومقصور على الخيارات التي تعيدها GET /business/video/settings/ للحساب.
ما الإعدادات التي تقبلها كل نقطة نهاية (endpoint) للنشر؟
تتشارك /business/video/publish/ و/business/photo/publish/ في بعض الإعدادات وتختلف في أخرى. أغلبها داخل post_info، بينما يقع custom_thumbnail_url وphoto_cover_index في المستوى الأعلى من الجسم. وفيما يلي الإعدادات جنبًا إلى جنب كما تدرجها مراجع TikTok، مع كتابة «لا يوجد حقل» حيث لا توثق endpoint أي حقل لذلك الإعداد:
| Video post | Photo post | |
|---|---|---|
| Who sees it | No privacy field: the endpoint publishes public video posts | privacy_level, required |
| Comments | disable_comment | disable_comment |
| Duet and Stitch | disable_duet, disable_stitch | No field |
| Cover | custom_thumbnail_url or thumbnail_offset | photo_cover_index |
| Brand labels | is_brand_organic, is_branded_content | is_brand_organic, is_branded_content |
| AI label | is_ai_generated | No field |
| Music | music_sound_info, video_original_sound_volume | auto_add_music, music_sound_info |
| Location | location_id with location_name | location_id with location_name |
| Draft | upload_to_draft | is_draft |
ما الذي يسمح به الحساب؟
يعيد GET /business/video/settings/ مع business_id حدود الحساب على منشوراته. اقرأه قبل النشر، لأن TikTok لا تقبل إلا القيم التي يسردها:
privacy_level_options:PUBLIC_TO_EVERYONEوMUTUAL_FOLLOW_FRIENDSوSELF_ONLYلحساب عام، وFOLLOWER_OF_CREATORوMUTUAL_FOLLOW_FRIENDSوSELF_ONLYلحساب خاص.comment_disabled: تكون القيمة true عندما لا يقبل الحساب تعليقات من أحد، وحينها لا يقبلdisable_commentسوى true.duet_disabledوstitch_disabled: تكون القيمة true عندما يسمح الحساب بـ Duet أو Stitch لصاحبه فقط، أو عندما يكون الحساب خاصًا، ويقبل المفتاح المقابل حينها القيمة true وحدها.max_video_post_duration_sec: أطول مدة فيديو يستطيع الحساب نشرها، والأطول منها يفشل.
curl -G 'https://business-api.tiktok.com/open_api/v1.3/business/video/settings/' \
-H 'Access-Token: <ACCESS_TOKEN>' \
--data-urlencode 'business_id=<OPEN_ID>'
{
"code": 0,
"message": "OK",
"request_id": "<REQUEST_ID>",
"data": {
"comment_disabled": false,
"duet_disabled": false,
"max_video_post_duration_sec": 600,
"privacy_level_options": ["PUBLIC_TO_EVERYONE", "MUTUAL_FOLLOW_FRIENDS", "SELF_ONLY"],
"stitch_disabled": false
}
}من يستطيع رؤية المنشور؟
في منشور الصورة، تحدده privacy_level التي ترسلها: PUBLIC_TO_EVERYONE للجمهور داخل TikTok وخارجه، وMUTUAL_FOLLOW_FRIENDS للمتابعين الذين يتابعهم الحساب بالمثل، وFOLLOWER_OF_CREATOR لمتابعي الحساب الخاص، أو SELF_ONLY. لا يحتوي endpoint الفيديو على حقل للخصوصية لأنه ينشر منشورات فيديو عامة. ولا يمكن مشاهدة المنشور المضبوط على «الأصدقاء» أو«أنت فقط» عبر embed_url الخاص به أيضًا.
كيف تعمل التعليقات وDuet وStitch؟
كل منها مفتاح يوقف الميزة عند ضبطه على true. يوجد disable_comment في الفيديو ومنشور الصورة، بينما يوجد disable_duet وdisable_stitch في الفيديوهات فقط. وتكون جميعها false افتراضيًا، فتبقى الميزة مفعّلة ضمن ما تسمح به إعدادات الخصوصية الخاصة بالحساب. فالحساب الذي لا يقبل تعليقات من أحد، أو الذي يحصر Duet أو Stitch في «أنت فقط»، لا يستطيع النشر إلا مع ضبط المفتاح على true.
كيف يُختار الغلاف؟
في الفيديو طريقتان. يختار post_info.thumbnail_offset إطارًا بحسب وقته بالمللي ثانية، والقيمة الافتراضية 0، ويُقرَّب إلى أقرب إطار؛ والوقت الذي يتجاوز نهاية الفيديو يرسل خطاف الويب (webhook) للفشل ولا يُنشر الفيديو. أما custom_thumbnail_url، في المستوى الأعلى من الجسم، فيعطي صورة بدلًا من ذلك ويجعل TikTok يتجاهل الإزاحة. وفي منشور الصورة يختار photo_cover_index إحدى الصور، بدءًا من 0.
- صورة الغلاف المخصصة: بصيغة JPG أو JPEG أو WebP أو PNG، وبحجم يصل إلى 20 MB.
- الأبعاد: من 360 x 360 بكسل حتى 1080 x 1920، أو 1920 x 1080.
- الموقع: نطاق أو بادئة URL موثّقة للتطبيق، مثل الفيديو نفسه.
ماذا تعني وسوم العلامة التجارية؟
إفصاحات يعرضها TikTok على المنشور. عندما تكون is_brand_organic بقيمة true يُوسم المنشور بـ«محتوى ترويجي»، وذلك للمنشورات التي تروّج لنشاط الحساب التجاري الخاص. وعندما تكون is_branded_content بقيمة true يُوسم بـ«شراكة مدفوعة»، للمنشورات المنجزة في شراكة مدفوعة مع علامة تجارية، ويتقدم على الوسم الأول إذا كانت القيمتان true معًا. وفي الفيديو الذي يحمل is_branded_content يمكن أن يربط tto_invite_link المنشور بحملة انضم إليها الحساب في TikTok One Creator Marketplace.
ما الخيارات الأخرى الموجودة في post_info؟
خيارات أخرى، يوثّق كل منها endpoint الذي يقبلها:
is_ai_generated، للفيديوهات: يضع على المنشور وسم «مُولَّد بالذكاء الاصطناعي بوسم من المبدع»، ولا يمكن تغييره بعد النشر.location_idمعlocation_name: وسم موقع يُعثر عليه عبر GET /business/publish/location/.music_sound_info: صوت تجاري بمعرّفه، وفي الفيديوهات يضاف إليه مستواه بين 0 و100، وبداية الصوت ونهايته بالمللي ثانية.auto_add_music، لمنشورات الصور: يضيف موسيقى مقترحة يمكن تغييرها لاحقًا في تطبيق TikTok.upload_to_draftأوis_draft: يرسل المنشور إلى صندوق وارد المبدع كمسودة مع الفيديو، ويتطلب نطاق video.upload.is_ads_only، للفيديوهات: ينشر منشورًا «يُعرض في الإعلانات فقط» ويبقى خارج الملف الشخصي.
ما الإعدادات التي يضبطها publish_tiktok_post؟
ثلاثة منها تأتي من طلبك: النص المرفق، وعنوان منشور الصورة، والقيمة disable_comment. يرسل easyCoexistence القيمة false لكل من is_brand_organic وis_branded_content، وينشر منشورات الصور بمستوى PUBLIC_TO_EVERYONE مع أول صورة غلافًا، ويترك بقية إعدادات الفيديو خارج الطلب، فتُطبَّق افتراضات TikTok: disable_duet وdisable_stitch بقيمة false، وthumbnail_offset بقيمة 0، وis_ai_generated بقيمة false.
كيف ترسل الإعدادات الأخرى؟
من كودك الخاص، برمز الحساب وbusiness_id من get_social_credentials، على مسارات Business API تحت business/. يقرأ طلب GET إلى business/video/settings/ حدود الحساب. ويمكن لطلب POST إلى business/video/publish/ أو business/photo/publish/ أن يحمل الجسم الموثّق كاملًا، فيصل إلى TikTok كما هو مكتوب بما فيه روابط الوسائط، لذلك يجب أن تكون على نطاق أو بادئة URL موثّقة للتطبيق. أما publish_tiktok_post فهو الاستدعاء الذي يمرر رابطك عبر مسار الوسائط الموثّق في easyCoexistence.
GET https://business-api.tiktok.com/open_api/v1.3/business/video/settings/?business_id=<BUSINESS_ID>
Access-Token: <ACCESS_TOKEN>الأخطاء الشائعة
- توقّع أن يعمل privacy_level على الفيديو. ينشر endpoint الفيديو منشورات عامة ولا تذكر مراجعه أي حقل للخصوصية، بينما تقبل منشورات الصور privacy_level.
- تفعيل التعليقات لحساب لا يقبل أي تعليق. عندما تكون comment_disabled بقيمة true، لا تقبل TikTok من disable_comment إلا القيمة true.
- ضبط thumbnail_offset بعد نهاية الفيديو. ترسل TikTok webhook للفشل ولا يُنشر الفيديو.
- إرسال PUBLIC_TO_EVERYONE لحساب خاص. تسرد privacy_level_options بدلًا منه: FOLLOWER_OF_CREATOR وMUTUAL_FOLLOW_FRIENDS وSELF_ONLY.
من US$ 9 إلى US$ 0.75 لكل اتصال شهريًا، ويقل السعر كلما أضفت اتصالات، مع فترة تجريبية مجانية مدتها 3 أيام.
الأسئلة الشائعة
هل يمكنني نشر فيديو TikTok خاص عبر API؟
لا، مع endpoint الفيديو الذي ينشر منشورات عامة. تقبل منشورات الصور privacy_level، بما فيها SELF_ONLY، ويمكن إرسال الفيديو إلى صندوق وارد المبدع كمسودة باستخدام upload_to_draft.
كيف أوقف ميزتي Duet وStitch عبر API؟
اضبط post_info.disable_duet وpost_info.disable_stitch على true في /business/video/publish/. وإذا كان الحساب يحصرهما أصلًا، فلا تقبل TikTok سوى القيمة true.
هل يمكنني إضافة وسم موقع عبر TikTok API؟
نعم. يقبل post_info الحقل location_id مع location_name، لوسم موقع يُعثر عليه عبر GET /business/publish/location/.
ما الفرق بين is_brand_organic وis_branded_content؟
يضيف is_brand_organic وسم «محتوى ترويجي» لنشاط الحساب التجاري الخاص، ويضيف is_branded_content وسم «شراكة مدفوعة» ويتقدم عليه عندما تكون القيمتان true معًا.
تابع القراءة
اربط قناتك الأولى في دقيقتين.
لا حاجة لانتظار مراجعات المنصات. اربط WhatsApp أو Instagram أو TikTok أو أي قناة أخرى، ثم اطلب من الذكاء الاصطناعي النشر أو الرد أو إعداد التقارير، وشاهده يعمل.
- 3 أيام مجانًا
- إلغاء في أي وقت
- واجهات API الرسمية فقط
- مراقبة على مدار الساعة 24/7
تم التحقق في