Abrufen des Abrechnungsprofils eines Kunden

anwendbar auf: Partnerzentrum | Partnerzentrum betrieben von 21Vianet | Partnerzentrum für die Microsoft-Cloud für die US-Regierung

Ruft das Abrechnungsprofil eines Kunden ab.

In Partner Center kann dieser Vorgang ausgeführt werden, indem Sie zuerst einen Kunden auswählen. Das Abrechnungsprofil finden Sie unter der Überschrift "Abrechnungsinformationen ".

Voraussetzungen

• Anmeldeinformationen wie unter Partner Center-Authentifizierung beschrieben. Dieses Szenario unterstützt die Authentifizierung mit eigenständigen App- und App+Benutzeranmeldeinformationen.

• Eine Kunden-ID (customer-tenant-id). Wenn Sie die ID des Kunden nicht kennen, können Sie sie im Partner Center nachschlagen. Wählen Sie auf der Partner Center-Startseite den Arbeitsbereich "Kunden " aus. Wählen Sie den Kunden aus der Kundenliste aus, und wählen Sie dann "Konto" aus. Suchen Sie auf der Kontoseite des Kunden im Abschnitt "Kundenkontodetails" nach der Microsoft-ID. Die Microsoft-ID ist identisch mit der Kunden-ID (customer-tenant-id).

C#

Um das Abrechnungsprofil eines Kunden abzurufen, verwenden Sie Ihre IPartner.Customers-Sammlung , und rufen Sie die ById()- Methode auf. Rufen Sie dann die Eigenschaft Profiles und anschließend die Eigenschaft Billing auf. Rufen Sie abschließend die Methoden Get() oder GetAsync() auf.

// IAggregatePartner partnerOperations;
// var selectedCustomerId as string;

var billingProfile = partnerOperations.Customers.ById(selectedCustomerId).Profiles.Billing.Get();

Beispiel: Konsolentest-App. Projekt: PartnerSDK.FeatureSamples Klasse: GetCustomerBillingProfile.cs

REST-Anforderung

Anforderungssyntax

Methode	Anforderungs-URI
ERHALTEN	{baseURL}/v1/customers/{customer-tenant-id}/profile/billing HTTP/1.1

URI-Parameter

Verwenden Sie den folgenden Abfrageparameter, um das Abrechnungsprofil abzurufen.

Name	Typ	Erforderlich	BESCHREIBUNG
Kunden-Mieter-ID	GUID	Ja	Der Wert ist ein als GUID formatierter customer-tenant-id-Wert, der es Vertriebspartnern ermöglicht, die Ergebnisse für einen bestimmten Kunden zu filtern, der zum Vertriebspartner gehört.

Anforderungsheader

Weitere Informationen finden Sie unter Partner Center REST-Header.

Anfragekörper

Nichts

Beispielanfrage

GET https://api.partnercenter.microsoft.com/v1/customers/<customer-tenant-id>/profiles/billing HTTP/1.1
Authorization: Bearer <token>
Accept: application/json
MS-RequestId: a5581a74-2778-4e34-9172-18baa4877081
MS-CorrelationId: aaaa0000-bb11-2222-33cc-444444dddddd

REST-Antwort

Bei erfolgreicher Ausführung gibt diese Methode eine Auflistung von Profile-Ressourcen im Antworttext zurück.

Antworterfolgs- und Fehlercodes

Jede Antwort enthält einen HTTP-Statuscode, der Erfolg oder Fehler sowie zusätzliche Debuginformationen angibt. Verwende ein Tool für die Netzwerkablaufverfolgung, um diesen Code, den Fehlertyp und zusätzliche Parameter zu lesen. Die vollständige Liste findest du unter Fehlercodes.

Antwortbeispiel

HTTP/1.1 200 OK
Content-Length: 1206
Content-Type: application/json
MS-CorrelationId: aaaa0000-bb11-2222-33cc-444444dddddd
MS-RequestId: a5581a74-2778-4e34-9172-18baa4877081
Date: Mon, 23 Nov 2015 18:13:43 GMT

{
    "id": "<billing-profile-id>",
    "firstName": "FirstName",
    "lastName": "LastName",
    "email": "email@sample.com",
    "culture": "en-US",
    "language": "en",
    "companyName": "CompanyName",
    "defaultAddress": {
        "country": "US",
        "city": "Redmond",
        "state": "WA",
        "addressLine1": "1 Microsoft Way",
        "postalCode": "98052",
        "firstName": "FirstName",
        "lastName": "LastName",
        "phoneNumber": "4255555555"
    },
    "links": {
        "self": {
            "uri": "/v1/customers/<customer-tenant-id>/profiles/billing",
            "method": "GET",
            "headers": []
        }
    },
    "attributes": {
        "etag": "<etag>",
        "objectType": "CustomerBillingProfile"
    }
}