TikTok व्यवसाय API चे स्कोप्स: प्रत्येक परवानगी काय उघडते
TikTok च्या व्यवसाय API मध्ये प्रवेश दोन स्तरांवर दिला जातो. डेव्हलपर ॲपकडे TikTok Accounts अंतर्गत परवानग्या असतात, जसे Video Publish आणि Manage Account Comment, जे एंडपॉइंट उघडतात. खात्याच्या मालकाची अधिकृतता टोकनला user.insights आणि video.list सारखे स्कोप्स देते, जे परत येणारे फील्ड ठरवतात. /tt_user/token_info/get/ हा टोकनमध्ये असलेल्या स्कोप्सची यादी दाखवतो.
easyCoexistence TikTok खाते मालकाकडून त्याच्या ॲपकडे असलेल्या सर्व परवानग्या एकाच साइन-इनमध्ये मागते, जेणेकरून Claude, ChatGPT किंवा तुमचा स्वतःचा कोड त्याच्या टूल्सद्वारे प्रकाशित करू शकेल, कमेंटवर काम करू शकेल आणि इनसाइट्स वाचू शकेल.
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 संदर्भ आणि webhook मार्गदर्शक याच गटांना 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 च्या उदाहरण स्कोप स्ट्रिंगमध्ये 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 account holder authorization URL वर पाठवते, जो TikTok च्या पोर्टलने त्याच्या ॲपसाठी तयार केला आहे, आणि त्यात त्या परवानग्या आधीच नमूद आहेत. त्यात फक्त स्वतःचे state मूल्य जोडले जाते. मालक TikTok दाखवते ते मंजूर करतो, आणि TikTok परत देणारी स्कोप स्ट्रिंग कनेक्शनसोबत साठवली जाते. त्यानंतर 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 सारखी नावे ॲपच्या सेटिंग्जशी संबंधित आहेत.
get_social_credentials तुमच्या स्वतःच्या कोडला इतर Accounts API एंडपॉइंटसाठी तेच टोकन देते. प्रति कनेक्शन दरमहा 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 दिवस मोफत
- कधीही रद्द करा
- फक्त अधिकृत एपीआय
- 24/7 देखरेख
पडताळले: