Mengaktifkan monetisasi Apigee

Halaman ini berlaku untuk Apigee dan Apigee Hybrid.

Baca dokumentasi Apigee Edge.

Sebelum dapat menggunakan monetisasi Apigee, Anda harus membeli dan mengaktifkannya di organisasi Anda.

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 Bagian Penjualan Apigee untuk membeli monetisasi Apigee jika diperlukan.

Mengaktifkan monetisasi Apigee di organisasi Anda

Untuk mengaktifkan monetisasi Apigee di organisasi yang sudah ada, berikan 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, seperti yang dijelaskan dalam Mendapatkan token akses OAuth 2.0. Untuk mengetahui informasi tentang opsi curl yang digunakan dalam contoh ini, lihat Menggunakan curl. Untuk deskripsi tentang 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 ini 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, berikan 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 ini 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 muncul:

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