پرش به محتوای اصلی
یک شروع رایگان برای شما

۳ روز رایگان،
پنل تحلیلگر را تجربه کنید

ثبت‌نام کنید و با تأیید شماره موبایل، دسترسی آزمایشی سه‌روزه‌تان را فعال کنید.

✓ بدون نیاز به پرداخت✓ فعال‌سازی پس از تأیید موبایل
شروع رایگان ۳ روزه

ویژه کاربران جدید · یک دوره برای هر حساب

اتصال API اخبار به اکسل با Power Query؛ راهنمای تنظیم داده

اتصال API اخبار به اکسل می‌تواند ورود دستی خبر را کاهش دهد. Power Query مسیر دریافت و تبدیل داده را فراهم می‌کند. این راهکار اتصال بیرونی است، نه افزونه اختصاصی…

تیم khapi · ۲۰ آبان ۱۴۰۵ · ۳ دقیقه مطالعه
تصویر مفهومی نمای سه‌ربع نمایشگر با جدول داده و پنجره ورود اطلاعات، کنار کارت‌های خبر و نشان قفل

اکسل را مصرف‌کننده داده ببینید

اتصال API اخبار به اکسل می‌تواند ورود دستی خبر را کاهش دهد. Power Query مسیر دریافت و تبدیل داده را فراهم می‌کند. این راهکار اتصال بیرونی است، نه افزونه اختصاصی khapi. ابتدا هدف جدول و حجم داده لازم را مشخص کنید. کار را با یک درخواست محدود و قابل بررسی شروع کنید.

ساخت پرس‌وجوی وب

در محیط Power Query، منبع وب را با نشانی ثابت تعریف کنید. مسیر اخبار را به نشانی پایه khapi متصل کنید. در زبان M، تابع Web.Contents برای دریافت پاسخ کاربرد دارد. فیلترها را از طریق گزینه Query جدا وارد کنید. ترکیب نامنظم رشته‌ها، تشخیص خطای پارامتر را دشوار می‌کند.

احراز هویت درست

khapi کلید را در هدر x-api-key دریافت می‌کند. گزینه ApiKeyName در Web.Contents به پارامتر نشانی مربوط است. بنابراین آن را جایگزین خودکار هدر موردنیاز فرض نکنید. کلید را در فایل قابل توزیع یا تصویر آموزش نگذارید. روش نگهداری اعتبارنامه باید با سیاست محیط شما سازگار باشد.

خواندن ساختار JSON

پاسخ موفق شامل آرایه articles و اطلاعات صفحه‌بندی است. ابتدا آرایه را انتخاب و سپس به جدول تبدیل کنید. ستون‌های id، title، source و url را گسترش دهید. published_at زمان انتشار است و ممکن است خالی باشد. آرایه‌ها و مقدارهای خالی را پیش از نمودارسازی کنترل کنید.

تعیین نوع ستون‌ها

شناسه را برای تطبیق رکورد نگه دارید. عنوان و نشانی باید به‌عنوان متن خوانده شوند. تاریخ را با آگاهی از منطقه زمانی تبدیل کنید. مقدار خالی را بدون دلیل به تاریخ امروز تبدیل نکنید. نوع ستون اشتباه می‌تواند نتیجه مرتب‌سازی و شمارش را تغییر دهد.

نمودار توضیحی جریان پاسخ ساختاریافته به فهرست رکوردها، گسترش ستون‌ها و جدول نهایی

فیلتر قبل از دریافت

موضوع و بازه زمانی را تا حد امکان در درخواست محدود کنید. دانلود داده اضافی و حذف آن در اکسل کارآمد نیست. نام دقیق منابع را مطابق مستندات و داده موجود بفرستید. برای کد تازه از page_size و sources استفاده کنید. نام‌های قدیمی را بدون نیاز وارد اتصال جدید نکنید.

جمع‌آوری چند صفحه

صفحه اول فقط بخشی از مجموعه نتیجه است. برای بازه بزرگ‌تر، صفحات بعدی را با سقف مشخص دریافت کنید. حداکثر page_size در khapi صد است. دریافت چندباره یک صفحه، هزینه و رکورد تکراری ایجاد می‌کند. پس از ترکیب، شناسه‌ها را برای تکرار بررسی کنید.

تازه‌سازی قابل کنترل

زمان دریافت موفق را در خروجی نگه دارید. شکست تازه‌سازی نباید داده قبلی را تازه جلوه دهد. اجرای محلی و محیط اشتراکی را جدا آزمایش کنید. تنظیمات اعتبارنامه در رایانه دیگر ممکن است متفاوت باشد. پیش از تحویل فایل، همین مسیر مقصد را بررسی کنید.

آزمون خطا

پاسخ خالی، کلید نامعتبر و محدودیت درخواست را امتحان کنید. برای آزمون آموزشی از پاسخ‌های ساختگی استفاده کنید. خطا باید برای کاربر قابل فهم باشد. محتوای HTML خطا نباید به جدول خبر تبدیل شود. فایل نهایی را از وجود کلید یا اطلاعات حساس بازبینی کنید.

استفاده عملی با khapi

یک موضوع محدود را از مستندات API khapi انتخاب کنید. جدول آزمایشی را با ستون‌های حداقلی بسازید. سپس نمودار یا جدول محوری موردنیاز را روی همان داده ایجاد کنید. مصرف درخواست و کیفیت نتیجه را پیش از گسترش بسنجید. اکسل باید کار تحلیل را ساده کند، نه خطای پنهان بیشتری بسازد.

منابع و ادامه مطالعه

اشتراک‌گذاری:

این مطلب چطور به کار شما بیاید؟

مفاهیم این مقاله را مستقیم در پنل khapi امتحان کنید:

آماده شروع هستید؟

۳ روز استفادهٔ رایگان از پنل تحلیلگر، مطابق محدودیت‌های دورهٔ آزمایشی و بدون نیاز به کارت بانکی.