顧客を作成する

[アーティクル]
03/28/2024

適用対象: パートナーセンター | 21Vianet が運営するパートナーセンター | Microsoft Cloud for US Government のパートナーセンター

クラウドソリューションプロバイダー (CSP) パートナーは、顧客を作成するときに、顧客に代わって注文を行うことができます。顧客を作成する際には、次のものも作成します。

顧客の Microsoft Entra テナントオブジェクト
リセラーと顧客の間の関係 (委任された管理者特権に使用)
顧客の管理者としてサインインするためのユーザー名とパスワード

顧客が作成されたら、顧客 ID と Microsoft Entra ID の詳細を保存します。

重要

間接プロバイダーであり、間接リセラーの顧客を作成する場合は、「間接リセラーの顧客を作成する」を参照してください。

前提条件

パートナーセンターの認証に関するページで説明している資格情報。このシナリオでは、スタンドアロンアプリとアプリ + ユーザーの両方の資格情報を使った認証がサポートされています。

重要

顧客テナントを作成するには、作成プロセス中に有効な物理アドレスを指定する必要があります。アドレスは、「住所の検証」シナリオで説明されている手順に従って検証できます。サンドボックス環境で無効なアドレスを使用して顧客を作成した場合、その顧客テナントを削除することはできません。

重要

userCredentials パスワードの受け渡しが受け入れられない場合。

C#

顧客を追加するには:

新しい Customer オブジェクトをインスタンス化します。必ず BillingProfile と CompanyProfile を入力してください。
Create または CreateAsync を呼び出して、新しい顧客を IAggregatePartner.Customers コレクションに追加します。

C# の例

// IAggregatePartner partnerOperations;

var partnerOperations = this.Context.UserPartnerOperations;

var customerToCreate = new Customer()
{
    CompanyProfile = new CustomerCompanyProfile()
    {
        Domain = string.Format(CultureInfo.InvariantCulture,
            "SampleApplication{0}.{1}",
            new Random().Next(),
            this.Context.Configuration.Scenario.CustomerDomainSuffix),
        //// OrganizationRegistrationNumber = "123456" // Please add if in specific country/region that requires
    },
    BillingProfile = new CustomerBillingProfile()
    {
        Culture = "EN-US",
        Email = "gena@wingtiptoys.com",
        Language = "En",
        CompanyName = "Wingtip Toys"
        DefaultAddress = new Address()
        {
            FirstName = "Gena",
            MiddleName = "Coralie",
            LastName = "Soto",
            AddressLine1 = "One Microsoft Way",
            City = "Redmond",
            State = "WA",
            Country = "US",
            PostalCode = "98052",
            PhoneNumber = ""
        }
    }
};

var newCustomer = partnerOperations.Customers.Create(customerToCreate);

C# サンプルアプリ

コンソールテストアプリ。 プロジェクト: パートナーセンター SDK サンプル クラス: CreateCustomer.cs

REST

要求の構文

認証方法	要求 URI
投稿	{baseURL}/v1/customers HTTP/1.1

要求ヘッダー

この API はべき等です (複数回呼び出しても異なる結果は得られない)。
要求 ID と関連付け ID が必要です。
詳細については、「パートナーセンター REST ヘッダー」を参照してください。

要求本文

次の表は、要求本文の必須プロパティの説明です。

名前	種類	説明
BillingProfile	オブジェクト	顧客の課金プロファイル情報。
CompanyProfile	オブジェクト	顧客の会社プロファイル情報。

請求プロファイル

次の表では、新しい顧客を作成するために必要な CustomerBillingProfile リソースの最小必須フィールドについて説明します。

名前	種類	説明
メール	string	顧客のメールアドレス。
culture	string	コミュニケーションと通貨のための彼らの好ましい文化、例えば `en-US`. サポートされているカルチャについては、パートナーセンターでサポートされている言語とロケールを参照してください。
言語	string	既定の言語です。 2 文字の言語コード (例: `en` または `fr`) がサポートされています。
companyName	string	登録済みの会社名/組織名。
defaultAddress	住所	顧客の会社/組織の登録済み住所。長さの制限については、Address リソースを参照してください。

