Bevestiging ontvangen van klantacceptatie van Microsoft-klantovereenkomst

Artikel
03/22/2025

van toepassing op: Partnercentrum

Is niet van toepassing op: Partnercentrum beheerd door 21Vianet | Partnercentrum voor Microsoft Cloud voor de Amerikaanse overheid

De overeenkomst resource wordt momenteel alleen door Partner Center in de openbare cloud van Microsoft ondersteund.

In dit artikel wordt uitgelegd hoe u bevestigingen kunt ophalen van de acceptatie van de Microsoft-klantovereenkomst door een klant.

Voorwaarden

Als u de .NET SDK van Partnercentrum gebruikt, is versie 1.14 of hoger vereist.

Belangrijk

Vanaf juni 2023 wordt de nieuwste Versie van Partner Center .NET SDK 3.4.0 gearchiveerd. U kunt de SDK-release downloaden van GitHub, samen met een leesmij-bestand met nuttige informatie.

Partners worden aangemoedigd om de Partner center REST API'ste blijven gebruiken.
Referenties zoals beschreven in Partnercentrum-authenticatie. Dit scenario biedt alleen ondersteuning voor App+User-verificatie.
Een klant-id (customer-tenant-id). Als u de klant-id niet weet, kunt u deze opzoeken in Partnercentrum door de werkruimte Klanten te selecteren, vervolgens de klant in de lijst met klanten en vervolgens Account. Zoek op de pagina Account van de klant naar de Microsoft-id in de sectie Klantaccountgegevens. De Microsoft-id is hetzelfde als de klant-id (customer-tenant-id).

.NET

Bevestigingen ophalen van klantacceptatie die eerder is opgegeven:

Gebruik de IAggregatePartner.Customers verzameling en roep ById methode aan met de opgegeven klant-id.
Haal de eigenschap Overeenkomsten op en filter de resultaten naar de Microsoft-klantovereenkomst door ByAgreementType methode aan te roepen.
Roep Get of GetAsync methode aan.

// IAggregatePartner partnerOperations;
// string selectedCustomerId;

string agreementType = "MicrosoftCustomerAgreement";

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

Een volledig voorbeeld vindt u in de GetCustomerAgreements klasse uit de consoletest-app project.

REST-aanvraag

Bevestiging van klantacceptatie ophalen die eerder is opgegeven:

Maak een REST-verzoek om de collectie overeenkomsten voor de klant op te halen.
Gebruik de agreementType queryparameter om de resultaten alleen te beperken tot de Microsoft-klantovereenkomst.

Aanvraagsyntaxis

Gebruik de volgende aanvraagsyntaxis:

Methode	Aanvraag-URI
TOEVOEGEN	{baseURL}/v1/customers/{customer-tenant-id}/agreements?agreementType={agreement-type} HTTP/1.1

URI parameters

U kunt de volgende URI-parameters gebruiken met uw aanvraag:

Naam	Type	Vereist	Beschrijving
klant-huurder-id	GUID (Globaal Unieke Identificator)	Ja	De waarde is een GUID die is geformatteerd als CustomerTenantId waarmee u een klant kunt opgeven.
overeenkomsttype	tekenreeks	Nee	Met deze parameter worden alle metagegevens van de overeenkomst geretourneerd. Gebruik deze parameter om het bereik van het queryantwoord op een specifiek overeenkomsttype te bepalen. De ondersteunde waarden zijn: MicrosoftCloudAgreement die alleen metagegevens van de overeenkomst van het type MicrosoftCloudAgreementbevat. MicrosoftCustomerAgreement die alleen metagegevens van de overeenkomst van het type MicrosoftCustomerAgreementbevat. * die alle metagegevens van de overeenkomst retourneren. (Gebruik * niet, tenzij uw code de benodigde logica heeft om onverwachte overeenkomsttypen af te handelen.) Opmerking: Als de URI-parameter niet is opgegeven, wordt de query standaard ingesteld op MicrosoftCloudAgreement voor achterwaartse compatibiliteit. Microsoft kan op elk gewenst moment metagegevens van overeenkomsten met nieuwe overeenkomsttypen introduceren.

Headers van verzoeken

Zie Partnercentrum REST-headersvoor meer informatie.

Aanvraaginhoud

Geen.

Voorbeeldaanvraag

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

REST-antwoord

Als dit lukt, retourneert deze methode een verzameling Overeenkomst bronnen in het antwoordbericht.

Geslaagde antwoorden en foutcodes

Elk antwoord wordt geleverd met een HTTP-statuscode die het succes of falen aangeeft en andere foutopsporingsinformatie.

Gebruik een hulpprogramma voor netwerktracering om deze code, het fouttype en andere parameters te lezen. Zie Partnercentrum REST-foutcodesvoor de volledige lijst.

Voorbeeld van antwoord

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

Delen via