建立客戶

發行項
04/01/2024

適用於：合作夥伴中心 |由 21Vianet 營運的合作夥伴中心 |美國政府適用的 Microsoft Cloud 合作夥伴中心

身為雲端解決方案提供者（CSP）合作夥伴，當您建立客戶時，您可以代表客戶下訂單。當您建立客戶時，您也會建立：

客戶的 Microsoft Entra 租用戶物件
轉銷商與客戶之間的關聯性（用於委派的系統管理員許可權）
以客戶系統管理員身分登入的使用者名稱和密碼

建立客戶之後，請儲存客戶標識碼和 Microsoft Entra ID 詳細數據。

重要

如果您是間接提供者，而且想要為間接轉銷商建立客戶，請參閱為間接轉銷商建立客戶。

必要條件

認證，如合作夥伴中心驗證所述。此案例支援使用獨立應用程式和 App+使用者認證進行驗證。

重要

若要建立客戶租使用者，您必須在建立程序期間提供有效的實體位址。您可以遵循驗證位址案例中所述的步驟來驗證位址。如果您在沙箱環境中使用無效的位址建立客戶，您將無法刪除該客戶租使用者。

重要

如果不接受傳遞 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
POST	{baseURL}/v1/customers HTTP/1.1

要求標頭

此 API 是等冪的（如果您多次呼叫，則不會產生不同的結果）。
需要要求標識碼和相互關聯標識碼。
如需詳細資訊，請參閱合作夥伴中心 REST 標頭。

要求本文

下表描述要求本文中的必要屬性。

名稱	類型	描述
BillingProfile	object	客戶的帳單配置檔資訊。
CompanyProfile	object	客戶的公司配置文件資訊。

帳單設定檔

下表描述建立新客戶所需的 CustomerBillingProfile 資源所需的最小必要字段。

名稱	類型	描述
電子郵件	string	客戶的電子郵件地址。
culture	string	其偏好的通訊和貨幣文化特性，例如 `en-US`。如需支援的文化特性，請參閱合作夥伴中心支援的語言和地區設定。
language	string	默認語言。支援兩個字元的語言代碼（例如 `en` 或 `fr`）。
companyName	string	已註冊的公司/組織名稱。
defaultAddress	地址	客戶公司/組織的註冊位址。如需任何長度限制的資訊，請參閱地址資源。

公司設定檔

下表描述建立新客戶所需的 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 會傳回新客戶的客戶資源。儲存客戶標識碼和 Microsoft Entra 識別碼詳細數據，以供未來搭配合作夥伴中心 SDK 使用。例如，您將需要它們與帳戶管理搭配使用。

回應成功和錯誤碼

回應隨附 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

注意

適用於 Java 的合作夥伴中心 SDK 是合作夥伴社群維護的開放原始碼專案。

使用下列步驟建立新的客戶。

建立 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

注意

適用於 PowerShell 的合作夥伴中心 SDK 是合作夥伴社群維護的開放原始碼專案。

若要建立客戶，請 執行 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'

共用方式為