会社プロファイル

次の表では、新しい顧客を作成するために必要な CustomerCompanyProfile リソースの最小必須フィールドについて説明します。

名前	種類	説明
ドメイン	string	顧客のドメイン名 (contoso.onmicrosoft.com など)。
organizationRegistrationNumber	String	顧客の組織登録番号 (特定の国/地域では INN 番号とも呼ばれます)。アルメニア(AM)、アゼルバイジャン(AZ)、ベラルーシ(BY)、ハンガリー(HU)、カザフスタン(KZ)、キルギススタン(KG)、モルドバ(MD)、ロシア(RU)、タジキスタン(TJ)、ウズベキスタン(UZ)、ウクライナ(UA)、ブラジル(BR)、インド、南アフリカ、ポーランド、アラブ首長国連邦、サウジアラビア、トゥルキエ、タイ、ベトナム、ミャンマー、イラク、南スーダン、ベネズエラ、中国。他の国/地域にある顧客の会社/組織の場合、これは省略可能なフィールドです。

GDAP (既定)

名前	種類	説明
enableGDAPByDefault	[bool]	既定で GDAP を有効にするかどうかを示すブール値。 true の場合は、既定で GDAP が作成されます。 false の場合、GDAP は作成されません。これは GDAP をサポートするクラウドでのみ受け入れられます。サポートされていない場合は、既定で DAP が作成されます。

要求の例

POST https://api.partnercenter.microsoft.com/v1/customers HTTP/1.1
Authorization: Bearer <token>
Accept: application/json
MS-RequestId: 94e4e214-6b06-4fb7-96d1-94d559f9b47f
MS-CorrelationId: ab993325-1605-4cf4-bac4-fb584142a31b
X-Locale: en-US
Content-Type: application/json
Host: api.partnercenter.microsoft.com
Content-Length: 789
Expect: 100-continue
Connection: Keep-Alive

{
    "enableGDAPByDefault": false,
    "CompanyProfile": {
        "Domain": "xyz.onmicrosoft.com"
    },
    "BillingProfile": {
        "Culture": "EN-US",
        "Email": "gena@wingtiptoys.com",
        "Language": "en",
        "CompanyName": "Wingtip Toys",
        "DefaultAddress": {
            "FirstName": "Gena",
            "LastName": "Soto",
            "AddressLine1": "One Microsoft Way",
            "City": "Redmond",
            "State": "WA",
            "PostalCode": "98052",
            "Country": "US"
        }
    }
}

REST 応答

成功した場合、この API は新しい顧客の顧客リソースを返します。パートナーセンター SDK で今後使用できるように、顧客 ID と Microsoft Entra ID の詳細を保存します。たとえば、アカウント管理で使用するために必要になります。

応答の成功とエラーのコード

応答には、成功または失敗と追加のデバッグ情報を示す HTTP 状態コードが付属しています。このコード、エラーの種類、追加のパラメーターを読み取るには、ネットワークトレースツールを使用します。完全な一覧については、パートナーセンターの REST エラーコードに関する記事を参照してください。

応答の例

HTTP/1.1 201 Created
Content-Length: 834
Content-Type: application/json; charset=utf-8
MS-CorrelationId: ab993325-1605-4cf4-bac4-fb584142a31b
MS-RequestId: 94e4e214-6b06-4fb7-96d1-94d559f9b47f
MS-CV: ObwhuhD2tUKJoM+Z.0
MS-ServerId: 202010223
Date: Tue, 14 Feb 2017 20:06:02 GMT

