共用方式為


建立客戶

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

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

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

重要

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

必要條件

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

重要

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

重要

如果不接受傳遞 userCredentials 密碼。

C#

若要新增客戶:

  1. 具現化新的 Customer 物件。 請務必填寫 BillingProfileCompanyProfile

  2. 藉由呼叫 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# 範例應用程式

REST

要求語法

方法 要求 URI
POST {baseURL}/v1/customers HTTP/1.1

要求標頭

  • 此 API 是等冪的(如果您多次呼叫,則不會產生不同的結果)。

  • 需要要求標識碼和相互關聯標識碼。

  • 如需詳細資訊,請參閱合作夥伴中心 REST 標頭

要求本文

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

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

帳單設定檔

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

名稱 類型​​ 描述
電子郵件 string 客戶的電子郵件地址。
culture string 其偏好的通訊和貨幣文化特性,例如 en-US。 如需支援的文化特性,請參閱 合作夥伴中心支援的語言和地區設定
language string 默認語言。 支援兩個字元的語言代碼(例如 enfr)。
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: aaaa0000-bb11-2222-33cc-444444dddddd
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: aaaa0000-bb11-2222-33cc-444444dddddd
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": "aaaabbbb-0000-cccc-1111-dddd2222eeee",
    "commerceId": "0a4ce58a-6f96-4273-8035-d9c7d31b9ba4",
    "companyProfile": {
        "tenantId": "aaaabbbb-0000-cccc-1111-dddd2222eeee",
        "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 是合作夥伴社群維護的 開放原始碼 專案。

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

  1. 建立 CustomerBillingProfile 和 CustomerCompanyProfile 物件的新實例。 請務必填入必要的欄位。
  2. 呼叫 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'