תחילת העבודה

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

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

יצירת Google Cloud פרויקט

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

פרויקט יכול להיות הבעלים של מגוון רחב של משאבים, כולל מפתחות API, לקוחות OAuth, חשבונות שירות, מכונות וירטואליות ב-Compute Engine, קטגוריות של Cloud Storage ומערכי נתונים ב-BigQuery. כשיישום קורא ל- Google Cloud API, הפרויקט שבבעלותו פרטי הכניסה של היישום נקרא פרויקט הלקוח, והפרויקט שבבעלותו משאב היעד נקרא פרויקט המשאב. בקשות מסוימות ל-API יכולות לגעת בכמה משאבים, ובמקרה כזה יכולים להיות מעורבים בבקשה יותר מפרויקט משאב אחד.

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

גילוי ממשקי API

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

הפעלת ממשקי API

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

כדי להפעיל API, צריך לאשר את התנאים וההגבלות ואת האחריות לחיוב על השימוש ב-API. כדי להפעיל ממשקי API, צריך הרשאה serviceusage.services.enable בפרויקט. מידע נוסף מופיע במאמר בנושא בקרת גישה ב-Service Usage.

בנוסף, השירות שרוצים להפעיל צריך להיות ציבורי, או שבעל השירות צריך להעניק למשתמש את ההרשאה servicemanagement.services.bind בשירות הפרטי. מידע נוסף מופיע במאמר בקרת גישה ב-Service Management API.

כדי להפעיל API בפרויקט באמצעות המסוף:

  1. עוברים אל Google Cloud API Library במסוף.
  2. ברשימת הפרויקטים, בוחרים את הפרויקט שרוצים להשתמש בו.
  3. בספריית ה-API, בוחרים את ה-API שרוצים להפעיל. אם אתם צריכים עזרה במציאת ה-API, אתם יכולים להשתמש בשדה החיפוש ובמסננים.
  4. בדף ה-API, לוחצים על הפעלה.

באותו דף אפשר להשבית API בפרויקט אם כבר לא משתמשים בו, כדי למנוע שימוש לרעה וחיובים לא מכוונים. אפשר גם להפעיל ולהשבית ממשקי Cloud API באמצעות ה-CLI של gcloud ו-Service Usage API:

gcloud services enable pubsub.googleapis.com
gcloud services disable pubsub.googleapis.com

הפעלת חיוב

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

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

אימות ממשקי API

האופן שבו מבצעים אימות ל-API משתנה בהתאם לסביבת הפיתוח ולשיטות האימות שה-API תומך בהן.

הגישה הנפוצה ביותר היא להגדיר Application Default Credentials לשימוש במגוון סביבות, ומומלץ להשתמש בה ברוב האפליקציות. אם ה-API תומך במפתחות API, זו אפשרות נוספת. אם האפליקציה שלכם צריכה לגשת למשאבי Cloud שנמצאים בבעלות משתמשי הקצה, אתם צריכים ליצור מזהה לקוח ב-OAuth 2.0 ולהשתמש בספריות האימות.

למידע כללי על אימות, תוכלו לעיין במאמר בנושא אימות ב-Google.

פיתוח אפליקציות

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

אפשר לעיין במדריכים הבאים שמסבירים איך להשתמש בספריות הלקוח עבור כמה ממשקי API פופולריים:

מידע נוסף זמין במאמר הסבר על ספריות לקוח.

מידע נוסף