Získání potvrzení o přijetí Microsoft Customer Agreement zákazníkem

Článek
03/11/2025

platí pro: Partnerské centrum

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

Partnerské centrum v současné době podporuje prostředek smlouvy pouze ve veřejném cloudu Microsoftu.

Tento článek vysvětluje, jak můžete získat potvrzení o přijetí Smlouvy se zákazníkem společnosti Microsoft.

Požadavky

Pokud používáte sadu .NET SDK partnerského centra, vyžaduje se verze 1.14 nebo novější.

Důležitý

Od června 2023 se teď archivuje nejnovější verze sady .NET SDK partnerského centra 3.4.0. Verzi sady SDK můžete stáhnout z GitHubuspolečně s souborem readme, který obsahuje užitečné informace.

Doporučujeme, aby partneři nadále používali rozhraní REST API Partnerského centra.
Přihlašovací údaje, jak je popsáno v ověřování v Partnerském centru. Tento scénář podporuje pouze ověřování aplikací a uživatelů.
ID zákazníka (customer-tenant-id). Pokud neznáte ID zákazníka, můžete ho vyhledat v partnerském centru tak, že vyberete pracovní prostor Zákazníci, pak zákazník ze seznamu zákazníků a pak účet. Na stránce Účet zákazníka vyhledejte Microsoft ID v části Informace o zákaznickém účtu. ID Microsoftu je stejné jako ID zákazníka (customer-tenant-id).

.NET

Získání potvrzení o přijetí zákazníkem, které bylo dříve poskytnuto:

Použijte kolekci IAggregatePartner.Customers a volejte metodu ById se zadaným identifikátorem zákazníka.
Načtěte vlastnost Smlouvy a vyfiltrujte výsledky podle smlouvy se zákazníkem Microsoftu voláním metody ByAgreementType.
Zavolejte metodu Get nebo GetAsync.

// IAggregatePartner partnerOperations;
// string selectedCustomerId;

string agreementType = "MicrosoftCustomerAgreement";

var customerAgreements = partnerOperations.Customers.ById(selectedCustomerId).Agreements.ByAgreementType(agreementType).Get();

Kompletní ukázku najdete v GetCustomerAgreements třídě z projektu testovací aplikace pro konzoli.

Požadavek REST

Pro získání potvrzení o přijetí zákazníkem, které bylo dříve poskytnuto:

Vytvořte požadavek REST, který načte kolekci smluv pro zákazníka.
Použijte parametr dotazu agreementType, abyste omezili výsledky pouze na Smlouvu se zákazníkem společnosti Microsoft.

Syntaxe požadavku

Použijte následující syntaxi požadavku:

Metoda	Požadavek URI
ZÍSKAT	{baseURL}/v1/customers/{customer-tenant-id}/agreements?agreementType={agreement-type} HTTP/1.1

Parametry identifikátoru URI

U požadavku můžete použít následující parametry identifikátoru URI:

Jméno	Typ	Povinný	Popis
identifikátor zákaznického nájemníka	Identifikátor GUID	Ano	Hodnota je identifikátor GUID formátovaný CustomerTenantId, který umožňuje zadat zákazníka.
typ smlouvy	řetězec	Ne	Tento parametr vrátí všechna metadata smlouvy. Tento parametr použijte k určení rozsahu odpovědi dotazu na konkrétní typ smlouvy. Podporované hodnoty jsou: MicrosoftCloudAgreement, která obsahují pouze metadata smlouvy typu MicrosoftCloudAgreement. MicrosoftCustomerAgreement, která obsahují pouze metadata smlouvy typu MicrosoftCustomerAgreement. , která vrátí všechna metadata smlouvy. (Nepoužívejte , pokud váš kód nemá potřebnou logiku pro zpracování neočekávaných typů smluv.) Poznámka: Pokud není zadaný parametr identifikátoru URI, má dotaz výchozí hodnotu MicrosoftCloudAgreement kvůli zpětné kompatibilitě. Microsoft může kdykoli zavést metadata smlouvy s novými typy smluv.

Hlavičky požadavku

Další informace najdete v REST hlavičkách partnerského centra.

Tělo žádosti

Žádný.

Příklad požadavku

GET https://api.partnercenter.microsoft.com/v1/customers/14876998-c0dc-46e6-9d0c-65a57a6c32ec/agreements?agreementType=MicrosoftCustomerAgreement HTTP/1.1
Authorization: Bearer <token>
Accept: application/json
MS-RequestId: 94e4e214-6b06-4fb7-96d1-94d559f9b47f
MS-CorrelationId: aaaa0000-bb11-2222-33cc-444444dddddd

Odpověď REST

V případě úspěchu tato metoda vrátí kolekci prostředků Agreement v těle odpovědi.

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

Každá odpověď obsahuje stavový kód HTTP, který označuje ú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 Partnerském centru v tématu kódy chyb REST rozhraní.

Příklad odpovědi

HTTP/1.1 200 OK
Content-Length: 620
Content-Type: application/json
MS-RequestId: 94e4e214-6b06-4fb7-96d1-94d559f9b47f
MS-CorrelationId: aaaa0000-bb11-2222-33cc-444444dddddd
{
    "totalCount": 2,
    "items":
    [
        {
            "primaryContact":
            {
                "firstName":"Tania",
                "lastName":"Carr",
                "email":"SomeEmail@example.com"
                "phoneNumber":"1234567890"
            },
            "templateId":"aaaabbbb-0000-cccc-1111-dddd2222eeee",
            "dateAgreed":"2019-08-26T00:00:00",
            "type":"MicrosoftCustomerAgreement",
            "agreementLink":"https://aka.ms/customeragreement"
        },
        {
            "primaryContact":
            {
                "firstName":"Tania",
                "lastName":"Carr",
                "email":"SomeEmail@example.com"
                "phoneNumber:"1234567890"
            },
            "templateId":"aaaabbbb-0000-cccc-1111-dddd2222eeee",
            "dateAgreed":"2019-08-27T00:00:00",
            "type":"MicrosoftCustomerAgreement",
            "agreementLink":"https://aka.ms/customeragreement"
        }
    ]
}

Sdílet prostřednictvím