אם בחרתם בתמחור לפי שימוש במוצר, אתם צריכים לדווח על השימוש באפליקציה ל-Service Control API.
למבוא ל-Service Control, ראו את המדריך למתחילים.
לפני שמתחילים
- מגדירים גישה ל-Cloud Commerce Partner Procurement API, כמו שמתואר במאמר שילוב האפליקציה.
- מומלץ להשתמש בפורטל התוכן כדי ליצור חשבון שירות לשימוש עם Service Control API.
(לתמחור לפי שימוש) דיווח על שימוש
כשיוצרים זכאות, צריך להפעיל את Partner Procurement API כדי לאחזר usageReportingId באמצעות בקשת HTTP GET הבאה:
GET v1/providers/YOUR_PARTNER_ID/entitlements/ENTITLEMENT_ID
התגובה מכילה מידע על ההרשאה, בפורמט הבא:
{ "name": "providers/YOUR_PARTNER_ID/entitlements/ENTITLEMENT_ID", "provider": "YOUR_PARTNER_ID", "account": "USER_ACCOUNT_ID", "product": "example-messaging-service", "plan": "pro", "usageReportingId": "USAGE_REPORTING_ID", "state": "ENTITLEMENT_ACTIVATION_REQUESTED", "updateTime": "...", "createTime": "..." }
כדי לדווח על השימוש, קודם צריך לבצע קריאה ל-API services.check כדי לבדוק את הגדרות השירות. אם האובייקט checkErrors[] ריק בתגובה, צריך לבצע קריאה ל-API services.report כדי לשלוח את דוח השימוש.
דוח השימוש הוא Operation של Service Control API.
זו דוגמה לדוח שימוש ב-example-messaging-service ששולח מידע על נפח האחסון שהלקוח משתמש בו:
POST https://servicecontrol.googleapis.com/v1/services/example-messaging-service.gcpmarketplace.example.com:report
{ "operations": [{ "operationId": "1234-example-operation-id-4567", "operationName": "Hourly Usage Report", "consumerId": "USAGE_REPORTING_ID", "startTime": "2019-02-06T12:00:00Z", "endTime": "2019-02-06T13:00:00Z", "metricValueSets": [{ "metricName": "example-messaging-service/UsageInGiB", "metricValues": [{ "int64Value": "150" }] }], "userLabels": { "cloudmarketplace.googleapis.com/resource_name": "order_history_cache", "cloudmarketplace.googleapis.com/container_name": "storefront_prod", "environment": "prod", "region": "us-west2" } }] }
where:
-
operationIdהיא מחרוזת ייחודית שנוצרת על ידי מופע השירות שלכם. צריך להשתמש באותוoperationIdלפעולותcheckו-report. - הערך של
consumerIdזהה לערך שלusageReportingIdמההרשאה. -
startTimeו-endTimeמייצגים את זמני ההתחלה והסיום של המרווח הכולל של הפעולהreport. ברוב המקרים, הערך שלstartTimeבפעולתreportצריך להיות זהה לערך שלendTimeבפעולתreportהקודמת. אם השירות של לקוח מושבת לפניstartTimeשל פעולתreport, קריאה ל-API שלservices.checkשולחת שגיאה באובייקטcheckErrors[], והלקוח לא מחויב על המרווח המתאים. MetricValueSetכולל מרווחי זמן ביניים אחד או יותר וערכי מדדים מעודכנים תואמים. אתם מגדירים את מדדי השירות כשאתם בוחרים ומגישים את מודל התמחור. אפשר לראות את המזהים של המדדים בקטע Technical integration ב-Producer Portal.-
userLabelsהן תוויות שנוצרו על ידי משתמשים, ומוגדרות כמחרוזות של צמדי מפתח/ערך שצריכות לעמוד בדרישות תחביר ספציפיות. התוויות האלה מועברות לכלים של ניהול עלויות בחיוב ב-Cloud לצורך שיוך. המלצות שקשורות לתוויות שימוש מפורטות במאמר שיטות מומלצות לשימוש בתוויות.
אם services.check API מחזיר אחת או יותר מהשגיאות הבאות, מומלץ להפסיק לספק את השירות ללקוח עד שהשגיאה תיפתר:
SERVICE_NOT_ACTIVATEDBILLING_DISABLEDPROJECT_DELETED