جمینی، دستیار هوش مصنوعی گوگل، به همراه سایر ابزارهای توسعهدهندگان، میتواند از طریق ویژگیهایی که مستقیماً در این سایت موجود است، به شما در درک مستندات API گوگل هلث و آزمایش فراخوانیهای API کمک کند.
پنل اطلاعات با چت
این ویژگی، کمک به مستندسازی در لحظه را در حین مرور ارائه میدهد. از طریق نوار کناری پنل اطلاعات در هر مقاله فنی در این سایت، به چت دسترسی پیدا کنید. پاسخهای چت فقط بر اساس محتوای صفحهای است که مشاهده میکنید. اگر چت نشان دهد که نمیتواند به سؤالی پاسخ دهد، اطلاعات در صفحه فعلی موجود نیست. این به شما کمک میکند تا تأیید کنید که در صفحه صحیحی برای موضوع مورد علاقه خود هستید. این ویژگی برای خلاصه کردن صفحات پیچیده یا یافتن سریع جزئیات خاص در متن ایدهآل است.
برای استفاده از چت جمینی، این مراحل را دنبال کنید:
- روی نماد در سمت راست بالای هر صفحه کلیک کنید.
- برای عضویت در برنامه توسعهدهندگان گوگل، یک حساب کاربری ایجاد کنید.
- شرایط و توافقنامه حریم خصوصی را بپذیرید.
توضیح کد
برای درک جزئیات پیادهسازی در نمونههای کد، از Code Explain استفاده کنید. هر بلوک کد شامل یک دکمه با آیکون است. برای باز کردن توضیح در پنل اطلاعات، روی این آیکون کلیک کنید. Gemini زبان کد را شناسایی کرده و منطق آن را توضیح میدهد. برای تعمیق درک خود، سوالات تکمیلی را در پنل اطلاعات بپرسید، مانند «چرا از این فراخوانی استفاده شده است؟» یا «چگونه میتوانم این را برای یک سناریوی متفاوت تطبیق دهم؟»
ارائه بهترین شیوهها
برای گرفتن بهترین نتیجه از امکانات سایت Gemini، از این تکنیکهای ترغیبکننده استفاده کنید:
- یک شخصیت (persona) اختصاص دهید : به Gemini نقش خود را برای تنظیم پاسخهایش بگویید. برای مثال: "فرض کنید شما یک توسعهدهنده باتجربه Kotlin هستید که API Google Health را ادغام میکند."
- از منطق گام به گام استفاده کنید : از Gemini نخواهید که وظایف پیچیده را در یک دستور واحد انجام دهد. در عوض، درخواست خود را تجزیه و تحلیل کنید و تکرار کنید: یادداشت ارائه دهید، پیشنویس بخواهید، بازخورد ارائه دهید و درخواست اصلاح کنید.
- ارائه نمونههایی از قالب : اگر به خروجی خاصی مانند جدول HTML نیاز دارید، یک نمونه کوچک از قالب انتخاب شده را در اعلان خود قرار دهید.
کاوشگر APIهای تعاملی
این سایت شامل APIs Explorer است، ابزاری تعاملی برای آزمایش فراخوانیهای API به طور مستقیم در مرورگر شما بدون هیچ گونه تنظیمات محلی. برای راهنمایی بیشتر در مورد استفاده از این ابزار، به مستندات APIs Explorer مراجعه کنید.
چگونه کار میکند؟
در صفحات مرجع API، از پنل «این روش را امتحان کنید» برای وارد کردن پارامترها استفاده کنید و روی «اجرا» کلیک کنید. این یک درخواست زنده به API سلامت ارسال میکند و پاسخ JSON را مستقیماً در مرورگر شما نمایش میدهد. برای مثال، به users.dataTypes.dataPoints/list مراجعه کنید.
برای دسترسی به API Explorer:
- پنل «این روش را امتحان کنید» را در سمت راست صفحه مرجع API پیدا کنید.
- مطمئن شوید که به حساب توسعهدهنده گوگل خود وارد شدهاید و یک توکن دسترسی OAuth 2.0 برای تأیید درخواستها دریافت کردهاید.
- در پنل «این روش را امتحان کنید» ، تیک گزینهی «کلید API» را بردارید و به جای آن، توکن دسترسی خود را در آن فیلد وارد کنید.
- فیلدهای مورد نیاز را پر کنید و روی «اجرا» کلیک کنید.
مزایا برای توسعهدهندگان
- اعتبارسنجی بدون نیاز به راهاندازی : قبل از نوشتن کد، پاسخهای API را تأیید کنید.
- ساختار پاسخ : ساختار دقیق JSON پاسخهای API را مشاهده کنید. میتوانید از این خروجی برای ساخت منطق تجزیه یا ارائه زمینه برای درخواستهای هوش مصنوعی استفاده کنید.
- سرعت : با کاهش آزمون و خطا، توسعه را تسریع کنید.