הפעלת מונטיזציה ב-Apigee

הדף הזה רלוונטי ל-Apigee ול-Apigee Hybrid.

לעיון במסמכי התיעוד של Apigee Edge

כדי להשתמש במונטיזציה של Apigee, צריך לרכוש אותה ולהפעיל אותה בארגון. יש תמיכה במונטיזציה ב-Apigee בסביבות Apigee ו-Apigee Hybrid.

רכישת מונטיזציה של Apigee

כדי לרכוש את Apigee monetization עבור ארגונים עם מינוי, צריך לפנות אל צוות המכירות של Apigee ואז להפעיל את Apigee monetization בארגון.

המונטיזציה של Apigee לא זמינה בארגונים עם תשלום לפי שימוש.

ארגוני הערכה של Apigee כוללים באופן אוטומטי תקופת ניסיון של Apigee למונטיזציה, למשך תקופת הניסיון. אין צורך לפנות למחלקת המכירות של Apigee כדי להוסיף מונטיזציה. ממשיכים אל הפעלת מונטיזציה של Apigee בארגון.

הפעלת מונטיזציה של Apigee בארגון

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

https://apigee.googleapis.com/v1/organizations/ORG_NAME:setAddons

לדוגמה: 

curl "https://apigee.googleapis.com/v1/organizations/ORG_NAME:setAddons" \
  -X POST \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-type: application/json" \
  -d '{
    "addonsConfig": {
      "monetizationConfig": {
          "enabled": "true"
      }
      <Include existing add-on configuration>
    }
  }'

‫$TOKEN מוגדר לאסימון הגישה מסוג OAuth 2.0, כפי שמתואר במאמר קבלת אסימון גישה מסוג OAuth 2.0. מידע על האפשרויות curl שבהן נעשה שימוש בדוגמה הזו מופיע במאמר שימוש ב-curl. תיאור של משתני הסביבה שבהם אפשר להשתמש מופיע במאמר בנושא הגדרת משתני סביבה לבקשות API של Apigee.

בדוגמה הבאה אפשר לראות את התגובה שמציינת שהפעולה מתבצעת: 

{
  "name": "organizations/ORG_NAME/operations/1ae3ed56-b38f-4cc1-ba33-e7d89557075d",
  "metadata": {
    "@type": "type.googleapis.com/google.cloud.apigee.v1.OperationMetadata",
    "operationType": "UPDATE",
    "targetResourceName": "organizations/ORG_NAME",
    "state": "IN_PROGRESS"
  }
}

מידע נוסף זמין במאמר הגדרת API של תוספים לארגון.

צפייה בפרופיל הארגון כדי לוודא שהמונטיזציה הופעלה. לדוגמה: 

curl "https://apigee.googleapis.com/v1/organizations/ORG_NAME" \
  -X GET \
  -H "Authorization: Bearer $TOKEN"

בדוגמה הבאה אפשר לראות את התגובה שמתקבלת כשמופעלת מונטיזציה. 

{
    "name": ORG_NAME,
    ...
    "addonsConfig": {
    "monetizationConfig": {
      "enabled": true
    }
  }
}

השבתת המונטיזציה של Apigee בארגון

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

https://apigee.googleapis.com/v1/organizations/ORG_NAME:setAddons

לדוגמה: 

curl "https://apigee.googleapis.com/v1/organizations/ORG_NAME:setAddons" \
  -X POST \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-type: application/json" \
  -d '{
    "addonsConfig": {
      "monetizationConfig": {
          "enabled": "false"
      }
     <Include existing add-on configuration>
    }
  }'

בדוגמה הבאה אפשר לראות את התגובה שמציינת שהפעולה מתבצעת: 

{
  "name": "organizations/ORG_NAME/operations/06274ffb-8940-41da-836d-781cba190437",
  "metadata": {
    "@type": "type.googleapis.com/google.cloud.apigee.v1.OperationMetadata",
    "operationType": "UPDATE",
    "targetResourceName": "organizations/ORG_NAME",
    "state": "IN_PROGRESS"
  }
}

מידע נוסף זמין במאמר בנושא הגדרת API של תוספים לארגון.

צפייה בפרופיל הארגון כדי לוודא שהמונטיזציה הושבתה. לדוגמה: 

curl "https://apigee.googleapis.com/v1/organizations/ORG_NAME" \
  -X GET \
  -H "Authorization: Bearer $TOKEN"

בדוגמה הבאה אפשר לראות את התגובה שמתקבלת כשמופעלת מונטיזציה. 

{
    "name": ORG_NAME,
    ...
    "addonsConfig": {
    "monetizationConfig": {
      "enabled": false
    }
  }
}

פתרון בעיות בהפעלת מונטיזציה ב-Apigee

אם לא רכשתם את Apigee monetization ואתם מנסים להפעיל אותה, מוחזרת השגיאה הבאה:

{
  "error": {
    "code": 400,
    "message": "failed to validate addons config: [Apigee Monetization] addon(s) are not entitled to the subscription",
    "status": "FAILED_PRECONDITION"
  }
}