הגדרות פוסט ב-TikTok דרך ה-API: פרטיות, תגובות, Duet ו-Stitch
ממשק ה-API של TikTok 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 היא false, כך שתגובות, Duets ו-Stitches נשארות פעילות אלא אם הוגדרו אחרת.
תמונת השער המותאמת הגדולה ביותר לסרטון חייבת להיות לפחות 360 x 360 פיקסלים, ועד 20 MB
התווית is_branded_content מתווספת לפוסט, והיא גוברת כשגם is_brand_organic הוא true
שדה חובה בתוך post_info של פוסט תמונה, מוגבל לאפשרויות שמחזירה הקריאה GET /business/video/settings/ לחשבון
אילו הגדרות כל נקודת הקצה לפרסום מקבלת?
/business/video/publish/ וגם /business/photo/publish/ חולקות חלק מההגדרות ושונות בחלק האחר. רובן נמצאות בתוך post_info, ואילו custom_thumbnail_url וגם photo_cover_index נמצאים ברמה העליונה של הגוף. להלן ההגדרות זו לצד זו, כפי ש-TikTok מפרטת בהפניות שלה. במקום שבו נקודה לא מתעדת הגדרה, מופיע הערך No field:
| 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מקבל רק את הערך trueduet_disabledוגםstitch_disabled: true כשהחשבון מאפשר Duet או Stitch רק ל-Only you, או כשהוא פרטי; המתג המתאים מקבל אז רק את הערך truemax_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. בנקודת הסרטון אין שדה פרטיות, כי היא מפרסמת סרטונים ציבוריים. פוסט שמוגדר ל-Friends או ל-Only you לא אפשר לצפות בו גם דרך embed_url שלו.
איך פועלות התגובות, ה-Duet וה-Stitch?
כל אחד מהם הוא מתג שמכבה את התכונה כשהוא מוגדר ל-true. disable_comment קיים בשתי הנקודות; disable_duet וגם disable_stitch קיימים בסרטונים בלבד. כל אלה מוגדרים כברירת מחדל ל-false, כלומר התכונה פעילה, במסגרת מה שההגדרות הפרטיות של החשבון מאפשרות: חשבון שמקבל תגובות מאף אחד, או שמגביל Duet או Stitch ל-Only you, יכול לפרסם רק כשהמתג מוגדר ל-true בלבד.
איך נבחר השער?
בסרטון יש שתי דרכים. post_info.thumbnail_offset בוחר פריים לפי זמנו במילישניות, 0 כברירת מחדל, ומעוגל כלפי מעלה לפריים הקרוב ביותר. אם הזמן חורג מסוף הסרטון, נשלח וובהוק (Webhook) של כישלון, והסרטון לא מתפרסם. custom_thumbnail_url, ברמה העליונה של הגוף, מביא במקומו תמונה, וTikTok מתעלמת אז מהערך של thumbnail_offset. בפוסט תמונה, photo_cover_index בוחר אחת מהתמונות, והספירה מתחילה מאפס.
- תמונת שער מותאמת בפורמטים 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, הפוסט מסומן כשיתוף פעולה בתשלום, והתווית נועדה לפוסטים שנעשים בשיתוף פעולה בתשלום עם מותג, והיא גוברת כששני הערכים פעילים. בסרטון עם is_branded_content, tto_invite_link יכול לקשר את הפוסט לקמפיין של TikTok One Creator Marketplace שהחשבון הצטרף אליו.
אילו אפשרויות נוספות יש בתוך post_info?
עוד כמה, שכל אחת מתועדת בנקודה שמקבלת אותה:
is_ai_generated, בסרטונים: מסמן את הפוסט בתווית Creator labeled as AI-generated, ואי אפשר לשנות אותה אחרי הפרסום.location_idוגםlocation_name: תג מיקום שמאתרים דרך הקריאה GET /business/publish/location/music_sound_info: צליל מסחרי לפי מזהה; בסרטונים גם עוצמתו, בין 0 ל-100, וההתחלה והסיום שלו במילישניות.auto_add_music, בפוסטי תמונות: מוסיף מוזיקה מומלצת, שאפשר לשנות אחר כך באפליקציה של TikTokupload_to_draftאוis_draft: שולח את הפוסט לתיבת הנכנסת של היוצר כטיוטה, עם הסרטון, בהרשאת video.uploadis_ads_only, בסרטונים: מפרסם פוסט מסוג Only show in ads שנשאר מחוץ לפרופיל.
אילו הגדרות קובעת publish_tiktok_post?
שלוש מגיעות מהבקשה שלכם: הכיתוב, הכותרת של פוסט תמונה, וגם disable_comment. easyCoexistence שולחת את is_brand_organic וגם את is_branded_content עם הערך false, מפרסמת פוסטים של תמונות כ-PUBLIC_TO_EVERYONE עם התמונה הראשונה כשער, ומשאירה את שאר ההגדרות של הסרטון בחוץ. על disable_duet וגם disable_stitch חל false, על thumbnail_offset חל 0, ועל is_ai_generated חל false, כך פועלת ברירת המחדל של TikTok.
איך שולחים את שאר ההגדרות?
מהקוד שלכם, עם האסימון וה-business_id של החשבון מ-get_social_credentials, בנתיבי ה-Business API תחת business/. GET ל-business/video/settings/ קורא את המגבלות של החשבון. POST ל-business/video/publish/ או ל-business/photo/publish/ יכול לשאת את הגוף המלא המתועד, והוא מגיע ל-TikTok כפי שהוא כתוב, כולל כתובות ה-URL של המדיה, ולכן הן חייבות להיות על דומיין או קידומת של כתובת ה-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 יעבוד בסרטון. נקודת הסרטון מפרסמת רק סרטונים ציבוריים ואין בה שדה כזה; פוסטי תמונות הם אלה שמקבלים אותו.
- הפעלת תגובות לחשבון שאינו מקבל תגובות כלל. כשהשדה comment_disabled שווה ל-true, TikTok מקבלת את disable_comment רק כשערכו true
- הגדרת thumbnail_offset מעבר לסוף הסרטון. נשלח וובהוק של כישלון, והסרטון לא מתפרסם.
- שליחת PUBLIC_TO_EVERYONE לחשבון פרטי. רשימת privacy_level_options שלו מציגה במקום זאת FOLLOWER_OF_CREATOR, MUTUAL_FOLLOW_FRIENDS וגם SELF_ONLY
מ-US$ 9 עד US$ 0.75 לחיבור לחודש, והמחיר יורד ככל שמוסיפים חיבורים, ועם 3 הימים הראשונים בחינם.
שאלות נפוצות
אפשר לפרסם סרטון TikTok פרטי דרך ה-API?
לא עם נקודת הסרטון, שמפרסמת רק פוסטים ציבוריים. פוסטי תמונות מקבלים את privacy_level, כולל SELF_ONLY, וסרטון יכול להישלח כטיוטה לתיבת הנכנסת של היוצר באמצעות upload_to_draft
איך מכבים את Duet ו-Stitch דרך ה-API?
מגדירים את post_info.disable_duet וגם post_info.disable_stitch ל-true בנקודה /business/video/publish/. כשהחשבון כבר מגביל אותם, TikTok מקבלת רק את הערך true
אפשר להוסיף תג מיקום דרך ה-API של TikTok?
כן. post_info מקבל location_id וגם location_name, לתג מיקום שנמצא דרך הקריאה GET /business/publish/location/
מה ההבדל בין is_brand_organic לבין is_branded_content?
is_brand_organic מוסיף תווית תוכן קידום מכירות לעסק של החשבון עצמו; is_branded_content מוסיף תווית שיתוף פעולה בתשלום, והיא גוברת כששני הערכים פעילים.
המשיכו לקרוא
מחברים את הערוץ הראשון שלכם תוך שתי דקות.
בלי לחכות לאישורים של הפלטפורמות. מחברים את WhatsApp, Instagram, TikTok או ערוץ אחר, מבקשים מה-AI לפרסם, להשיב או להפיק דוח, ורואים אותו עובד.
- 3 ימי ניסיון חינם
- ביטול בכל עת
- רק ממשקי API רשמיים
- ניטור 24/7
נבדק ב-