Developer Knowledge API מספק גישה פרוגרמטית לתיעוד הפומבי של Google למפתחים, ומאפשר לכם לשלב את מאגר הידע הזה באפליקציות ובסביבות העבודה שלכם.
סקירה כללית
ממשק Developer Knowledge API נועד להיות המקור הקנוני לגישה לקובצי עזרה למפתחים של Google שניתנים לקריאה על ידי מכונה. הוא מציע פונקציות לחיפוש ולאחזור מסמכים, ולמענה על שאילתות:
-
SearchDocumentChunksכדי למצוא תוכן רלוונטי וקטעי תוכן בדפי URI על סמך שאילתה. -
GetDocumentאו BatchGetDocumentsכדי לאחזר את התוכן המלא של תוצאות החיפוש. AnswerQueryכדי לקבל תשובות לשאילתות שמבוססות על מאגר התיעוד.
כדי להתחיל במהירות, כדאי לעיין במדריך למתחילים.
מאגר התוכן שאפשר לחפש בו מפורט בקטע הפניה למאגר.
ממשק Developer Knowledge API תומך בחיפוש ובאחזור של דפי תיעוד כתוכן Markdown לא מובנה.
הפעלת ה-API
כדי להשתמש ב-Developer Knowledge API, צריך קודם להפעיל אותו בפרויקט ב-Google Cloud.
- פותחים את הדף של Developer Knowledge API בספריית Google APIs.
- מוודאים שבחרתם את הפרויקט הנכון שבו אתם רוצים להשתמש ב-API.
- לוחצים על הפעלה. לא נדרשים תפקידים ספציפיים ב-IAM כדי להפעיל את ה-API או להשתמש בו.
אימות
כדי להשתמש ב-Developer Knowledge API, צריך מפתח API של Developer Knowledge. כדי ליצור אחד:
- במסוף Google Cloud, בפרויקט שבו הפעלתם את ה-API, עוברים אל הדף Credentials.
- לוחצים על Create credentials ובתפריט בוחרים באפשרות API key.
- בשדה Name (שם), מזינים שם למפתח.
-
לוחצים על התפריט הנפתח Select API restrictions (בחירת הגבלות על ממשקי API) ומקלידים Developer Knowledge API. לוחצים על התוצאה ואז על אישור.
הערות:
- אם הפעלתם את Developer Knowledge API רק עכשיו, יכול להיות שיעבור זמן עד שהוא יופיע ברשימה. מחכים כמה דקות ומנסים שוב.
-
אם אתם מתכננים להשתמש באותו מפתח לקריאות של מודל כללי של לקוח ה-AI (לדוגמה,
GEMINI_API_KEY), אתם צריכים לבחור גם באפשרות Generative Language API. אחרת, השיחות האלה ייחסמו.
- לוחצים על יצירה.
צריך לכלול את מפתח ה-API של Developer Knowledge בבקשות. לדוגמה, צריך לכלול אותו בקריאות REST באמצעות פרמטר השאילתה key. לדוגמה, אפשר לעיין במדריך למתחילים.
מסמכים כלולים
מידע על המסמכים שה-API מחפש בהם מופיע במאמר הפניה לקורפוס.
מגבלות ידועות
- איכות ה-Markdown: ה-Markdown נוצר מקוד ה-HTML של המקור. יכול להיות שיהיו אי התאמות או בעיות עיצוב.
- היקף התוכן: רק דפים ציבוריים במאגר המידע נכללים. תוכן ממקורות אחרים כמו GitHub, אתרי OSS, בלוגים או YouTube לא נכלל.