Google は AI 技術を使用して、コンテンツをご希望の言語に翻訳しています。AI 翻訳には誤りが含まれる場合があります。

組織プロフィールを管理する

Apigee Edge のドキュメントを表示しています。
Apigee X のドキュメントに移動します。情報

以降のセクションでは、組織プロファイルについて説明し、UI と API を使用して組織プロファイルを管理する方法について説明します。

組織のプロフィールについて

収益化の初期設定の一環として、Apigee Edge 構成チームが組織プロファイルを設定します。

必要に応じて、組織のプロフィールを編集して、組織に関する情報を追加または更新する必要があります。たとえば、請求タイプ、通貨設定、税モデルの更新が必要になることがあります。

組織に関する基本情報を構成します。

組織名、住所、事業を行っている国
請求タイプの概要で説明されている請求タイプ（前払い、後払い、または両方）
請求期間（日割り計算またはカレンダー月）
基本通貨
組織で使用されている税モデル

以降のセクションで説明するように、UI と API を使用して組織プロファイルを管理できます。

[組織のプロファイル] ページについて

下記の手順に沿って [Organization Profile] ページにアクセスします。

エッジ

Edge UI を使用して [組織プロフィール] ページにアクセスするには:

apigee.com/edge にログインします。
左側のナビゲーションバーで、[公開] > [収益化] > [組織のプロフィール] を選択します。

[Organization Profile] ページが表示されます。

図でハイライト表示されているように、[組織プロフィールページ] では次の操作を行うことができます。

現在の組織プロファイルの設定を表示する
組織プロファイルの設定を編集します。編集できる設定は次のとおりです。
- 名前と情報
- 税金と通貨
- 利用規約の管理で説明されている利用規約

Classic Edge（Private Cloud）

Classic Edge UI を使用して [Organization Profile] ページにアクセスするには:

http://ms-ip:9000 にログインします。ms-ip は Management Server ノードの IP アドレスまたは DNS 名です。
上部のナビゲーションバーで [Admin] > [Organization Profile] を選択します。

[Organization Profile] ページが表示されます。

[組織のプロフィール] ページでは、次のことができます。

現在の組織プロファイルの設定を表示する
組織プロファイルの設定を編集します。編集できる設定は次のとおりです。
- 名前と情報
- 税金と通貨
- 利用規約の管理で説明されている利用規約

UI を使用して組織プロファイルを編集する

UI を使用して組織プロファイルを編集するには:

組織のプロフィールページにアクセスします。
[編集] をクリックします。
[名前と情報] で、組織名と運営国を編集します。

[税金と通貨] で、次のフィールドを編集します。

フィールド	説明
税金モデル	注: 収益分配率プランを設定し、請求書を作成する場合にのみ適用されます。必要な請求書の種類を特定する収益分配料金プランの税モデル。有効な値は次のとおりです。開示: API プロバイダがデベロッパーの開示代理人として行動します。エンドユーザーから徴収した総収益（売上税を含む）はデベロッパーに渡されます。API プロバイダのコミッションは、コミッション請求書の形式でデベロッパーから徴収されます。API プロバイダはエンドユーザーから徴収した売上税を処理しません。売上税の報告はデベロッパーの責任となります。非開示: API プロバイダはデベロッパーの非開示代理人として、エンドユーザーから徴収した税金を控除し、地方税務当局に支払います。デベロッパーは、デベロッパーに支払われる純収益の分配額（売上税と API プロバイダの手数料を差し引いた額）を API プロバイダに請求します。ハイブリッド: API プロバイダがデベロッパーの開示代理人として行動します。ただし、API プロバイダは、契約者から集めた売上税をデベロッパーに代わって地方税務当局に支払います。API プロバイダは、残りの収益をデベロッパーに渡し、コミッション料金の請求書を発行します。
通貨	組織がサポートしている通貨。収益分配、料金表、手数料のみのプランでは、料金プランにデフォルトの通貨が使用されます。レートカードまたは手数料のみのプランを作成する際に、サポートされている通貨のリストから選択して、使用する通貨を変更できます。必要に応じて、アプリデベロッパーが前払いアカウントの残高に追加できる最小チャージ額を通貨ごとに設定できます。通貨を追加するには: [通貨を追加] をクリックします。 [Currency] フィールドのプルダウンメニューから通貨を選択します。必要に応じて、アプリデベロッパーが指定した通貨で前払いアカウントの残高に追加できる最小額を [最小チャージ額] フィールドに設定します。 [追加] をクリックします。関連するラジオボタンをクリックして、必要に応じてデフォルトの通貨として設定します。手順を繰り返して、通貨を追加します。通貨を削除するには、削除する通貨にカーソルを合わせてをクリックします。警告: アプリデベロッパーまたは料金プランで使用されている通貨は削除できません。

