शॉर्ट लिंक का बल्क इम्पोर्ट और एक्सपोर्ट

जब आपके पास छोटे करने के लिए दसियों या हज़ारों URL हों, तो हर लिंक हाथ से बनाने के बजाय उन्हें एक CSV फ़ाइल में अपलोड करें। हर पंक्ति एक सामान्य शॉर्ट लिंक बन जाती है जिसे आप किसी भी दूसरे लिंक की तरह संपादित, साझा और ट्रैक कर सकते हैं।

टिप्पणी

बल्क निर्माण आपके प्लान पर निर्भर करता है। हर बनी पंक्ति की लागत उसे हाथ से बनाने जितनी ही है, और इम्पोर्ट या एक्सपोर्ट करने पर कोई अतिरिक्त लागत नहीं लगती। विवरण के लिए क्रेडिट पेज देखें। फ़ीचर क्रेडिट

CSV फ़ाइल से शॉर्ट लिंक इम्पोर्ट करें

1. डैशबोर्ड में URL शॉर्टनर खोलें और बल्क इम्पोर्ट चुनें।

2. CSV टेम्पलेट डाउनलोड करें, हर लिंक के लिए एक पंक्ति भरें और उसे CSV के रूप में सहेजें।

3. फ़ाइल अपलोड करें और वे डिफ़ॉल्ट चुनें जो खाली कॉलम वाली पंक्तियों पर लागू होंगे, जैसे टेम्पलेट या टैग।

4. फ़ाइल जाँचें। Posty5 कुछ भी बनाए बिना हर पंक्ति पढ़ता है और उन पंक्तियों की सूची दिखाता है जो विफल होंगी।

5. इम्पोर्ट शुरू करें। आप पेज छोड़ सकते हैं, और पूरा होने पर एक सूचना आपको बताएगी।

फ़ाइल के कॉलम

केवल url कॉलम ज़रूरी है। कॉलम के नाम केस-संवेदी नहीं हैं, और जिस कॉलम को Posty5 नहीं पहचानता उसे अनदेखा किया जाता है और जाँच चरण में बताया जाता है।

Column
url	गंतव्य पता। ज़रूरी। baseUrl को भी इसके दूसरे नाम के रूप में स्वीकार किया जाता है।
name	आपकी अपनी सूची के लिए एक नाम। खाली छोड़ने पर Posty5 बैकग्राउंड में पेज के शीर्षक से इसे भर देता है।
customId	शॉर्ट लिंक का आपका अपना अंत, जब आपका प्लान कस्टम ID की अनुमति देता हो। यह अप्रयुक्त होना चाहिए, उसी फ़ाइल की किसी पिछली पंक्ति द्वारा भी नहीं।
tag	बाद में लिंक को समूहित और फ़िल्टर करने के लिए एक टैग।
refId	आपका अपना संदर्भ, जैसे आपके सिस्टम का कोई उत्पाद कोड।
templateId	इस पंक्ति का QR कोड टेम्पलेट। यह आपके चुने हुए डिफ़ॉल्ट को बदल देता है।

url,name,customId,tag,refId,templateId
https://example.com/spring-sale,Spring sale,,spring,,

फ़ाइल को कॉमा और हेडर पंक्ति के साथ UTF-8 CSV के रूप में सहेजें। जिन मानों में कॉमा हो वे दोहरे उद्धरण चिह्नों में जाते हैं, जैसा स्प्रेडशीट ऐप अपने आप करते हैं।

फ़ाइल की जाँच

जाँच वही नियम चलाती है जो हाथ से लिंक बनाने पर लागू होते हैं, और हर विफल पंक्ति को उसकी पंक्ति संख्या के साथ दिखाती है, जो हेडर के नीचे की पहली पंक्ति से गिनी जाती है। कोई पंक्ति तब विफल होती है जब

• URL गायब है, मान्य वेब पता नहीं है, या 2,048 अक्षरों से लंबा है
• URL असुरक्षित होने के कारण ब्लॉक है
• नाम, टैग या संदर्भ 255 अक्षरों से लंबा है
• कस्टम ID आपके प्लान में अनुमत नहीं है, अमान्य है, या पहले से उपयोग में है
• टेम्पलेट मौजूद नहीं है या आपका नहीं है

सीमाएँ

