Google Cloud ממשקי API הם ממשקים פרוגרמטיים שמאפשרים לשלב באפליקציות שירותי מחשוב, רשת, אחסון ולמידת מכונה. אפשר לשלוח קריאות לממשקי ה-API האלה של הרשת דרך נקודות קצה של JSON HTTP או gRPC, בדרך כלל באמצעות כלים כמו ספריות לקוח או Google Cloud CLI.
מידע על Cloud APIs
ממשקי Cloud API מוצגים ללקוחות כשירותי API ברשת, כמו Cloud Pub/Sub API. כל Cloud API פועל בדרך כלל בדומיין משנה אחד או יותר של googleapis.com, כמו pubsub.googleapis.com, ומספק ממשקי JSON HTTP ו-gRPC ללקוחות ברשתות אינטרנט ציבוריות וברשתות Virtual Private Cloud (VPC). לקוחות יכולים לשלוח בקשות HTTP ו-gRPC לנקודות קצה של Cloud API ישירות או באמצעות ספריות לקוח.
ממשקי Cloud API הם חלק מהקטגוריה Google Enterprise APIs בAPI Library של מסוף Google Cloud .
יש שני סוגים של ממשקי API ב- Google Cloud :
ממשקי API שמבוססים על משאבים: הממשקים האלה משתמשים בפרויקט שמשויך למשאבים שאליהם מתבצעת הגישה, לצורכי חיוב ומכסה.
ממשקי API שמבוססים על לקוחות: הממשקים האלה משתמשים בפרויקט שמשויך ללקוח שבאמצעותו מתבצעת הגישה למשאבים, לצורכי חיוב ומכסה.
גישה לממשקי Cloud API
אתם יכולים לגשת ל-Cloud APIs מאפליקציות שרת באמצעות ספריות הלקוח שלנו בהרבה שפות תכנות פופולריות, מאפליקציות לנייד באמצעות ערכות ה-SDK של Firebase או באמצעות לקוחות של צד שלישי. אפשר גם לגשת ל-Cloud APIs באמצעות Google Cloud CLI, מסוףGoogle Cloud או שרתי MCP של Google Cloud.
אם אתם חדשים ב-Cloud APIs, במאמר תחילת השימוש מוסבר איך להשתמש ב-Cloud APIs.
תמיכה ב-HTTP וב-gRPC
כל ממשקי ה-Cloud API מספקים ממשק JSON HTTP פשוט שאפשר לשלוח אליו קריאה ישירות או באמצעות ספריות הלקוח של Google API. רוב ממשקי ה-Cloud API מספקים גם ממשק gRPC שאפשר לקרוא לו באמצעות ספריות הלקוח של Google Cloud, שמספקות ביצועים ונוחות שימוש טובים יותר. אפשר גם להשתמש בלקוחות של צד שלישי.
מידע נוסף על ספריות הלקוח שלנו זמין במאמר הסבר על ספריות לקוח.
למידע נוסף על אימות לשימוש בממשקי Google API, ראו שיטות אימות ב-Google ואימות לשימוש בספריות לקוח.
הצפנת TLS
כל ממשקי ה-Cloud API מקבלים רק בקשות מאובטחות באמצעות הצפנת TLS.
- אם אתם משתמשים באחת מספריות הלקוח שלנו, הספרייה מטפלת בהצפנה במעבר בשבילכם.
- אם אתם משתמשים בלקוח gRPC משלכם, אתם צריכים לבצע אימות ב-Google (שדורש TLS) לפי ההוראות שבמדריך האימות של gRPC.
- אם אתם יוצרים צד הלקוח ב-HTTP משלכם, כדאי לעיין בהנחיות שלנו בנושא HTTP.
במדריך האבטחה שלנו בנושא הצפנה במעבר מוסבר איך מאובטחת התעבורה אל שירותי Google Cloud .
התחברות לשירות פרטי
לקוחות ארגוניים רוצים לעיתים קרובות לגשת לממשקי Cloud API באופן פרטי מטעמי אבטחה ותאימות. אתם יכולים להשתמש ב-Private Service Connect כדי להגדיר ולנהל את הגישה הזו ברשתות ה-VPC שלכם.
מידע נוסף זמין במאמר הגדרת Private Service Connect.
דוגמאות מפורטות
במדריכים המפורטים הבאים מוסבר איך להשתמש בספריות הלקוח של כמה ממשקי API פופולריים:
- Cloud Billing Budget API עם Node.js.
- Cloud Billing Budget API עם Python.
- Cloud Logging באמצעות Node.js.
- Cloud Logging עם Python.
- Cloud Logging באמצעות Go.
- Cloud Logging עם Java.
- המרת דיבור לטקסט (STT) באמצעות Node.js.
- המרת דיבור לטקסט (STT) באמצעות Python.
- המרת דיבור לטקסט (STT) באמצעות Go.
- המרת דיבור לטקסט באמצעות Java.
מדריך לעיצוב API
לא משנה באיזה סוג ממשק משתמשים, כל ממשקי Cloud API מבוססים על עקרונות תכנון ממוקדי משאבים, כפי שמתואר ב-API Design Guide. כך מובטח שממשקי Cloud API יספקו למפתחים חוויה פשוטה ועקבית. כדי להבין טוב יותר את ממשקי ה-API של Cloud, תוכלו לעיין במדריך לעיצוב API.
כדי ללמוד על הגדרת הממשק של Cloud APIs, אפשר להיכנס למאגר Google APIs ב-GitHub.
הגבלת השימוש
ממשקי Cloud API משותפים בין מיליוני מפתחים ומשתמשים. כדי להבטיח שימוש הוגן ולצמצם את הסיכונים לניצול לרעה, כל Cloud APIs אוכפים הגבלת קצב של יצירת בקשות ומכסות משאבים על השימוש, שנקראות בדרך כלל מכסות. אתם יכולים גם להשתמש במכסות האלה כדי לשלוט בהוצאות שלכם על מוצרי Google Cloud, על ידי הקטנת מגבלות המכסות שלכם. אם אתם צריכים מכסות גדולות יותר ממגבלות ברירת המחדל, אתם צריכים להגיש בקשות להגדלת המכסות.
מידע נוסף זמין במאמר הגבלת השימוש ב-API.
מעקב אחר השימוש
רוב ממשקי ה-Cloud API מספקים לכם מידע מפורט על השימוש ב-API מסוים בפרויקט שלכם, כולל רמות תעבורת הנתונים, שיעורי השגיאות וזמני האחזור. כך תוכלו לתעדף במהירות בעיות באפליקציות שמשתמשות בממשקי Cloud API. אפשר לראות את המידע הזה במרכז הבקרה של ממשקי ה-API במסוף Google Cloud . אפשר גם ליצור מרכזי בקרה והתראות בהתאמה אישית ב-Cloud Monitoring.
מידע נוסף זמין במאמר מעקב אחרי השימוש ב-API.
Google Enterprise APIs
ממשקי Google Enterprise API הם ממשקי API יציבים מאוד, שמוכנים לשימוש ארגוני עם אפשרויות תמיכה זמינות.
מידע נוסף זמין במאמר בנושא ממשקי Google Enterprise API.