フィールド

説明

税金モデル

注: 収益分配率プランを設定し、請求書を作成する場合にのみ適用されます。

必要な請求書の種類を特定する収益分配料金プランの税モデル。

有効な値は次のとおりです。

開示: API プロバイダがデベロッパーの開示代理人として行動します。エンドユーザーから徴収した総収益（売上税を含む）はデベロッパーに渡されます。API プロバイダのコミッションは、コミッション請求書の形式でデベロッパーから徴収されます。API プロバイダはエンドユーザーから徴収した売上税を処理しません。売上税の報告はデベロッパーの責任となります。
非開示: API プロバイダはデベロッパーの非開示代理人として、エンドユーザーから徴収した税金を控除し、地方税務当局に支払います。デベロッパーは、デベロッパーに支払われる純収益の分配額（売上税と API プロバイダの手数料を差し引いた額）を API プロバイダに請求します。
ハイブリッド: API プロバイダがデベロッパーの開示代理人として行動します。ただし、API プロバイダは、契約者から集めた売上税をデベロッパーに代わって地方税務当局に支払います。API プロバイダは、残りの収益をデベロッパーに渡し、コミッション料金の請求書を発行します。

通貨

組織がサポートしている通貨。収益分配、料金表、手数料のみのプランでは、料金プランにデフォルトの通貨が使用されます。レートカードまたは手数料のみのプランを作成する際に、サポートされている通貨のリストから選択して、使用する通貨を変更できます。必要に応じて、アプリデベロッパーが前払いアカウントの残高に追加できる最小チャージ額を通貨ごとに設定できます。

通貨を追加するには:

[通貨を追加] をクリックします。
[Currency] フィールドのプルダウンメニューから通貨を選択します。
必要に応じて、アプリデベロッパーが指定した通貨で前払いアカウントの残高に追加できる最小額を [最小チャージ額] フィールドに設定します。
[追加] をクリックします。
関連するラジオボタンをクリックして、必要に応じてデフォルトの通貨として設定します。
手順を繰り返して、通貨を追加します。

通貨を削除するには、削除する通貨にカーソルを合わせてをクリックします。

UI を使用して利用規約を管理するで説明されているように、利用規約を管理します。
[保存] をクリックします。

API を使用して組織プロファイルを管理する

以降のセクションで説明するように、API を使用して組織プロファイルを管理します。

API を使用して組織のプロファイルを表示する

組織のプロフィールを表示するには、/mint/organizations/{org_name} に GET リクエストを発行します。次に例を示します。

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

レスポンスの例を次に示します。表示されるオプションの詳細については、API の組織プロファイル構成プロパティをご覧ください。

{
    "address" : [ {
      "address1" : "Test address”,
      "city" : "Test City",
      "country" : "US",
      "id" : "test-address",
      "isPrimary" : true,
      "state" : "CA",
      "zip" : "54321"
    } ],
    "approveTrusted" : false,
    "approveUntrusted" : false,
    "billingCycle" : "CALENDAR_MONTH",
    "country" : "US",
    "currency" : "USD",
    "description" : "Test organization",
    "hasBillingAdjustment" : true,
    "hasBroker" : false,
    "hasSelfBilling" : false,
    "hasSeparateInvoiceForProduct" : false,
    "id" : "{org_name}"
    "issueNettingStmt" : false,
    "logoUrl" : " https://dl.dropboxusercontent.com/u/48279818/LOGOS/testorg.jpeg",
    "name" : "myorg",
    "nettingStmtPerCurrency" : false,
    "regNo" : "RegNo-1234-myorg",
    "selfBillingAsExchOrg" : false,
    "selfBillingForAllDev" : false,
    "separateInvoiceForFees" : true,
    "status" : "ACTIVE",
    "supportedBillingType" : "PREPAID",
    "taxModel" : "UNDISCLOSED",
    "taxRegNo" : "TaxRegNo-1234-myorg",
    "timezone" : "UTC"
}

API を使用して組織プロファイルを編集する

/mint/organizations/{org_name} に PUT リクエストを発行して、組織プロファイルを編集します。組織プロファイルを編集するときは、編集するプロパティだけでなく、組織プロファイルのすべてのプロパティを指定する必要があります。

組織のデフォルトの通貨を編集するには、currency の値を、デフォルトとして設定するサポート対象の通貨の ISO 4217 通貨コードに設定します。

