Získání potvrzení přijetí Smlouvy se zákazníkem Microsoftu ze strany zákazníka

  • Článek

Platí pro: Partnerské centrum

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

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

Tento článek vysvětluje, jak můžete načíst potvrzení o přijetí Smlouva se zákazníkem Microsoftu zákazníka.

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. Vydání sady SDK si můžete stáhnout z GitHubu spolu se souborem readme, který obsahuje užitečné informace.

    Doporučujeme, aby partneři dál používali rozhraní REST API Partnerského centra.

  • Přihlašovací údaje popsané 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 ID Microsoftu v části Informace o účtu zákazníka. ID Microsoftu je stejné jako ID zákazníka (customer-tenant-id).

.NET

Načtení potvrzení přijetí zákazníka, 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 Agreements a vyfiltrujte výsledky tak, aby Smlouva se zákazníkem Microsoftu voláním ByAgreementType metoda.

  • Volání metody Get nebo GetAsync

// IAggregatePartner partnerOperations;
// string selectedCustomerId;

string agreementType = "MicrosoftCustomerAgreement";

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

Úplnou ukázku najdete ve třídě GetCustomerAgreements z projektu testovací aplikace konzoly.

Požadavek REST

Načtení potvrzení přijetí zákazníka, které bylo dříve poskytnuto:

  1. Vytvořte požadavek REST, který načte kolekci Smluv pro zákazníka.

  2. K určení rozsahu výsledků použijte parametr dotazu agreementType pouze na Smlouva se zákazníkem Microsoftu.

Syntaxe požadavku

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

metoda Identifikátor URI žádosti
GET {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:

Name Type Požadováno Popis
customer-tenant-id Identifikátor GUID Ano Hodnota je IDENTIFIKÁTOR GUID formátovaný CustomerTenantId , který umožňuje zadat zákazníka.
typ smlouvy string No 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ý obsahuje pouze metadata smlouvy typu MicrosoftCloudAgreement.

MicrosoftCustomerAgreement , který obsahuje pouze metadata smlouvy typu MicrosoftCustomerAgreement.

* 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 URI, nastaví se ve výchozím nastavení dotazu MicrosoftCloudAgreement pro zpětnou kompatibilitu. Microsoft může kdykoli zavést metadata smlouvy s novými typy smluv.

Záhlaví žádosti

Další informace najdete v tématu Hlavičky REST Partnerského centra.

Text požadavku

Nezaokrouhlovat.

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: ab993325-1605-4cf4-bac4-fb584142a31b

Odpověď REST

Pokud je tato metoda úspěšná, vrátí v textu odpovědi kolekci prostředků smlouvy .

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 tématu Kódy chyb REST v Partnerském centru.

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: ab993325-1605-4cf4-bac4-fb584142a31b
{
    "totalCount": 2,
    "items":
    [
        {
            "primaryContact":
            {
                "firstName":"Tania",
                "lastName":"Carr",
                "email":"SomeEmail@example.com"
                "phoneNumber":"1234567890"
            },
            "templateId":"117a77b0-9360-443b-8795-c6dedc750cf9",
            "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":"117a77b0-9360-443b-8795-c6dedc750cf9",
            "dateAgreed":"2019-08-27T00:00:00",
            "type":"MicrosoftCustomerAgreement",
            "agreementLink":"https://aka.ms/customeragreement"
        }
    ]
}