TikTok వ్యాపార API స్కోప్లు: ప్రతి పర్మిషన్ ఏమి అన్లాక్ చేస్తుంది
TikTok వ్యాపార API రెండు పొరల్లో యాక్సెస్ ఇస్తుంది. డెవలపర్ యాప్కు TikTok Accounts కింద పర్మిషన్లు ఉంటాయి, ఉదాహరణకు Video Publish మరియు Manage Account Comment, ఇవి ఎండ్పాయింట్లను తెరుస్తాయి. ఖాతా యజమాని ఆథరైజేషన్ యాక్సెస్ టోకెన్కు user.insights మరియు video.list వంటి స్కోప్లు ఇస్తుంది, ఇవి ఏ ఫీల్డ్లు తిరిగి వస్తాయో నిర్ణయిస్తాయి. /tt_user/token_info/get/ టోకెన్లో ఉన్న స్కోప్లను జాబితా చేస్తుంది.
easyCoexistence TikTok ఖాతా యజమాని నుండి దాని యాప్ కలిగి ఉన్న పర్మిషన్లను ఒకే సైన్-ఇన్లో అడుగుతుంది, తద్వారా Claude, ChatGPT లేదా మీ స్వంత కోడ్ దాని టూల్స్ ద్వారా పోస్ట్ చేయగలవు, కామెంట్లతో పని చేయగలవు మరియు ఇన్సైట్స్ చదవగలవు, మరియు ఇతర Accounts API ఎండ్పాయింట్ల కోసం get_social_credentials మీ స్వంత కోడ్కు అదే టోకెన్ను ఇస్తుంది.
TikTok Accounts యొక్క స్కోప్ ID, Accounts API యొక్క ప్రొఫైల్, పోస్ట్, కామెంట్ మరియు పబ్లిషింగ్ ఎండ్పాయింట్ల పైన ఉన్న మొదటి స్థాయి పర్మిషన్.
ఖాతా ప్రొఫైల్ డేటాలో is_business_account మరియు has_advanced_access వెనుక ఉన్న స్కోప్.
comment.update వెబ్హుక్ ఈవెంట్లను యాప్ అందుకోవడానికి, ఖాతా యజమాని ఇవ్వాల్సిన మరియు యాక్టివ్గా ఉంచాల్సిన స్కోప్.
పోస్ట్ను పబ్లిష్ చేయకుండా డ్రాఫ్ట్గా అప్లోడ్ చేయడానికి టోకెన్కు కావాల్సిన స్కోప్.
యాప్ పర్మిషన్ మార్పుపై TikTok డెవలపర్ సమీక్ష పట్టే పని దినాలు.
TikTok పర్మిషన్ల రెండు పొరలు ఏవి?
యాప్ పర్మిషన్లు మరియు టోకెన్ స్కోప్లు. యాప్ పర్మిషన్లు My Apps లో, యాప్, Scope of permission కింద ఎంచుకోబడతాయి, వాటిని TikTok సమీక్షిస్తుంది; ఇవి మూడు స్థాయిల్లో ఉంటాయి, మరియు మొదటి స్థాయి పర్మిషన్ దాని కింద ఉన్న ప్రతి ఎండ్పాయింట్ను కవర్ చేస్తుంది. టోకెన్ స్కోప్లు యాప్ను ఆథరైజ్ చేసేటప్పుడు ఖాతా యజమాని ఆమోదించినవి, ప్రతి టోకెన్తో scope అనే కామాలతో వేరు చేసిన ఒకే స్ట్రింగ్గా తిరిగి వస్తాయి. కాల్కు ఎండ్పాయింట్ కోసం యాప్ పర్మిషన్ అవసరం, మరియు కొన్ని ప్రతిస్పందన ఫీల్డ్లకు టోకెన్పై స్కోప్ కూడా అవసరం.
ప్రతి ఎండ్పాయింట్ను ఏ యాప్ పర్మిషన్ తెరుస్తుంది?
TikTok API రిఫరెన్స్ ప్రతి Accounts API ఎండ్పాయింట్కు, TikTok Accounts కింద దాన్ని తెరిచే పర్మిషన్ లేదా ఏదీ కాదు అని జాబితా చేస్తుంది. దాని permission scope రిఫరెన్స్ మరియు వెబ్హుక్ గైడ్ అవే గ్రూపులను Business User, Business Media, Business Comment మరియు Business Content అని పిలుస్తాయి, కాబట్టి రెండు సెట్ల పేర్లను ఆశించండి:
ఏ టోకెన్ స్కోప్లు ఏ ఫీల్డ్లను అన్లాక్ చేస్తాయి?
/business/get/ మరియు /business/video/list/ కోసం TikTok రిఫరెన్స్లు ప్రతి ప్రతిస్పందన ఫీల్డ్కు అవసరమైన పర్మిషన్ను ఇస్తాయి, మరియు మరో రెండు ఫీచర్లు తమ సొంత స్కోప్ను పేర్కొంటాయి:
- user.info.basic:
display_nameమరియుprofile_image. - user.info.username: username, ఇది జూన్ 2023 వరకు user.info.basic అవసరమైంది.
- user.info.profile:
profile_deep_link,bio_descriptionమరియుis_verified. - user.info.stats:
following_count,followers_count,total_likesమరియుvideos_count. - user.account.type:
is_business_accountమరియుhas_advanced_access. - user.insights: రోజువారీ ఖాతా మెట్రిక్స్ మరియు వయస్సు, లింగం, దేశం మరియు నగరం వారీగా ఫాలోయర్ బ్రేక్డౌన్లు.
- video.list:
item_id, caption,share_url, likes, comments, shares, reach మరియుvideo_viewsవంటి పోస్ట్ ఫీల్డ్లు. - video.insights: వాచ్ టైమ్, ఫుల్-వాచ్ రేట్, రిటెన్షన్, ట్రాఫిక్ సోర్సులు, వ్యూయర్ బ్రేక్డౌన్లు మరియు పోస్ట్ నడిపించే క్లిక్లు.
- comment.list: comment.update వెబ్హుక్, TikTok దీన్ని యాప్లోని కంటెంట్ యొక్క కామెంట్లు మరియు రిప్లైలను చదవడంగా వివరిస్తుంది.
- video.upload:
upload_to_draftలేదాis_draftతో వీడియో లేదా ఫోటో పోస్ట్ను డ్రాఫ్ట్గా అప్లోడ్ చేయడం.
టోకెన్పై స్కోప్లను ఎలా చూడాలి?
/tt_user/token_info/get/ ను అడగండి; ఇది app_id మరియు యాక్సెస్ టోకెన్ను తీసుకుని, టోకెన్ యొక్క scope మరియు ఖాతా యొక్క creator_id ను తిరిగి ఇస్తుంది. TikTok ఉదాహరణ scope స్ట్రింగ్లలో video.publish మరియు comment.list.manage కూడా ఉన్నాయి, వాటి పేర్లు పబ్లిషింగ్ మరియు కామెంట్ మేనేజ్మెంట్ ఎండ్పాయింట్లతో సరిపోతాయి, అయితే దాని రిఫరెన్స్లు ఏ ఫీల్డ్నూ వాటితో ముడిపెట్టవు.
curl -X POST 'https://business-api.tiktok.com/open_api/v1.3/tt_user/token_info/get/' \
-H 'Content-Type: application/json' \
-d '{"app_id": "<APP_ID>", "access_token": "<ACCESS_TOKEN>"}'
{
"code": 0,
"message": "OK",
"request_id": "<REQUEST_ID>",
"data": {
"app_id": "<APP_ID>",
"creator_id": "<OPEN_ID>",
"scope": "video.publish,user.info.basic,video.list,user.insights,comment.list.manage,video.insights,comment.list"
}
}easyCoexistence యొక్క TikTok కనెక్షన్ ఏమి అడుగుతుంది?
దాని డెవలపర్ యాప్ కలిగి ఉన్న అన్ని పర్మిషన్లు, అవన్నీ TikTok యొక్క సమ్మతి పేజీలో చూపబడతాయి. easyCoexistence ఖాతా యజమానిని TikTok పోర్టల్ తన యాప్ కోసం రూపొందించిన TikTok ఖాతాదారు ఆథరైజేషన్ URL కు పంపుతుంది, అది ఇప్పటికే ఆ పర్మిషన్లను పేర్కొంటుంది, మరియు దాని స్వంత state విలువను మాత్రమే జోడిస్తుంది. యజమాని TikTok చూపేదాన్ని ఆమోదిస్తారు, మరియు TikTok తిరిగి ఇచ్చే scope స్ట్రింగ్ కనెక్షన్తో పాటు భద్రపరచబడుతుంది. easyCoexistence ఆ ఖాతా కోసం తర్వాత కాల్ చేసే ఎండ్పాయింట్లు:
- /business/get/: ప్రొఫైల్, రోజువారీ మెట్రిక్స్ మరియు ఫాలోయర్ బ్రేక్డౌన్ల కోసం.
- /business/video/list/: పోస్ట్లు మరియు వాటి మెట్రిక్స్ కోసం.
- /business/video/publish/, /business/photo/publish/ మరియు /business/publish/status/: పబ్లిషింగ్ కోసం.
- /business/comment/list/, /business/comment/reply/create/, /business/comment/hide/ మరియు /business/comment/delete/: కామెంట్ల కోసం.
- /business/webhook/update/, యాప్ స్థాయిలో, కామెంట్ వెబ్హుక్ కోసం.
తర్వాత పర్మిషన్ ఎలా జోడించాలి?
రెండు దశల్లో, ప్రతి పొరకు ఒకటి. యాప్ కోసం, My Apps, యాప్, Scope of permission తెరిచి, దాన్ని ఎడిట్ చేయండి, కొత్త స్కోప్లకు సరిపోయే కారణం ఇచ్చి సమర్పించండి; TikTok సమీక్షకు రెండు నుండి మూడు పని దినాలు పట్టవచ్చు, మరియు మార్చి 20, 2026 నుండి TikTok Accounts ఉన్న అభ్యర్థనకు ముందుగా Accounts API Access Application Form అవసరం. టోకెన్ కోసం, ఖాతా యజమాని యాప్ను మళ్లీ ఆథరైజ్ చేయాలి, ఎందుకంటే టోకెన్ జారీ చేసినప్పుడు ఆమోదించిన స్కోప్లనే ఉంచుతుంది.
పర్మిషన్ లేనప్పుడు ఏమి జరుగుతుంది?
ఒక కాల్ కోసం, TikTok రిటర్న్ కోడ్ 40001, సంబంధిత ఆపరేషన్ చేయడానికి పర్మిషన్ లేదు, మరియు దాని పరిష్కారం permission scope రిఫరెన్స్ను సూచిస్తుంది. ఒక ఫీల్డ్ కోసం, ఖాతా యజమాని దాని స్కోప్ను ఇచ్చిన తర్వాతే రిఫరెన్స్లు దాన్ని అందుబాటులో ఉంచుతాయి, మరియు వాటి పరిష్కారం ఆ స్కోప్తో యజమాని యాప్ను మళ్లీ ఆథరైజ్ చేయడమే. అడగడానికి ముందు /tt_user/token_info/get/ తో టోకెన్ స్కోప్ను తనిఖీ చేయండి.
సాధారణ పొరపాట్లు
- కనెక్ట్ చేసిన ఖాతాలకు స్వయంగా కొత్త యాప్ పర్మిషన్ వస్తుందని ఆశించడం. ప్రతి యజమాని యాప్ను మళ్లీ ఆథరైజ్ చేసే వరకు వాటి టోకెన్లు ఆథరైజేషన్ సమయంలో ఆమోదించిన స్కోప్లనే ఉంచుతాయి.
- user.account.type లేకుండా is_business_account ను అభ్యర్థించడం. TikTok ఆ ఫీల్డ్ను మరియు has_advanced_access ను ఆ స్కోప్ ఉన్న టోకెన్లకే అందుబాటులో ఉంచుతుంది.
- comment.list లేకుండా comment.update కోసం ఎదురుచూడటం. యజమాని ఆ స్కోప్తో ఆథరైజేషన్ చెల్లుబాటులో ఉన్నంతవరకే TikTok కామెంట్ ఈవెంట్లను పంపుతుంది.
- టోకెన్లో యాప్ పర్మిషన్ పేర్ల కోసం వెతకడం. స్కోప్ స్ట్రింగ్ video.list వంటి పేర్లను ఉపయోగిస్తుంది, అయితే Get Account Media వంటి పేర్లు యాప్ సెట్టింగ్లకు చెందుతాయి.
ప్రతి కనెక్షన్కు నెలకు US$ 9 నుండి US$ 0.75 వరకు, మీరు కనెక్షన్లను జోడించినప్పుడు తగ్గుతుంది, మొదటి 3 రోజులు ఉచితం.
తరచుగా అడిగే ప్రశ్నలు
TikTok వ్యాపార API ఏ స్కోప్లను ఉపయోగిస్తుంది?
user.info.basic, user.info.stats, user.insights, video.list, video.insights, comment.list మరియు video.upload వంటి టోకెన్ స్కోప్లు, ఖాతా యజమాని యాప్ యొక్క TikTok Accounts పర్మిషన్లకు అదనంగా ఇస్తారు.
TikTok కామెంట్ వెబ్హుక్కు ఏ పర్మిషన్లు కావాలి?
యాప్కు TikTok Accounts మరియు Business Comment కావాలి, మరియు ఖాతా యజమాని comment.list ఇవ్వాలి. ఆ ఆథరైజేషన్ గడువు ముగిసినా లేదా రద్దు అయినా ఈవెంట్లు ఆగిపోతాయి.
కొత్త TikTok స్కోప్ ఇప్పటికే జారీ అయిన టోకెన్లకు వర్తిస్తుందా?
లేదు. టోకెన్ జారీ చేసినప్పుడు ఆమోదించిన స్కోప్లనే ఉంచుతుంది, కాబట్టి కొత్తది జోడించడానికి ఖాతా యజమాని యాప్ను మళ్లీ ఆథరైజ్ చేయాలి.
కొత్త పర్మిషన్ను ఆమోదించడానికి TikTok ఎంత సమయం తీసుకుంటుంది?
పర్మిషన్ మార్పు సమీక్షకు రెండు నుండి మూడు పని దినాలు పట్టవచ్చని TikTok చెబుతోంది, మరియు TikTok Accounts ను ముందుగా జోడించే అభ్యర్థనలకు Accounts API Access Application Form అవసరం.
చదవడం కొనసాగించండి
మీ మొదటి ఛానెల్ను రెండు నిమిషాల్లో కనెక్ట్ చేయండి.
ప్లాట్ఫామ్ సమీక్షల కోసం ఎదురుచూడాల్సిన అవసరం లేదు. WhatsApp, Instagram, TikTok లేదా మరో ఛానెల్ను కనెక్ట్ చేయండి, ఆపై పోస్ట్ చేయమని, ప్రత్యుత్తరం ఇవ్వమని లేదా రిపోర్ట్ ఇవ్వమని మీ AIకి చెప్పండి, అది పని చేయడం చూడండి.
- 3 రోజులు ఉచితం
- ఎప్పుడైనా రద్దు చేయండి
- అధికారిక APIలు మాత్రమే
- 24/7 పర్యవేక్షణ
ధృవీకరించిన తేదీ