デベロッパーの収益化への移行

<ph type="x-smartling-placeholder"></ph> 現在、Apigee Edge のドキュメントが表示されています。
Apigee X のドキュメント
詳細

既存のデベロッパーが Monetization に移行する必要がある場合:

  1. 担当するデベロッパーの API プロダクト、API パッケージ、料金プランを作成する 自動的に移行されます。詳細については、次をご覧ください。 <ph type="x-smartling-placeholder">
  2. 料金プランの公開の説明に沿って、料金プランを公開します。
  3. アプリ デベロッパーを登録するの説明に沿って、新しいデベロッパーを組織に追加します。
  4. 前払いアカウントの管理の説明に沿って、各デベロッパーの前払い残高をチャージします。 残高
  5. 購入率の説明に沿って、料金プランに同意します。 API を使用してプランを作成します

    : すでにデベロッパーへの請求が行われている場合に設定料を免除するには、 waivefees クエリ パラメータを true に追加する。

  6. 移行するデベロッパーに既存のトランザクションがある場合は、 次のリソースを使用して、トランザクションの使用状況を手動で転送できます。
    /organizations/{org_name}/transactions{org_name} は 組織名を入力します。

    注: デベロッパーに既存の取引がない場合は、この手順をスキップできます。 示します。

    transactions リソースは、 新しい値を反映するようにすべての内部カウンタを更新します。

    たとえば、移行前にデベロッパーが 1,000 回の API 呼び出しを発行した場合、 現在のアクティビティをキャプチャするには、 transactions リソースを作成し、batchSize プロパティを 1,000 に設定します。 作成します。

    次の表に、Google Cloud コンソールで指定できる構成プロパティ トランザクションの数、デフォルト値、トランザクションの有無を 必須ではありません。

    プロパティ 説明 デフォルト 必須
    application

    デベロッパー アプリの ID。

    なし
    batchSize

    転送するトランザクションの数。

    1 いいえ
    custAttn

    カスタム属性の値。batchSize で トランザクションの使用状況を表します。

    メッセージのカスタム属性番号は正の整数で指定してください または、小数点(小数点以下は 4 桁まで)の値。負の値は使用できません。

    カスタム属性は次の場所で定義する必要があります。

    なし
    product

    API プロダクトの ID。

    なし
    type

    CHARGE(デフォルト)に設定する必要があります。

    CHARGE いいえ

    検証手順をスキップしてトランザクション数を強制的に設定するには、 force クエリ パラメータを true にマッピング(例: ?force=true)。デフォルトでは、?force=false と検証ステップは 実行されます。(例: 前払いデベロッパーのアカウントの残高とアクティビティがない場合) 一時停止され、?force=false の場合、リクエストは検証中に失敗します。

    たとえば、次のリクエストでは、指定されたトランザクションのトランザクション数を 50 に設定しています。 API プロダクト:

    $ curl -H "Content-Type:application/json" -X POST -d \
    '{ 
       "application":{
         "id":"6a9b1afc-2110-43d6-bae7-1b137aecb05b"
       },
       "product":{
         "id":"testproduct"
       },
       "batchSize":50
    }' \
    "https://api.enterprise.apigee.com/v1/mint/organizations/myOrg/transactions" \
    -u email:password
    

    次のリクエストでは、指定したアプリケーションのトランザクション使用量を 12.5 に設定しています。 API プロダクト。リクエストでは、batchSize125 に設定され、値が API プロダクトに定義された最初のカスタム属性が、0.1 に設定されます。日時 掛け合わせると、125 × 0.1 は 12.5 です。

    $ curl -H "Content-Type:application/json" -X POST -d \
    '{ 
       "application":{
         "id":"6a9b1afc-2110-43d6-bae7-1b137aecb05b"
       },
       "product":{
         "id":"testproduct"
       },
       "batchSize": 125,
       "custAtt1" : 0.1
    }' \
    "https://api.enterprise.apigee.com/v1/mint/organizations/myOrg/transactions" \
    -u email:password
    
  7. 必要な設定料金や定期的な料金がデベロッパーに請求されていない場合は、手動で 次のリソースを使用して、料金プランの設定料金または定期的な料金を請求します。
    /organizations/{org_name}/transactions{org_name} は 組織名を入力します。

    注: セットアップ料金や定期的な料金がデベロッパーにすでに請求されている場合は、 スキップしますtransactions リソースを呼び出しても、設定や 定期的な料金の支払いが発生します。

    次の表に、Google Cloud コンソールで指定できる構成プロパティ リクエスト本文は、料金プランの設定料金または定期的な料金を手動で請求します。 必須かどうかを指定できます

    プロパティ 説明 デフォルト 必須
    currency

    料金プランで使用される通貨。通貨の ISO 4217 コードを指定します(例: 米ドルの場合は usd、スイス フランの場合は chf です。

    なし
    developer

    デベロッパーの ID。

    なし
    rate

    設定料金または定期的な請求料金。

    なし
    ratePlan

    料金プランの ID。

    なし
    type

    SETUPFEES または RECURRINGFEES に設定します。

    CHARGE

    検証手順をスキップして料金を強制的に請求するには、force クエリを設定します。 パラメータを true に設定します(例: ?force=true)。デフォルトでは ?force=false と検証ステップが実行されます。たとえば、前払いの デベロッパーの残高がゼロで、そのアカウントに対するアクティビティが強制停止される場合、 ?force=false: 検証中にリクエストが失敗します。

    たとえば、次のリクエストでは、セットアップ料金として 10 米ドルが請求されます。 料金プランに登録したデベロッパー:

    $ curl -H "Content-Type:application/json" -X POST -d \
    '{ 
       "developer":{
         "id":"dev1@myorg.com"
       },
       "currency":{
         "id":"usd"
       },
       "ratePlan":{
         "id":"mypackage_rateplan1"
       },   
       "rate":10,
       "type":"SETUPFEES"
    }' \
    "https://api.enterprise.apigee.com/v1/mint/organizations/myOrg/transactions" \
    -u email:password