Vytvoření zákazníka

Článek
04/01/2024

Platí pro: Partnerské centrum | Partnerské centrum provozované společností 21Vianet | Partnerské centrum pro Microsoft Cloud pro státní správu USA

Jako partner CSP (Cloud Solution Provider) můžete při vytváření zákazníka zadat objednávky jménem zákazníka. Když vytvoříte zákazníka, vytvoříte také:

Objekt tenanta Microsoft Entra pro zákazníka
Vztah mezi prodejcem a zákazníkem (používaným pro delegovaná oprávnění správce)
Uživatelské jméno a heslo pro přihlášení jako správce zákazníka

Po vytvoření zákazníka uložte ID zákazníka a podrobnosti o ID Microsoft Entra.

Důležité

Pokud jste nepřímý poskytovatel a chcete vytvořit zákazníka pro nepřímého prodejce, přečtěte si téma Vytvoření zákazníka pro nepřímého prodejce.

Požadavky

Přihlašovací údaje popsané v ověřování v Partnerském centru Tento scénář podporuje ověřování pomocí samostatných přihlašovacích údajů aplikace i aplikace a uživatele.

Důležité

Pokud chcete vytvořit tenanta zákazníka, musíte během procesu vytváření zadat platnou fyzickou adresu. Adresu můžete ověřit podle kroků popsaných ve scénáři Ověření adresy . Pokud vytvoříte zákazníka pomocí neplatné adresy v sandboxovém prostředí, nebudete moct tenanta zákazníka odstranit.

Důležité

Pokud se heslo userCredentials nepřizná.

C#

Přidání zákazníka:

Vytvořte instanci nového objektu Zákazník. Nezapomeňte vyplnit billingProfile a CompanyProfile.
Přidejte nového zákazníka do kolekce IAggregatePartner.Customers zavoláním příkazu Create nebo CreateAsync.

Příklad jazyka 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);

Ukázková aplikace v C#

Konzolová testovací aplikace Projekt: Třída ukázek sady SDK v Partnerském centru: CreateCustomer.cs

REST

Syntaxe požadavku

metoda	Identifikátor URI žádosti
POST	{baseURL}/v1/customers HTTP/1.1

Záhlaví žádosti

Toto rozhraní API je idempotentní (pokud ho několikrát zavoláte, nepřinese jiný výsledek).
Vyžaduje se ID požadavku a ID korelace.
Další informace najdete v tématu Hlavičky REST Partnerského centra.

Text požadavku

Tato tabulka popisuje požadované vlastnosti v textu požadavku.

Name	Typ	Popis
BillingProfile	objekt	Informace o fakturačním profilu zákazníka.
CompanyProfile	objekt	Informace o profilu společnosti zákazníka.

Fakturační profil

Tato tabulka popisuje minimální požadovaná pole z prostředku CustomerBillingProfile potřebného k vytvoření nového zákazníka.

Name	Typ	Popis
E-mail	string	E-mailová adresa zákazníka.
jazyková verze	string	Jejich upřednostňovaná kultura pro komunikaci a měnu, například `en-US`. Podporované jazyky a národní prostředí najdete v Partnerském centru.
jazyk	string	Výchozí jazyk. Podporují se dva kódy jazyka znaků (například `en` nebo `fr`).
Companyname	string	Název registrované společnosti nebo organizace.
defaultAddress	Adresa	Registrovaná adresa společnosti nebo organizace zákazníka. Informace o jakýchkoli omezeních délky najdete v prostředku Adresa .

Profil společnosti

Tato tabulka popisuje minimální požadovaná pole z prostředku CustomerCompanyProfile potřebného k vytvoření nového zákazníka.

Name	Typ	Popis
domain	string	Název domény zákazníka, například contoso.onmicrosoft.com.
organizationRegistrationNumber	String	Registrační číslo organizace zákazníka (označované také jako číslo INN v určitých zemích nebo oblastech). Vyžaduje se pouze pro společnost nebo organizaci zákazníka, která se nachází v následujících zemích/oblastech: Arménie(AM), Ázerbájdžán(AZ), Bělorusko(BY), Maďarsko(HU), Kazachstán(KZ), Kyrgyzstán(KG), Moldavsko(MD), Rusko(RU), Tajikistan(TJ), Kazachstán(UZ), Ukrajina(UA), Brazílie(BR), Indie, Indie, Jihoafrická republika, Polsko, Spojené arabské emiráty, Saúdská Arábie, Türkiye, Thajsko, Vietnam, Myanmar, Irák, Jižní Súdán, Venezuela a Čína. Pro společnost nebo organizaci zákazníka, která se nachází v jiných zemích nebo oblastech, je to volitelné pole.

GDAP ve výchozím nastavení

Name	Typ	Popis
enableGDAPByDefault	bool	Logická hodnota označující, jestli chceme povolit GDAP ve výchozím nastavení nebo ne. Pokud ano, vytvoříme ve výchozím nastavení GDAP. Pokud je false, nevytvoříme GDAP. Mějte na paměti, že se to dodržuje jenom v cloudech, které podporují GDAP. Pokud se nepodporuje, daP se ve výchozím nastavení vytvoří.

Příklad požadavku

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"
        }
    }
}

Odpověď REST

V případě úspěchu toto rozhraní API vrátí prostředek zákazníka pro nového zákazníka. Uložte ID zákazníka a podrobnosti o ID Microsoft Entra pro budoucí použití se sadou SDK Partnerského centra. Budete je potřebovat pro použití se správou účtů, například.

Kódy úspěšnosti a chyb odpovědi

Odpovědi se dodávají se stavovým kódem HTTP, který indikuje úspěch nebo selhání a další informace o ladění. Ke čtení tohoto kódu, typu chyby a dalších parametrů použijte nástroj pro trasování sítě. Úplný seznam najdete v tématu Kódy chyb REST v Partnerském centru.

Příklad odpovědi

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

Poznámka:

Sada SDK Partnerského centra pro Javu je opensourcový projekt spravovaný komunitou partnerů.

Pomocí následujícího postupu vytvořte nového zákazníka.

Vytvořte novou instanci CustomerBillingProfile a CustomerCompanyProfile objektů. Nezapomeňte vyplnit požadovaná pole.
Vytvořte zákazníka voláním funkce IAggregatePartner.getCustomers().create .

Příklad Javy

// 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

Poznámka:

Sada SDK Partnerského centra pro PowerShell je opensourcový projekt spravovaný komunitou partnerů.

Pokud chcete vytvořit zákazníka, spusťte příkaz New-PartnerCustomer jako v následujícím příkladu.

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'

Sdílet prostřednictvím

Vytvoření zákazníka

Požadavky

C#

Příklad jazyka C#

Ukázková aplikace v C#

REST

Syntaxe požadavku

Záhlaví žádosti

Text požadavku

Fakturační profil

Profil společnosti

GDAP ve výchozím nastavení

Příklad požadavku

Odpověď REST

Kódy úspěšnosti a chyb odpovědi

Příklad odpovědi

Java

Příklad Javy

PowerShell

Váš názor

Další materiály