דרישות מוקדמות ל-Cloud Billing Budget API

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

התנסות עם המאפיינים של החיוב ב-Cloud במסוף Google Cloud

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

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

מושגי מרכזיים בנושא חיוב ב-Cloud

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

העקרונות הבסיסיים של REST

יש שתי דרכים להפעיל את Cloud Billing Budget API:

  • לשלוח בקשות HTTP ולנתח את התגובות.
  • להשתמש בספריות לקוח (מומלץ).

אם תחליטו לא להשתמש בספריות לקוח, תצטרכו להכיר את העקרונות הבסיסיים של REST.

‫REST הוא סגנון של ארכיטקטורת תוכנה שמציע תפיסה נוחה ועקבית לבקשת נתונים ולשינוי שלהם.

המונח REST הוא קיצור של Representational State Transfer. בהקשר של Google APIs,‏ REST מתייחס לשימוש בפעלים של HTTP כדי לאחזר ולשנות ייצוגים של נתונים ש-Google מאחסנת.

במערכת RESTful, המשאבים מאוחסנים במאגר נתונים. לקוח שולח בקשה לשרת לבצע פעולה מסוימת (כמו יצירה, אחזור, עדכון או מחיקה של משאב), והשרת מבצע את הפעולה ושולח תגובה – לרוב בצורת ייצוג של המשאב שצוין.

בממשקי RESTful API של Google, הלקוח מציין פעולה באמצעות פועל של HTTP כמו POST,‏ GET,‏ PUT או DELETE. הוא מציין משאב לפי URI ייחודי גלובלי, באופן הבא:

https://www.googleapis.com/apiName/apiVersion/resourcePath?parameters

בגלל שלכל משאבי ה-API יש מזהה URI ייחודי שניתן לגשת אליו באמצעות HTTP,‏ ב-REST אפשר לשמור נתונים במטמון והוא מותאם לעבודה עם התשתית המבוזרת של האינטרנט.

תוכלו להיעזר בהגדרות השיטה במסמכי התיעוד של תקני HTTP 1.1 – הן כוללות מפרטים של GET,‏ POST,‏ PUT ו-DELETE.

‫REST ב-Cloud Billing Budget API

הפעולות של Cloud Billing Budget API ממופות ישירות לפעלים מסוג REST HTTP.

אלה הם הפורמטים הספציפיים למזהי URI של Cloud Billing Budget API:

https://billingbudgets.googleapis.com/v1/resourcePath?parameters

הקבוצה המלאה של מזהי URI שמשמשים לכל פעולה נתמכת ב-API מסוכמת במסמכי העזר ל-Cloud Billing Budget API‏ (REST,‏ RPC).

העקרונות הבסיסיים של JSON

ה-Cloud Billing Budget API מחזיר נתונים בפורמט JSON.

JSON‏ (JavaScript Object Notation) הוא פורמט נתונים נפוץ בלתי תלוי בשפה, שמספק ייצוג טקסט פשוט של מבני נתונים שרירותיים. למידע נוסף היכנסו לאתר של json.org.