לפני שמתחילים לתכנת את אפליקציית התקציב הראשונה בחיוב ב-Cloud, יש כמה דברים שצריך לעשות – אם עדיין לא עשיתם אותם.
התנסות עם המאפיינים לחיוב ב-Cloud במסוף Google Cloud
מאמרי העזרה של ה-API מבוססים על ההנחה שכבר השתמשתם ב- Google Cloud, ושאתם מכירים את המאפיינים והמושגים שקשורים לחיוב ב-Cloud במסוף Google Cloud . אם אתם עדיין לא מתמצאים במושגים כמו חשבונות לחיוב ב-Cloud, פרויקטים ב- Google Cloud , מוצרי Google Cloudותקציבים והתראות בחיוב ב-Cloud, כדאי לכם לקרוא את המאמרים הבאים לפני שתתחילו לתכנת:
- סקירה כללית על המושגים של חיוב ב-Cloud
- ניהול החשבון לחיוב ב-Cloud
- הצגת הפרויקטים שמקושרים לחשבון לחיוב ב-Cloud
- תקציבים וכללים להתראות לתקציבים
- בקרת גישה ל-Cloud Billing Budget API
אחרי שתכירו את המאפיינים והמושגים של חיוב ב-Cloud, תוכלו לנסות את ממשק המשתמש של מסוף .
מושגי מפתח בנושא חיוב ב-Cloud
- לכל חשבון לחיוב ב-Cloud יכולים להיות משויכים אלפי תקציבים בכל רגע נתון. בדף Quotas and limits תוכלו לקרוא פרטים נוספים ומידע על המגבלות הקיימות.
- תקציב מקושר רק לחשבון אחד לחיוב ב-Cloud בכל רגע נתון.
- כל חשבון לחיוב ב-Cloud יכול להיות מקושר לכמה פרויקטים ב-Google Cloud , והתשלום עליהם מתבצע דרכו.
- כל פרויקט ב- Google Cloud יכול להיות מקושר רק לחשבון אחד לחיוב ב-Cloud.
- אתם יכולים ליצור תקציב כדי לעקוב אחרי העלויות בכל החשבון לחיוב ב-Cloud, כולל כל הפרויקטים ב- Google Cloud שהתשלום עליהם הוא באמצעות אותו חשבון לחיוב. תוכלו גם להגדיר את היקף התקציב באמצעות מסנני תקציב מפורטים, וכך לעקוב אחרי היבטים מסוימים של העלויות. המסננים יכולים להיות פרויקטים ב- Google Cloud , שירותים, תקופת התקציב ואפשרויות סינון אחרות שרלוונטיות לחשבון לחיוב ב-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.