मुख्य सामग्री पर जाएं

​
परिचय

हालाँकि recent search endpoint आपको केवल पिछले 7 दिनों में प्रकाशित पोस्ट्स प्राप्त करने की अनुमति देता है, user Post timeline और उपयोगकर्ता मेंशन टाइमलाइन endpoints आपको किसी अधिकृत उपयोगकर्ता (user ID का उपयोग करके) के लिए पिछले 7 दिनों से पुराने पोस्ट्स और मेंशन्स प्राप्त करने की अनुमति देते हैं। डेवलपर्स इन endpoints का उपयोग किसी उपयोगकर्ता की टाइमलाइन या मेंशन्स से पोस्ट्स के विषयों, इकाइयों और भावनात्मक रुझान का अध्ययन करने के लिए कर सकते हैं। इस ट्यूटोरियल में, हम आपको दिखाएँगे कि उपयोगकर्ता Tweet टाइमलाइन और उपयोगकर्ता मेंशन टाइमलाइन endpoints का उपयोग करके किसी उपयोगकर्ता के पोस्ट्स और मेंशन्स को कैसे एक्सप्लोर करें।  

​
पूर्वापेक्षाएँ

  • उपयोगकर्ता Tweet टाइमलाइन और उपयोगकर्ता मेंशन टाइमलाइन एंडपॉइंट का उपयोग करने के लिए, आपके पास एक मान्य डेवलपर खाता होना चाहिए। 
  • आपके पास एक Project भी बना हुआ होना चाहिए।
  • आपको डेवलपर खाते के लिए साइन अप करना होगा और नया डेवलपर कंसोल अनुभव सक्रिय करना होगा। 
  • उस डेवलपर ऐप के लिए सक्रिय कीज़ और टोकन के साथ एक्सेस उपलब्ध है, जो डेवलपर कंसोल में बनाए गए Project से जुड़ा हुआ है।
  • X डेवलपर कंसोल में आपके ऐप का एक बेयरर टोकन।
  • यदि आपके पास स्वीकृत डेवलपर खाता नहीं है, तो आप इसके लिए आवेदन कर सकते हैं।

​
स्वीकृत डेवलपर खाता

यदि आपके पास अभी तक स्वीकृत डेवलपर खाता नहीं है, तो आप इसके लिए आवेदन कर सकते हैं.

​
एक Project बनाएँ और एक ऐप कनेक्ट करें

डेवलपर कंसोल में, create a new App पर क्लिक करें।
इसे एक नाम दें, उपयुक्त use case चुनें, और Project का विवरण दर्ज करें। इसके बाद, आप या तो एक नया ऐप बना सकते हैं, या किसी मौजूदा ऐप को कनेक्ट कर सकते हैं (ऐप आपकी API keys के लिए एक कंटेनर है, जिनकी आपको X API में HTTP अनुरोध करने के लिए आवश्यकता होती है)।
नया ऐप बनाने के लिए ‘create a new App instead’ पर क्लिक करें और अपने ऐप को एक नाम दें।
complete पर क्लिक करने के बाद, आपको अपनी API keys और बेयरर टोकन मिल जाएगा, जिनका उपयोग आप फिर X API v2 के नए endpoints से कनेक्ट करने के लिए कर सकते हैं।
API key, API secret key और Bearer token के बगल में (+) पर क्लिक करें और इन मानों को अपनी local machine पर किसी सुरक्षित स्थान पर कॉपी कर लें। अगले चरण में API calls करने के लिए आपको इनकी आवश्यकता होगी। Note: ऊपर दिए गए screenshot में keys छिपाई गई हैं, लेकिन अपने डेवलपर कंसोल में आप API key, API secret key और Bearer token के वास्तविक मान देख पाएँगे।  

​
उपयोगकर्ता Tweet टाइमलाइन और उपयोगकर्ता मेंशन टाइमलाइन endpoints में उपयोग के लिए किसी उपयोगकर्ता की user ID कैसे प्राप्त करें

उपयोगकर्ता Tweet टाइमलाइन और उपयोगकर्ता मेंशन टाइमलाइन endpoints आपको user ID का उपयोग करके पोस्ट्स प्राप्त करने देते हैं। किसी username से user ID प्राप्त करने के लिए, आप नए user lookup endpoint v2 का उपयोग कर सकते हैं। USER_NAME को अपनी पसंद के username से और XXXX को अपने उस बेयरर टोकन से बदलें, जो आपने ऊपर प्राप्त किया था 
  curl --request GET 'https://api.x.com/2/users/by/username/USER_NAME --header 'Authorization: Bearer XXXXXX'
जैसा कि नीचे दिखाया गया है, आपको response में उपयोगकर्ता id दिखाई देगी: 
{
   "data": {
       "id": "2244994945",
       "name": "Developers",
       "username": "XDevelopers"
   }
}

​
उपयोगकर्ता Tweet टाइमलाइन और उपयोगकर्ता मेंशन टाइमलाइन endpoint से कनेक्ट करना

