הסבר על ספריות לקוח וממשקי Cloud API

אמנם אפשר להשתמש ישירות ב-API על ידי יצירת בקשות גולמיות חדשות לשרת, אבל ספריות לקוח מפשטות את התהליך ומפחיתות באופן משמעותי את כמות הקוד שתצטרכו לכתוב. Google Cloud

במאמר הזה מוסברות שיטות לאינטראקציה עם ממשקי API: Google Cloud

• ספריות לקוח ב-Cloud (מומלץ)
• ספריות לקוח של Google API
• Firebase mobile
• קוד הלקוח שלכם

כדי למצוא מידע על ספריות לקוח למוצר ספציפי Google Cloud , אפשר לעיין בקטע 'ספריות לקוח' במסמכי העזרה של המוצר. כדי לראות את כל ספריות הלקוח של Cloud, שמסודרות בדרך כלל לפי שפה נתמכת, אפשר לעיין במאמר ספריות לקוח של Cloud.

ספריות לקוח ב-Cloud

ספריות לקוח ב-Cloud הן האפשרות המומלצת לגישה פרוגרמטית לממשקי Cloud API, אם הן זמינות. ספריות הלקוח ב-Cloud משתמשות במודל העדכני של ספריות הלקוח, והן:

• אנחנו מספקים קוד אידיומטי בכל שפה כדי להפוך את השימוש בממשקי API למהנה ואינטואיטיבי. Google Cloud
• ספריות הלקוח צריכות להיות בעלות סגנון עקבי כדי לפשט את העבודה עם כמה שירותים. Google Cloud
• לטפל בכל הפרטים ברמה הנמוכה של התקשורת עם השרת, כולל אימות ב-Google.
• אפשר להתקין אותו באמצעות כלים מוכרים לניהול חבילות כמו npm ו-pip.
• במקרים מסוימים, שימוש ב-gRPC יכול לשפר את הביצועים. מידע נוסף זמין במאמר gRPC APIs.

הוראות ההתקנה וחומרי העזר של ספריות הלקוח של Cloud תלויים ב-API הספציפי ובשפת התכנות שבה אתם משתמשים. כדי למצוא את המידע הזה, אפשר לעיין במסמכי התיעוד של המוצר הספציפי. ברוב המוצרים יש קטע 'ספריות לקוח' במסמכי התיעוד, שבו מפורטים הנחיות ספציפיות לשפה, שלבי התקנה וקישורים למאמרי העזרה המפורטים של ה-API. Google Cloud Google Cloud

כדי למצוא את התיעוד של מוצר ספציפי, אפשר לעיין ב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 הנתמכים ועל תחילת השימוש ב-Firebase זמין במסמכי התיעוד של Firebase. Google Cloud

שימוש בקוד לקוח משלכם

אם אתם מפתחים מנוסים וספריות הלקוח של Cloud לא עונות על הצרכים הספציפיים שלכם, אתם יכולים לכתוב קוד מותאם אישית משלכם כדי לגשת ישירות לממשקי ה-API של השירות ברמה נמוכה יותר.

ממשקי API של REST/HTTP

כל ממשקי ה-API Google Cloud חושפים ממשק JSON/REST. אם אתם צריכים לכתוב קוד מותאם אישית משלכם כדי לגשת ישירות ל-API בארכיטקטורת REST באמצעות ספריית לקוח HTTP של צד שלישי, תוכלו לקרוא מידע נוסף על אופן הפעולה של ממשקי API עם גרסאות והטמעות שונות של HTTP בהנחיות ל-HTTP. Google Cloud

ממשקי gRPC API

‫gRPC היא מערכת קריאה לפרוצדורה מרוחקת (RPC) בקוד פתוח, שאינה תלויה בשפה או בפלטפורמה, ופותחה במקור ב-Google. אפשר לקרוא מידע נוסף בכתובת grpc.io. ממשקי API עם תמיכה ב-gRPC כוללים בדרך כלל ממשקי REST ו-RPC. לכן, במקום להשתמש רק ב-JSON דרך HTTP כדי לתקשר עם ממשק REST, לקוחות API עם תמיכה ב-gRPC יכולים גם להשתמש ב-protocol buffers וב-gRPC דרך HTTP2 כדי לתקשר עם ממשק RPC. כדי לדעת אם יש תמיכה ב-gRPC ב-API מסוים, אפשר לעיין בממשקי ה-API ובקטע Reference שלו. Google Cloud

אם Google Cloud API מופעל באמצעות gRPC, אפשר ליצור ספריות לקוח משלכם ל-gRPC בכל שפה שנתמכת על ידי gRPC. כדי לעשות את זה, תצטרכו את הגדרת השירות של מאגרי הפרוטוקולים של ה-API (בדרך כלל אפשר למצוא אותה במאגר ב-GitHub).

אחר כך תוכלו לפעול לפי ההוראות בשפה המועדפת שלכם באתר grpc.io כדי ליצור את הלקוח ולהשתמש בו.

אם אתם לא רוצים ליצור קוד gRPC משלכם, אתם עדיין יכולים ליהנות מ-gRPC: מספר גדל והולך של ספריות לקוח של Cloud עבור ממשקי API עם תמיכה ב-gRPC משתמשות ב-gRPC 'מתחת לפני השטח' כדי לתקשר עם השרתים של Google. זה יעיל הרבה יותר מבחינת תפוקה ושימוש במעבד – גישה ל-API באמצעות gRPC יכולה להגדיל את התפוקה לכל מעבד עד פי 10 בהשוואה ל-API בארכיטקטורת REST בפורמט JSON. Google מתכננת לשדרג כמה שיותר ספריות לקוח של Cloud ל-gRPC. בינתיים, אתם עדיין יכולים ליהנות מכל היתרונות האחרים של קוד ספריית הלקוח של Google.

דרכים נוספות לגשת ל-Cloud APIs

אם אתם לא רוצים לגשת ל-API באופן פרוגרמטי, אתם יכולים לגשת לחלק מהפונקציות האלה באמצעות הכלים ב-Google Cloud CLI או באמצעות Google Cloud המסוף.