Mengaktifkan monetisasi Apigee

Halaman ini berlaku untuk Apigee dan Apigee hybrid.

Lihat dokumentasi Apigee Edge.

Sebelum dapat menggunakan monetisasi Apigee, Anda harus membeli dan mengaktifkannya di organisasi Anda. Perhatikan bahwa monetisasi Apigee saat ini tidak didukung untuk lingkungan Hybrid.

Membeli monetisasi Apigee

Untuk membeli monetisasi Apigee bagi organisasi berbasis langganan:

  1. Pastikan monetisasi Apigee disertakan dalam langganan Apigee Anda. Lihat Hak Apigee.
  2. Hubungi Penjualan Apigee untuk membeli monetisasi Apigee jika diperlukan.

Mengaktifkan monetisasi Apigee di organisasi Anda

Untuk mengaktifkan monetisasi Apigee di organisasi yang ada, buat permintaan POST ke API berikut, dengan meneruskan konfigurasi add-on dalam isi permintaan Anda:

https://apigee.googleapis.com/v1/organizations/$ORG:setAddons

Contoh:

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

Dengan $TOKEN ditetapkan ke token akses OAuth 2.0 Anda, seperti yang dijelaskan dalam Mendapatkan token akses OAuth 2.0. Untuk informasi tentang opsi curl yang digunakan dalam contoh ini, lihat Menggunakan curl. Untuk deskripsi variabel lingkungan yang digunakan, lihat Menetapkan variabel lingkungan untuk permintaan Apigee API.

Berikut adalah contoh respons yang menunjukkan bahwa operasi sedang berlangsung:

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

Untuk informasi selengkapnya, lihat Mengonfigurasi API add-on organisasi.

Lihat profil organisasi untuk mengonfirmasi bahwa monetisasi telah diaktifkan. Contoh:

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

Berikut adalah contoh respons yang menunjukkan bahwa monetisasi diaktifkan.

{
    "name": $ORG,
    ...
    "addonsConfig": {
    "monetizationConfig": {
      "enabled": true
    }
  }
}

Menonaktifkan monetisasi Apigee di organisasi Anda

Untuk menonaktifkan monetisasi Apigee di organisasi Anda, buat permintaan POST ke API berikut, dengan meneruskan konfigurasi add-on dalam isi permintaan Anda:

https://apigee.googleapis.com/v1/organizations/$ORG:setAddons

Contoh:

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

Berikut adalah contoh respons yang menunjukkan bahwa operasi sedang berlangsung:

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

Untuk informasi selengkapnya, lihat Mengonfigurasi API add-on organisasi.

Lihat profil organisasi untuk mengonfirmasi bahwa monetisasi telah dinonaktifkan. Contoh:

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

Berikut adalah contoh respons yang menunjukkan bahwa monetisasi diaktifkan.

{
    "name": $ORG,
    ...
    "addonsConfig": {
    "monetizationConfig": {
      "enabled": false
    }
  }
}

Memecahkan masalah pengaktifan monetisasi Apigee

Jika Anda belum membeli monetisasi Apigee dan mencoba mengaktifkannya, error berikut akan ditampilkan:

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