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

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

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

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

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

اتصال API اخبار به گوگل شیت؛ طراحی جریان ورود و تازه‌سازی داده

گوگل شیت می‌تواند محل مرور خبرهای دریافتی از API باشد. این اتصال یک پیاده‌سازی بیرونی با Apps Script است. وجود افزونه آماده khapi را از این راهنما برداشت نکنید.

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

شیت به‌عنوان میز کار

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

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

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

نگهداری کلید

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

درخواست نخست

در Apps Script از UrlFetchApp برای درخواست HTTP استفاده می‌شود. مسیر اخبار khapi، GET روی /api/v1/news است. کلید باید در هدر x-api-key فرستاده شود. پارامترهای page و page_size را صریح تنظیم کنید. نام فیلترها را از مستندات khapi بردارید، نه حدس شخصی.

خواندن پاسخ

ابتدا وضعیت HTTP و نوع محتوای پاسخ را بررسی کنید. سپس JSON معتبر را به شیء تبدیل کنید. آرایه خبرها در فیلد articles قرار دارد. عنوان یا خلاصه خالی باید بدون خراب کردن ردیف مدیریت شود. پاسخ خطا را به‌عنوان خبر تازه در جدول ننویسید.

نمودار توضیحی جریان چهارمرحله‌ای از سرور خبر به قطعه اسکریپت انتزاعی، کنترل شناسه و جدول

نوشتن بدون تکرار

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

صفحه‌بندی محدود

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

زمان‌بندی با بودجه

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

آزمون پیش از اشتراک

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

گام بعد با khapi

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

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

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

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

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

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

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