این راهنما به شما نشان میدهد که چگونه با Developer Knowledge API شروع به کار کنید. شما یاد خواهید گرفت که چگونه Developer Knowledge API را فعال کنید، یک کلید API دریافت کنید و اولین فراخوانیهای API خود را برای جستجو و بازیابی اسناد توسعهدهنده انجام دهید.
قبل از اینکه شروع کنی
قبل از شروع استفاده از API دانش توسعهدهندگان، مطمئن شوید که مراحل زیر را انجام میدهید.
فعال کردن API
- صفحه API دانش توسعهدهندگان را در کتابخانه APIهای گوگل باز کنید.
- بررسی کنید که پروژهی درستی را که قصد دارید در آن از API استفاده کنید، انتخاب کردهاید.
- روی فعال کردن کلیک کنید. برای فعال کردن یا استفاده از API، به هیچ نقش IAM خاصی نیاز نیست.
کلید API را ایجاد و ایمن کنید
- در کنسول گوگل کلود مربوط به پروژهای که API را در آن فعال کردهاید، به صفحه اعتبارنامهها (Credentials) بروید.
- روی ایجاد اعتبارنامه کلیک کنید و سپس کلید API را از منو انتخاب کنید.
- در قسمت نام ، یک نام برای کلید وارد کنید.
- روی منوی کشویی «انتخاب محدودیتهای API» کلیک کنید و سپس عبارت «Developer Knowledge API» را تایپ کنید. روی نتیجه کلیک کنید و سپس روی «تأیید» کلیک کنید.
- توجه: اگر به تازگی رابط برنامهنویسی کاربردی دانش توسعهدهندگان (Developer Knowledge API) را فعال کردهاید، ممکن است نمایش آن در لیست با تأخیر مواجه شود. چند دقیقه صبر کنید و دوباره امتحان کنید.
- روی ایجاد کلیک کنید.
پاسخ به یک سوال با تولید مبتنی بر زمین
وقتی کلید API دانش توسعهدهنده خود را دریافت کردید، میتوانید شروع به استفاده از API کنید. مثال زیر نحوه پرسیدن یک سوال و دریافت پاسخ مبتنی بر مستندات را نشان میدهد:
کلید API دانش توسعهدهنده خود را در یک متغیر محیطی ذخیره کنید:
export DEVELOPERKNOWLEDGE_API_KEY="YOUR_API_KEY"به جای
YOUR_API_KEY، کلید API که ایجاد کردهاید را قرار دهید.curlبرای فراخوانی نقطه پایانیAnswerQueryاستفاده کنید:curl -X POST "https://developerknowledge.googleapis.com/v1alpha:answerQuery?key=$DEVELOPERKNOWLEDGE_API_KEY" \ -H "Content-Type: application/json" \ -d '{"query": "How do I create a BigQuery dataset?"}'
این دستور بر اساس مستندات، پاسخی به پرسوجوی شما برمیگرداند.
جستجوی تکههای سند
اگر میخواهید به جای یک پاسخ تولید شده، قطعه کدهای خاصی از مستندات را پیدا کنید، میتوانید مستقیماً قطعات سند را جستجو کنید.
curl برای فراخوانی نقطه پایانی SearchDocumentChunks استفاده کنید:
curl "https://developerknowledge.googleapis.com/v1/documents:searchDocumentChunks?query=BigQuery&key=$DEVELOPERKNOWLEDGE_API_KEY"
این پاسخ شامل بخشهایی از محتوای منطبق با مستندات و ارجاعات به اسناد والد است.
بازیابی یک سند
پاسخ از searchDocumentChunks شامل لیستی از بخشهای سند است. هر بخش سند دارای یک فیلد parent است که شامل نام منبع سند است که میتوانید با GetDocument برای بازیابی محتوای کامل سند استفاده کنید.
برای بازیابی یک سند، فیلد parent را از یکی از تکههای برگردانده شده توسط searchDocumentChunks کپی کرده و آن را در یک متغیر محیطی ذخیره کنید، سپس curl برای فراخوانی نقطه پایانی GetDocument استفاده کنید:
export DOC_NAME="PARENT_FIELD_FROM_SEARCH"
curl "https://developerknowledge.googleapis.com/v1/$DOC_NAME?key=$DEVELOPERKNOWLEDGE_API_KEY"
این، محتوای کامل Markdown سند مشخص شده را برمیگرداند.
قدم بعدی چیست؟
- برای مشاهده لیست کامل مستندات موجود، مرجع Corpus را بررسی کنید.
- برای جزئیات بیشتر در مورد متدها و پارامترهای API، به مستندات مرجع API مراجعه کنید.