त्वरित शुरुआत

बैच अनुपालन जॉब बनाएँ और चलाएँ

यह गाइड आपको पोस्ट्स या उपयोगकर्ताओं की अनुपालन स्थिति जाँचने के लिए एक बैच अनुपालन जॉब बनाने की प्रक्रिया बताती है।

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

शुरू करने से पहले, आपको इनकी आवश्यकता होगी:

• स्वीकृत ऐप के साथ एक डेवलपर खाता
• आपके ऐप का बेयरर टोकन

---

1. एक जॉब बनाएँ

   type (tweets या users) निर्दिष्ट करते हुए एक नया अनुपालन जॉब बनाएँ:

   cURL

   curl -X POST "https://api.x.com/2/compliance/jobs" \
     -H "Authorization: Bearer $BEARER_TOKEN" \
     -H "Content-Type: application/json" \
     -d '{
       "type": "tweets",
       "name": "my-compliance-job"
     }'
   

   Python

   import requests
   
   bearer_token = "YOUR_BEARER_TOKEN"
   
   url = "https://api.x.com/2/compliance/jobs"
   headers = {
       "Authorization": f"Bearer {bearer_token}",
       "Content-Type": "application/json"
   }
   payload = {
       "type": "tweets",
       "name": "my-compliance-job"
   }
   
   response = requests.post(url, headers=headers, json=payload)
   print(response.json())
   

   प्रतिक्रिया:

   {
     "data": {
       "id": "1234567890",
       "type": "tweets",
       "name": "my-compliance-job",
       "status": "created",
       "upload_url": "https://storage.googleapis.com/...",
       "download_url": "https://storage.googleapis.com/...",
       "created_at": "2024-01-15T10:00:00.000Z"
     }
   }
   

   अगले चरणों के लिए upload_url और download_url सहेज लें।

2. अपनी डेटा फ़ाइल तैयार करें

   हर पंक्ति में एक ID के साथ एक टेक्स्ट फ़ाइल बनाएँ:

   1234567890
   1234567891
   1234567892
   1234567893
   

   इसे ids.txt के रूप में सहेजें।

3. अपना डेटा अपलोड करें

   दी गई upload_url पर फ़ाइल अपलोड करें:

   curl -X PUT "UPLOAD_URL_FROM_RESPONSE" \
     -H "Content-Type: text/plain" \
     --data-binary @ids.txt
   
4. जॉब की स्थिति जाँचें

   जॉब पूरा होने तक उसकी स्थिति जाँचते रहें:

   curl "https://api.x.com/2/compliance/jobs/1234567890" \
     -H "Authorization: Bearer $BEARER_TOKEN"
   

   जॉब की स्थितियाँ:

   स्थिति	विवरण
   created	जॉब बनाई गई, अपलोड की प्रतीक्षा में
   in_progress	डेटा प्रोसेस किया जा रहा है
   complete	परिणाम डाउनलोड के लिए तैयार हैं
   failed	जॉब विफल रही
   expired	पूरा होने से पहले जॉब की समय-सीमा समाप्त हो गई

5. परिणाम डाउनलोड करें

   जब status complete हो जाए, तो download_url से डाउनलोड करें:

   curl "DOWNLOAD_URL_FROM_RESPONSE" -o results.json
   

   परिणाम का प्रारूप (प्रति पंक्ति एक JSON ऑब्जेक्ट):

   {"id": "1234567890", "action": "delete", "created_at": "2024-01-10T12:00:00.000Z", "redacted_at": "2024-01-12T08:30:00.000Z", "reason": "deleted"}
   {"id": "1234567891", "action": "delete", "created_at": "2024-01-10T12:00:00.000Z", "redacted_at": "2024-01-13T14:20:00.000Z", "reason": "suspended"}
   

   परिणामों में केवल उन्हीं ID का उल्लेख होगा जिनके लिए अनुपालन ईवेंट हैं। जो ID परिणामों में नहीं हैं, वे अब भी मान्य हैं।

---

​

अनुपालन कार्रवाइयाँ

पोस्ट अनुपालन ईवेंट

कार्रवाई	कारण	विवरण
delete	deleted	पोस्ट हटा दी गई
delete	bounced	पोस्ट अनुपालन जाँच में विफल रही
delete	protected	खाता सुरक्षित हो गया
delete	suspended	खाता निलंबित कर दिया गया
delete	scrub_geo	जियो डेटा हटा दिया गया

उपयोगकर्ता अनुपालन ईवेंट

कार्रवाई	कारण	विवरण
delete	deleted	खाता हटा दिया गया
delete	suspended	खाता निलंबित कर दिया गया
delete	protected	खाता सुरक्षित हो गया
delete	deactivated	खाता निष्क्रिय कर दिया गया

---

​

सभी जॉब्स प्राप्त करें

अपने ऐप के लिए सभी अनुपालन जॉब्स प्राप्त करें:

curl "https://api.x.com/2/compliance/jobs?type=tweets" \
  -H "Authorization: Bearer $BEARER_TOKEN"

---

​

अगले चरण

एकीकरण मार्गदर्शिका

मुख्य अवधारणाएँ और सर्वोत्तम प्रथाएँ

अनुपालन स्ट्रीम्स

रीयल-टाइम अनुपालन इवेंट

API संदर्भ

एंडपॉइंट का पूरा दस्तावेज़ीकरण