ספריות לקוח מאפשרות לכם לגשת Google Cloud ל-API באופן פרוגרמטי עם פחות קוד שחוזר על עצמו, כי הן מטפלות באימות ובקשר עם השרת ברמה נמוכה. במסמך הזה מוסברות השיטות הבאות לאינטראקציה עםGoogle Cloud ממשקי API:
- ספריות לקוח ב-Cloud (מומלץ)
- ספריות לקוח של Google API
- פלטפורמת הפיתוח של Firebase
- קוד לקוח משלכם
כדי למצוא מידע על ספריות לקוח למוצר ספציפי Google Cloud , אפשר לעיין בקטע 'ספריות לקוח' במסמכי העזרה של המוצר.
ספריות לקוח ב-Cloud
אמנם אפשר להשתמש Google Cloud ישירות ב-APIs על ידי יצירת בקשות גולמיות חדשות לשרת, אבל ספריות הלקוח של Cloud מפשטות את התהליך ומפחיתות באופן משמעותי את כמות הקוד שתצטרכו לכתוב. ספריות הלקוח ב-Cloud הן האפשרות המומלצת לגישה ל-Cloud APIs באופן פרוגרמטי, כי הן משתמשות במודל העדכני של ספריות לקוח וכוללות את היתרונות הבאים:
- כדי ש Google Cloud ממשקי ה-API יהיו אינטואיטיביים לשימוש, צריך לספק קוד אידיומטי בכל שפה.
- ספריות הלקוח צריכות להיות בעלות סגנון עקבי כדי לפשט את העבודה עם כמה Google Cloud שירותים.
- לטפל בכל הפרטים ברמה הנמוכה של התקשורת עם השרת, כולל אימות ב-Google.
- אפשר להתקין אותו באמצעות כלים מוכרים לניהול חבילות כמו
npmו-pip. - במקרים מסוימים, שימוש ב-gRPC יכול לשפר את הביצועים. מידע נוסף זמין במאמר בנושא gRPC APIs.
הוראות ההתקנה וחומרי העזר של ספריות הלקוח ב-Cloud משתנים בהתאם ל-API Google Cloud הספציפי ולשפת התכנות שבה אתם משתמשים. כדי למצוא את המידע הזה, אפשר לעיין במסמכי העזרה של Google Cloud המוצר הספציפי. ברוב המוצרים יש קטע Client Libraries (ספריות לקוח) במסמכי התיעוד שלהם, שכולל הנחיות ספציפיות לשפה, שלבי התקנה וקישורים להפניה מפורטת ל-API.
כדי למצוא את מאמרי העזרה של מוצר ספציפי, אפשר לעיין Google Cloud בספריית ה-API.
נסו בעצמכם
אתם משתמשים חדשים ב- Google Cloud? אנחנו ממליצים לכם ליצור חשבון, להתנסות בעצמכם במוצרים שלנו ולבחון אותם באמצעות תרחישים ממשיים. לקוחות חדשים מקבלים בחינם גם קרדיט בשווי 300$ להרצה, לבדיקה ולפריסה של עומסי העבודה.
מתחילים לעבוד בלי לשלםספריות לקוח של Google API
אם ספריות הלקוח ב-Cloud לא זמינות בשפה המועדפת שלכם עבור API ספציפי, אתם יכולים להשתמש בספריות הלקוח של Google API. אלה ספריות לקוח מוקדמות יותר שסופקו על ידי Google.
יכול להיות שתשתמשו בספריות האלה גם אם אתם משדרגים פרויקט שכבר נעשה בו שימוש בספריות האלה. הספריות האלה:
- הגישה היא רק לממשק REST של ה-API, אין תמיכה ב-gRPC.
- יש קוד ממשק שנוצר אוטומטית, שאולי לא אידיומטי כמו ספריות הלקוח ב-Cloud.
- לטפל בכל הפרטים ברמה הנמוכה של התקשורת עם השרת, כולל אימות ב-Google.
- אפשר להתקין אותו באמצעות כלים מוכרים לניהול חבילות כמו
npmו-pip.
שימוש בפלטפורמת הפיתוח של Firebase
Firebase היא פלטפורמת השירותים של Google שנועדה לתמוך בכל מחזור החיים של פיתוח האפליקציה. היא מספקת ערכות SDK חוצות-פלטפורמות שיעזרו לכם ולסוכני AI ליצור ולהפעיל אפליקציות לפלטפורמות של אפל, ל-Android, לאינטרנט, ל-Flutter, ל-Unity ול-C++.
מידע על ממשקי ה-API Google Cloud הנתמכים ועל תחילת השימוש ב-Firebase זמין ב מסמכי התיעוד של Firebase.
שימוש בקוד לקוח משלכם
אם אתם מפתחים מנוסים וספריות הלקוח של Cloud לא עונות על הצרכים הספציפיים שלכם, אתם יכולים לכתוב קוד מותאם אישית משלכם כדי לגשת ישירות לממשקי ה-API של השירות ברמה נמוכה יותר.
ממשקי API של REST/HTTP
כל ממשקי ה-API Google Cloud חושפים ממשק JSON/REST. אם אתם צריכים לכתוב קוד מותאם אישית משלכם כדי לגשת ישירות ל-API בארכיטקטורת REST באמצעות ספריית לקוח HTTP של צד שלישי, תוכלו לקרוא מידע נוסף על אופן הפעולה של Google Cloud ממשקי API עם גרסאות והטמעות שונות של HTTP ב הנחיות ל-HTTP.
ממשקי gRPC API
gRPC היא מערכת קוד פתוח לקריאה לשירות מרוחק (RPC) שאינה תלויה בשפה או בפלטפורמה, ופותחה במקור ב-Google. מידע נוסף זמין באתר grpc.io. לממשקי API Google Cloud עם gRPC יש בדרך כלל ממשקי REST ו-RPC, כך שבמקום להשתמש רק ב-JSON over HTTP כדי לתקשר עם ממשק ה-REST, לקוחות API עם gRPC יכולים גם להשתמש ב-protocol buffers וב-gRPC over HTTP2 כדי לתקשר עם ממשק ה-RPC. כדי לדעת אם API תומך ב-gRPC, צריך לבדוק את הקטע 'ממשקי API והפניות'.
אם Google Cloud API מופעל באמצעות gRPC, אפשר ליצור ספריות לקוח משלכם ל-gRPC בשפה כלשהי שנתמכת על ידי gRPC. כדי לעשות את זה, תצטרכו את הגדרת השירות של מאגרי הפרוטוקולים של ה-API (בדרך כלל אפשר למצוא אותה במאגר ב-GitHub).
אחר כך אפשר לפעול לפי ההוראות בשפה המועדפת בכתובת grpc.io כדי ליצור את הלקוח ולהשתמש בו.
אם אתם לא רוצים ליצור קוד gRPC משלכם, אתם עדיין יכולים ליהנות מ-gRPC: מספר גדל והולך של ספריות לקוח של Cloud ל-APIs עם תמיכה ב-gRPC משתמשות ב-gRPC 'מאחורי הקלעים' כדי לתקשר עם השרתים של Google. הגישה ל-API באמצעות gRPC יעילה הרבה יותר מבחינת קצב העברת הנתונים ושימוש במעבד (CPU). קצב העברת הנתונים לכל מעבד יכול להיות גבוה פי 10 בהשוואה ל-API בפורמט JSON בארכיטקטורת REST. Google מתכננת לשדרג כמה שיותר ספריות לקוח של Cloud ל-gRPC. בינתיים, תוכלו ליהנות מכל היתרונות האחרים של קוד ספריית הלקוח של Google.
דרכים נוספות לגשת אל Cloud APIs
אם אתם לא רוצים לגשת ל-API באופן פרוגרמטי, אתם יכולים לגשת לחלק מהפונקציות האלה באמצעות הכלים ב-Google Cloud CLI או באמצעות Google Cloud המסוף.