किसी उपयोगकर्ता की उपयोगकर्ता Tweet टाइमलाइन प्राप्त करने के लिए, अपने टर्मिनल में नीचे दिया गया curl कमांड चलाएँ (ध्यान रखें कि USER_ID को अपनी पसंद के उपयोगकर्ता id से और XXXX को अपने बेयरर टोकन से बदल दें, जो आपने ऊपर प्राप्त किया था) 
curl --request GET 'https://api.x.com/2/users/USER_ID/tweets' --header 'Authorization: Bearer XXXXXX'
आप देखेंगे कि इन अनुरोधों के लिए JSON response में डिफ़ॉल्ट रूप से पोस्ट्स की ID और text शामिल होते हैं (नीचे उदाहरण देखें)। 
{
   "id": "1334200897081987072",
   "text": "👀 If you are new to the X API v2, check out this step-by-step guide to making your first request https://t.co/4rZqThpSbp"
}
यदि आप चाहते हैं कि रिस्पॉन्स के हिस्से के रूप में अतिरिक्त फ़ील्ड्स लौटाए जाएँ (जैसे उपयोगकर्ता की जानकारी, context annotations जैसे अतिरिक्त Tweet फ़ील्ड्स आदि), तो आपको उन फ़ील्ड्स को अपने रिस्पॉन्स में स्पष्ट रूप से निर्दिष्ट करना होगा। यह कैसे करना है, यह जानने के लिए फ़ील्ड्स और expansions के उपयोग पर मार्गदर्शिका देखें। आप अपनी पसंद की प्रोग्रामिंग भाषाओं का उपयोग करके भी ये पोस्ट्स प्राप्त कर सकते हैं। user Tweet timeline और user mention timeline endpoints के लिए Python, Node (JavaScript), Java और Ruby में हमारा सैंपल कोड हमारे GitHub repository पर देखें।

​
उपयोगकर्ता की पोस्ट्स की पड़ताल

एक बार जब आप उपयोगकर्ता Tweet टाइमलाइन और उपयोगकर्ता मेंशन टाइमलाइन endpoints का उपयोग करके पोस्ट्स प्राप्त करना सीख लेते हैं, तो आप उनकी पोस्ट्स की पड़ताल शुरू कर सकते हैं। उदाहरण के लिए, अगर आप किसी उपयोगकर्ता के mentions में मौजूद आम named entities की पहचान करना चाहते हैं, तो आप निम्न कार्य कर सकते हैं: API अनुरोध में, यह निर्दिष्ट करें कि Tweet responses में context_annotations object लौटाया जाए: 
curl --request GET 'https://api.x.com/2/users/USER_ID/mentions?tweet.fields=context_annotations' --header 'Authorization: Bearer XXXXXX'
रिस्पॉन्स में, आप देखेंगे कि mentions में कोई नामित एंटिटी मौजूद हैं या नहीं। यहाँ एक उदाहरण दिया गया है: 
{
   "domain": {
       "id": "47",
       "name": "Brand",
       "description": "Brands and Companies"
   },
   "entity": {
       "id": "783214",
       "name": "X"
   }
}
यदि आप यह देखना चाहते हैं कि आपके मेंशन्स में कौन-सी लोकप्रिय इकाइयाँ दिखाई देती हैं, तो आप मेंशन्स में मौजूद प्रत्येक Tweet को पार्स करके लोकप्रिय इकाइयों की गिनती रख सकते हैं। यदि आप अपनी टाइमलाइन में मीडिया वाली सभी पोस्ट्स के लिए preview image URL देखना चाहते हैं, तो आप निम्न कार्य कर सकते हैं: API अनुरोध में, यह निर्दिष्ट करें कि आपको tweet.media फ़ील्ड्स में preview_image_url और attachments.media_keys expansions चाहिए 
curl --request GET 'https://api.x.com/2/users/2244994945/mentions?max_results=100&media.fields=preview_image_url&expansions=attachments.media_keys' --header 'Authorization: Bearer XXXXXX'
रिस्पॉन्स में, जैसा कि नीचे दिखाया गया है, आपको includes ऑब्जेक्ट में preview_image_url दिखाई देगा: 
{
   "includes": {
       "media": [
           {
               "media_key": "16_1334657439640121344",
               "preview_image_url": "https://pbs.twimg.com/tweet_video_thumb/EoWn3rqU8AAtFWL.jpg",
               "type": "animated_gif"
           }
       ]
   }
}
जब आप यह समझ लेते हैं कि किसी उपयोगकर्ता के पोस्ट्स में कैसे नेविगेट करना है, तो पोस्ट्स के साथ और भी काम करने के लिए आप अन्य APIs और सेवाओं का भी उपयोग कर सकते हैं। नीचे कुछ संसाधन दिए गए हैं, जिन्हें उपयोगकर्ता Tweet टाइमलाइन और उपयोगकर्ता मेंशन टाइमलाइन endpoints का उपयोग करते समय अपने पास रखना उपयोगी रहेगा।

​
संसाधन