Edge を使用した企業とデベロッパーの管理

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

収益化に参加する企業やデベロッパーをより細かく管理したい場合は、 たとえば、API プログラムのために内製開発の会社やデベロッパーを作成する場合に、 管理 UI を使用して会社とデベロッパーを手動で作成できます。 API

会社とデベロッパーを手動で作成する必要があるかどうかを決定する主な考慮事項は、 デベロッパーが管理 UI へのログインに認証情報を必要とするかどうか、 認証情報を指定するか、デベロッパー ポータルにログインします。

• 収益化開発者が Edge UI または API にアクセスするためにログイン認証情報が必要な場合は、まず独自の認証情報を用意する必要があります。 Apigee 管理者アカウント。
• 認証情報を必要としないテスト デベロッパーを作成する必要がある場合（たとえば、 （架空のテスト デベロッパーと API 呼び出しを行う場合）に、Apigee アカウントは 必要ありません。

UI を使用したアプリ デベロッパーの管理

アプリ デベロッパーの管理で説明されているように、Edge UI を使用してアプリ デベロッパーの作成、管理、有効化を行います。 アプリ デベロッパーを作成したら、以下のセクションで説明するように、そのデベロッパーを会社に追加できます。

UI を使用して会社を管理する

ここでは、会社の作成、管理、有効化について説明します。

[Companies] ページにアクセスする

次の手順で [Companies] ページにアクセスします。

会社を追加する

会社を追加するには:

1. [Companies] ページにアクセスします。
2. [+ Company] をクリックします。
3. 会社の詳細を入力します。

   必須フィールドは次のとおりです。

   • 会社名
   • 管理者（メインの会社であるユーザー） 管理者）
   • 請求タイプ

   収益化の課金構成によっては、請求タイプはデフォルトで PREPAID または POSTPAID。詳しくは、API を使用して前払いと後払いの課金タイプを構成するをご覧ください。

4. 1 人以上のデベロッパーを会社に追加します。
   1. [Developers] セクションで、[Add Developer] フィールドに文字列を入力して、その文字列に一致するデベロッパーのリストを表示します。
   2. プルダウン リストからデベロッパーを選択します。
   3. デベロッパーをさらに会社に追加する場合は、この手順を繰り返します。
5. カスタム属性を 1 つ以上追加します。
   1. [Custom attributes] セクションで [+ New] をクリックします。
   2. カスタム属性の名前と値を入力します。
   3. 会社にさらにカスタム属性を追加するには、この手順を繰り返します。
6. [Create company]（会社を作成）をクリックします。

会社のアクティブ化と非アクティブ化

会社を有効または無効にするには:

1. [Company] ページにアクセスします。
2. 有効にする会社にカーソルを合わせて、操作メニューで を有効にします。
   会社を無効にするには、切り替えボタンを無効にします。

会社を編集する

会社を編集するには:

1. [Company] ページにアクセスします。
2. 編集する会社にカーソルを合わせて、操作メニューの をクリックします。
3. 必要に応じて会社の詳細を更新します。
4. [Update company] をクリックして変更を保存します。

会社を削除する

会社を削除するには:

1. [Companies] ページにアクセスします。
2. 削除する会社にカーソルを合わせて、操作メニューの をクリックします。
3. [削除] をクリックして削除の操作を確定します。

API を使用して会社とデベロッパーを管理する

以降のセクションでは、API を使用して会社とデベロッパーを管理する方法について説明します。

API を使用して会社とデベロッパーを作成および更新する

API Edge Management API を使用して会社とデベロッパーを管理するには、次の API セクションをご覧ください。

• 会社を作成する
• デベロッパーを作成する
  注: デベロッパーを作成するときに、カスタム属性を渡して収益化情報を構成します。
• 追加または 会社のデベロッパーを更新
  注: 必要に応じて、デベロッパーにロールを割り当てることができますが、必須ではありません。リストを取得するには、 デベロッパーのロールについては、デベロッパーのロールの取得をご覧ください。
• すべてのデベロッパーまたは単一のデベロッパーの収益化構成を一覧表示する
  注: 次の場合はカスタム属性を渡して収益化情報を定義します。 作成または 開発者を更新します。 標準（非収益化）API を使用して設定された収益化カスタム属性を表示して、一覧表示できます。 すべてのデベロッパーまたは 単一のデベロッパー

API を使用したデベロッパー ロールの管理

ロールは Monetization API を使用して作成できます。これにより、サービス アカウントに対するロールを 共有しますたとえば、特定の組織に対して管理者ロールとアプリケーション デベロッパー ロールを 共有しますこれらのロールはその後、パートナー様の特定の従業員に割り当てることができます。

デベロッパー ロールを作成する

デベロッパーのロールを作成するには、POST リクエストを organizations/{org_name}/developer-roles。このリクエストを行うには、 リクエストの本文でロールの名前と説明、 できます。例:

$ curl -H "Content-Type:application/json" -X POST -d \
'{
   "name": "appDeveloper",
   "description": "App Developer",
   "organization": {
       "id": "{org_name}" 
   }  
 }' \
"https://api.enterprise.apigee.com/v1/mint/organizations/{org_name}/developer-roles" \
-u email:password

デベロッパーのロールを取得する

デベロッパーのロールを取得するには、organizations/{org_id}/developer-roles に対して GET リクエストを発行します。 例:

$ curl -H "Accept:application/json" -X GET \
"https:// api.enterprise.apigee.com/v1/mint/organizations/{org_name}/developer-roles" \
-u email:password

レスポンスは次のようになります（レスポンスの一部のみが表示されています）。

{
  "description" : "App Developer",
  "id" : "appdeveloper",
  "name" : "appDeveloper",
  "organization" : {
   ...
  }
}

API のデベロッパー ロールの構成設定

API に公開されるデベロッパー ロールの構成オプションは次のとおりです。

API を使用してデベロッパーの税率を取得する

デベロッパーの現在の税率を取得するには、次の宛先に GET リクエストを発行します。 organizations/{org_name}/tax-engine。リクエストを行うときに、Terraform で クエリ パラメータとしてのデベロッパー ID を指定します。例:

$ curl -H "Accept:application/json" -X GET \
"https://api.enterprise.apigee.com/v1/mint/organizations/{org_name}/tax-engine?developerId=dev7@myorg.com" \
-u email:password

次のようなレスポンスが表示されます。

0.09

API を使用したその他のデベロッパー固有のタスクの実行

次のような、組織で実行できる収益化関連のタスクの多く。 通知条件の作成は、個々のユーザーに対しても 開発者です。たとえば、特定のデベロッパーの銀行口座を作成したり、 特定のデベロッパーの収益レポートを作成できます

次の表に、Cloud KMS を使用して実行できるデベロッパー固有のタスクを示します。 収益化 API を提供しています。この表には、実行するための詳細な手順も記載されています。 できます。