{
    "id": "dfd8cc0a-c592-468c-8461-869a38d24738",
    "commerceId": "0a4ce58a-6f96-4273-8035-d9c7d31b9ba4",
    "companyProfile": {
        "tenantId": "dfd8cc0a-c592-468c-8461-869a38d24738",
        "domain": "xyz.onmicrosoft.com",
        "attributes": {
            "objectType": "CustomerCompanyProfile"
        }
    },
    "billingProfile": {
        "id": "d17c0275-da92-5c33-9032-782ef1d0b69b",
        "email": "gena@wingtiptoys.com",
        "culture": "en-US",
        "language": "en",
        "companyName": "Wingtip Toys",
        "defaultAddress": {
            "country": "US",
            "city": "Redmond",
            "state": "WA",
            "addressLine1": "One Microsoft Way",
            "postalCode": "98052",
            "firstName": "Gena",
            "lastName": "Soto",
            "phoneNumber": ""
        },
        "attributes": {
            "etag": "5920358838484612121",
            "objectType": "CustomerBillingProfile"
        }
    },
    "enableGDAPByDefault": false,
    "relationshipToPartner": "none",
    "userCredentials": {
        "userName": "admin",
        "password": "=;;n.=s9Z"
    },
    "attributes": {
        "objectType": "Customer"
    }
}

Java

Note

パートナーセンター SDK for Java は、パートナーコミュニティによってメインオープンソースプロジェクトです。

新しい顧客を作成するには、次の手順に従います。

CustomerBillingProfile オブジェクトと CustomerCompanyProfile オブジェクトの新しいインスタンスを作成します。必ず必須フィールドを設定してください。
IAggregatePartner.getCustomers().create 関数を 呼び出して顧客を作成 します。

Java の例

// IAggregatePartner partnerOperations;

Address address = new Address();

address.setFirstName( "Gena" );
address.setLastName( "Soto" );
address.setAddressLine1( "One Microsoft Way" );
address.setCity( "Redmond" );
address.setState( "WA" );
address.setCountry( "US" );
address.setPostalCode( "98052" );
address.setPhoneNumber( "4255550101" );

CustomerBillingProfile billingProfile = new CustomerBillingProfile();

billingProfile.setCulture( "en-US" );
billingProfile.setEmail( "gena@wingtiptoys.com" );
billingProfile.setLanguage( "en" );
billingProfile.setCompanyName( "Wingtip Toys" );
billingProfile.setDefaultAddress( address );

CustomerCompanyProfile companyProfile = new CustomerCompanyProfile();

companyProfile.setDomain( "WingtipToys" + Math.abs( new Random().nextInt() ) + ".onmicrosoft.com" );

Customer customerToCreate = new Customer();

customerToCreate.setBillingProfile( billingProfile );
customerToCreate.setCompanyProfile( companyProfile );

Customer newCustomer = partnerOperations.getCustomers().create( customerToCreate );

PowerShell

Note

パートナーセンター SDK for PowerShell は、パートナーコミュニティによってメインオープンソースプロジェクトです。

顧客を作成するには、次の 例のように New-PartnerCustomer コマンドを実行します。

New-PartnerCustomer -BillingAddressLine1 '1 Microsoft Way' -BillingAddressCity 'Redmond' -BillingAddressCountry 'US' -BillingAddressPostalCode '98052' -BillingAddressState 'WA' -ContactEmail 'gena@wingtiptoys.com' -ContactFirstName 'Gena' -ContactLastName 'Soto' -Culture 'en-US' -Domain 'newcustomer.onmicrosoft.com' -Language 'en' -Name 'New Customer'

顧客を作成する

前提条件

C#

C# の例

C# サンプルアプリ

REST

要求の構文

要求ヘッダー

要求本文

請求プロファイル

会社プロファイル

GDAP (既定)

要求の例

REST 応答

応答の成功とエラーのコード

応答の例

Java

Java の例

PowerShell

フィードバック

フィードバック

その他のリソース

顧客を作成する

前提条件

C#

C# の例

C# サンプル アプリ

REST

要求の構文

要求ヘッダー

要求本文

請求プロファイル

会社プロファイル

GDAP (既定)

要求の例

REST 応答

応答の成功とエラーのコード

応答の例

Java

Java の例

PowerShell

フィードバック

フィードバック

その他のリソース

C# サンプルアプリ