• एक फ़ाइल में अधिकतम 5,000 पंक्तियाँ और 2 MB हो सकते हैं।
• आप प्रतिदिन (UTC) बल्क में अधिकतम 20,000 पंक्तियाँ बना सकते हैं, जिसमें हर इम्पोर्ट और API कॉल एक साथ गिने जाते हैं।
• एक समय में एक इम्पोर्ट चलता है, और अधिकतम तीन और उसकी प्रतीक्षा कर सकते हैं।
• अगर इम्पोर्ट के दौरान आपके क्रेडिट खत्म हो जाते हैं, तो वह पंक्ति और उसके बाद की हर पंक्ति “पर्याप्त क्रेडिट नहीं हैं” त्रुटि के साथ विफल होती है, और पहले से बने लिंक बने रहते हैं।

प्रगति

इम्पोर्ट पेज दिखाता है कि कितनी पंक्तियाँ प्रोसेस हुईं, बनीं और विफल हुईं, और अपने आप रिफ़्रेश होता है। आप चल रहे इम्पोर्ट को रद्द कर सकते हैं; रद्द करने से पहले बने लिंक बने रहते हैं।

हर लिंक बनने के बाद पेज शीर्षक और ऐप डीप लिंक बैकग्राउंड में लाए जाते हैं, इसलिए कुछ देर तक कोई लिंक अपने होस्ट को नाम के रूप में दिखा सकता है।

नतीजों की फ़ाइल

इम्पोर्ट पूरा होने पर उसकी नतीजों की फ़ाइल डाउनलोड करें। इसमें आपकी फ़ाइल की हर पंक्ति के लिए एक लाइन होती है।

Column
row	आपकी फ़ाइल में पंक्ति संख्या, हेडर के नीचे की पहली पंक्ति से गिनी हुई।
status	created, failed, skipped, या notProcessed जब इम्पोर्ट उस पंक्ति तक पहुँचने से पहले रुक गया।
id, shortUrl	नए लिंक की ID और छोटा पता।
errors	पंक्ति क्यों विफल हुई।

एक दूसरी फ़ाइल में केवल विफल पंक्तियाँ आपके मूल मानों के साथ होती हैं, ताकि आप उन्हें ठीक करके वह फ़ाइल फिर से अपलोड कर सकें।

पिछले इम्पोर्ट

बल्क जॉब्स आपके हाल के इम्पोर्ट को उनकी स्थिति और गिनती के साथ दिखाता है। उसकी प्रगति देखने या उसकी फ़ाइलें फिर से डाउनलोड करने के लिए किसी एक को खोलें।

सावधानी

अपलोड की गई फ़ाइलें और नतीजों की फ़ाइलें 7 दिन तक और इम्पोर्ट का रिकॉर्ड 30 दिन तक रखा जाता है। उससे पहले जो चाहिए वह डाउनलोड कर लें। लिंक खुद कभी नहीं हटाए जाते।

API के ज़रिए बल्क निर्माण

डेवलपर एक अनुरोध में अधिकतम 100 पंक्तियाँ भेजकर तुरंत हर पंक्ति का एक नतीजा पा सकते हैं, या अधिकतम 5,000 पंक्तियों की फ़ाइल को जॉब के रूप में भेजकर उसे पोल कर सकते हैं। वही सीमाएँ और जाँचें लागू होती हैं, और अनुरोध Idempotency-Key हेडर का पालन करता है ताकि दोबारा भेजा गया अनुरोध लिंक दो बार न बनाए। रूट API रेफ़रेंस (Swagger) में दर्ज हैं।

• POST /api/short-link/bulk
• POST /api/link-bulk-jobs
• GET /api/short-link/export

अपने लिंक एक्सपोर्ट करें

शॉर्ट-लिंक सूची से CSV निर्यात करें या JSON निर्यात करें चुनें ताकि आपके लिंक उनके विज़िट काउंटर के साथ डाउनलोड हों।

• एक्सपोर्ट सूची पर लागू फ़िल्टर का उपयोग करता है, इसलिए केवल उसका एक हिस्सा एक्सपोर्ट करने के लिए पहले फ़िल्टर करें।
• एक एक्सपोर्ट में अधिकतम 50,000 पंक्तियाँ होती हैं, नई पहले। लंबी सूची वहीं काट दी जाती है, और फ़ाइल इसे अपनी आखिरी लाइन (CSV) या अपने truncated फ़ील्ड (JSON) में बताती है।
• जो सेल = + - या @ से शुरू होता है उसे CSV में शुरुआत में एक एपॉस्ट्रॉफ़ी मिलती है, ताकि स्प्रेडशीट ऐप उसे फ़ॉर्मूले के रूप में चलाने के बजाय टेक्स्ट के रूप में दिखाए।