たとえば、次の API 呼び出しは、currency を USD に、税モデルの設定を HYBRID に更新します（更新されたフィールドは例でハイライト表示されています）。表示されるオプションの詳細については、API の組織プロファイル構成プロパティをご覧ください。

curl -X PUT "https://api.enterprise.apigee.com/v1/mint/organizations/{org_name}" \
  -H "Content-Type: application/json" \
  -d '{
  "address" : [ { 
    "address1" : "Test address”,
    "city" : "Test City",
    "country" : "US",
    "id" : "corp-address",
    "isPrimary" : true,
    "state" : "CA",
    "zip" : "54321"
  } ], 
  "approveTrusted" : false, 
  "approveUntrusted" : false, 
  "billingCycle" : "CALENDAR_MONTH", 
  "country" : "US", 
  "currency" : "USD", 
  "description" : "Test organization", 
  "hasBillingAdjustment" : true, 
  "hasBroker" : false, 
  "hasSelfBilling" : false, 
  "hasSeparateInvoiceForProduct" : false,
  "id" : "myorg", 
  "issueNettingStmt" : false, 
  "logoUrl" : "https://dl.dropboxusercontent.com/u/48279818/LOGOS/testorg.jpeg",
  "name" : "{org_name}", 
  "nettingStmtPerCurrency" : false, 
  "regNo" : "RegNo-1234-myorg", 
  "selfBillingAsExchOrg" : false, 
  "selfBillingForAllDev" : false, 
  "separateInvoiceForFees" : false, 
  "status" : "ACTIVE", 
  "supportedBillingType" : "POSTPAID",
  "taxModel" : "HYBRID", 
  "taxRegNo" : "TaxRegNo-1234-myorg", 
  "timezone" : "UTC" 
}' \

-u email:password

API を使用して前払いと後払いの課金タイプを構成する

デベロッパーアカウントは、前払い、後払い、またはその両方の課金タイプを使用するように構成できます。

前払いアカウントを使用すると、デベロッパーは API の使用料金を前払いします。資金は、統合された決済機関を通じて維持されるデベロッパーのプリペイド残高から差し引かれます。デベロッパーは、API を購入するのに十分なプリペイド残高を維持する必要があります。

後払いアカウントの場合、デベロッパーは月末に毎月請求書で請求されます。デベロッパーは、請求書に含まれるプランで設定された支払い条件に基づいて、API プロダクトの使用料を支払います。

組織のプリペイドとポストペイドの請求タイプを構成するには、supportedBillingType プロパティを PREPAID、POSTPAID、BOTH のいずれかの値に設定して、有効な請求タイプを指定します。値を BOTH に設定すると、アプリデベロッパーまたは会社を追加する際のデフォルトは PREPAID になります。この場合、会社とアプリデベロッパーの管理で説明されているように、API を使用して会社またはアプリデベロッパーの請求タイプを明示的に設定できます。

次に例を示します。

curl -X PUT "https://api.enterprise.apigee.com/v1/mint/organizations/{org_name}" \
  -H "Content-Type: application/json" \
  -d '{
  "address" : [ {
    "address1" : "Test address",
    "city" : "Test City",
    "country" : "US",
    "id" : "corp-address",
    "isPrimary" : true,
    "state" : "CA",
    "zip" : "54321"
  } ],
  "approveTrusted" : false,
  "approveUntrusted" : false,
  "billingCycle" : "CALENDAR_MONTH",
  "country" : "US",
  "currency" : "USD",
  "description" : "Test organization",
  "hasBillingAdjustment" : true,
  "hasBroker" : false,
  "hasSelfBilling" : false,
  "hasSeparateInvoiceForProduct" : false,
  "id" : "myorg",
  "issueNettingStmt" : false,
  "logoUrl" : "https://dl.dropboxusercontent.com/u/48279818/LOGOS/testorg.jpeg",
  "name" : "{org_name}",
  "nettingStmtPerCurrency" : false,
  "regNo" : "RegNo-1234-myorg",
  "selfBillingAsExchOrg" : false,
  "selfBillingForAllDev" : false,
  "separateInvoiceForFees" : false,
  "status" : "ACTIVE",
  "supportedBillingType" : "POSTPAID",
  "taxModel" : "HYBRID",
  "taxRegNo" : "TaxRegNo-1234-myorg",
  "timezone" : "UTC"
  }' \
  -u email:password

API を使用して請求期間を構成する

組織の請求期間を構成するには、billingCycle プロパティを次のいずれかの値に設定します。

PRORATED: API を使用した当月の日数に基づいて請求が行われます。
CALENDAR_MONTH: 月単位で請求が行われます。