הגדרת דיווח על שימוש ל-Google

אם בחרתם בתמחור לפי שימוש במוצר, אתם צריכים לדווח על השימוש באפליקציה ל-Service Control API.

למבוא ל-Service Control, ראו את המדריך למתחילים.

לפני שמתחילים

(לתמחור לפי שימוש) דיווח על שימוש

כשיוצרים זכאות, צריך להפעיל את 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_ACTIVATED
  • BILLING_DISABLED
  • PROJECT_DELETED