শর্ট লিংকের বাল্ক ইমপোর্ট ও এক্সপোর্ট

যখন আপনার কাছে ছোট করার জন্য দশ বা হাজার হাজার URL থাকে, প্রতিটি লিংক হাতে তৈরি না করে সেগুলো একটি CSV ফাইলে আপলোড করুন। প্রতিটি সারি একটি সাধারণ শর্ট লিংক হয়ে যায়, যা আপনি অন্য যেকোনো লিংকের মতো সম্পাদনা, শেয়ার ও ট্র্যাক করতে পারেন।

Note

বাল্ক তৈরি আপনার প্ল্যানের উপর নির্ভর করে। প্রতিটি তৈরি সারির খরচ হাতে তৈরি করার সমান, এবং ইমপোর্ট বা এক্সপোর্টে কোনো অতিরিক্ত খরচ নেই। বিস্তারিত জানতে ক্রেডিট পেজ দেখুন। ফিচার ক্রেডিট

CSV ফাইল থেকে শর্ট লিংক ইমপোর্ট করুন

1. ড্যাশবোর্ডে URL Shortener খুলুন এবং Bulk import বেছে নিন।

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 কল একসাথে গুনে।
• একসাথে একটি ইমপোর্ট চলে, এবং আরও সর্বোচ্চ তিনটি অপেক্ষা করতে পারে।
• ইমপোর্টের সময় আপনার ক্রেডিট শেষ হলে, সেই সারি ও এর পরের প্রতিটি সারি Not enough credits দিয়ে ব্যর্থ হয়, এবং ইতিমধ্যে তৈরি লিংক থেকে যায়।

অগ্রগতি

ইমপোর্ট পেজ দেখায় কতগুলো সারি প্রসেস, তৈরি ও ব্যর্থ হয়েছে, এবং নিজে থেকেই রিফ্রেশ হয়। আপনি চলমান ইমপোর্ট বাতিল করতে পারেন; বাতিলের আগে তৈরি লিংক থেকে যায়।

প্রতিটি লিংক তৈরির পর ব্যাকগ্রাউন্ডে পেজের শিরোনাম ও অ্যাপ ডিপ লিংক আনা হয়, তাই কিছুক্ষণ একটি লিংক তার হোস্টকে নাম হিসেবে দেখাতে পারে।

ফলাফল ফাইল

ইমপোর্ট শেষ হলে এর ফলাফল ফাইল ডাউনলোড করুন। এতে আপনার ফাইলের প্রতিটি সারির জন্য একটি লাইন থাকে।

Column
row	আপনার ফাইলে সারি নম্বর, হেডারের নিচের প্রথম সারি থেকে গোনা।
status	created, failed, skipped, অথবা notProcessed যখন ইমপোর্ট সারিতে পৌঁছানোর আগেই থেমে যায়।
id, shortUrl	নতুন লিংকের ID ও ছোট ঠিকানা।
errors	সারিটি কেন ব্যর্থ হয়েছে।

দ্বিতীয় একটি ফাইলে শুধু ব্যর্থ সারিগুলো আপনার মূল মানসহ থাকে, যাতে আপনি সেগুলো ঠিক করে ফাইলটি আবার আপলোড করতে পারেন।

আগের ইমপোর্ট

Bulk jobs আপনার সাম্প্রতিক ইমপোর্টগুলো তাদের অবস্থা ও সংখ্যাসহ দেখায়। অগ্রগতি দেখতে বা ফাইল আবার ডাউনলোড করতে একটি খুলুন।

Caution

আপলোড করা ফাইল ও ফলাফল ফাইল 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

আপনার লিংক এক্সপোর্ট করুন

শর্ট-লিংক তালিকা থেকে Export CSV বা Export JSON বেছে নিন, আপনার লিংকগুলো ভিজিট কাউন্টারসহ ডাউনলোড করতে।

• এক্সপোর্ট তালিকায় প্রয়োগ করা ফিল্টার ব্যবহার করে, তাই শুধু একটি অংশ এক্সপোর্ট করতে আগে ফিল্টার করুন।
• একটি এক্সপোর্টে সর্বোচ্চ 50,000 সারি থাকে, নতুনগুলো আগে। দীর্ঘ তালিকা সেখানেই কাটা হয়, এবং ফাইলটি তা তার শেষ লাইনে (CSV) বা তার truncated ফিল্ডে (JSON) জানায়।
• = + - বা @ দিয়ে শুরু হওয়া সেল CSV তে শুরুতে একটি অ্যাপোস্ট্রফি পায়, যাতে স্প্রেডশিট অ্যাপ এটিকে ফর্মুলা হিসেবে না চালিয়ে টেক্সট হিসেবে দেখায়।