דרישות מוקדמות

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

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

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

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

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

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

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

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

‫‏REST ב-Cloud Billing API

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

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

https://www.googleapis.com/billing/v1/resourcePath?parameters

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

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

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

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