Aktualisieren des Abrechnungsprofils eines Kunden

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

Aktualisiert das Abrechnungsprofil eines Kunden, einschließlich der mit dem Profil verknüpften Adresse.

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 Startseite Kunden aus, wählen Sie dann den Kunden aus der Kundenliste aus, und wählen Sie dann Konto aus. Suchen Sie auf der Kontoseite des Kunden im Abschnitt Kundenkontoinfo nach der Microsoft-ID. Die Microsoft-ID ist identisch mit der Kunden-ID (customer-tenant-id).

C#

Um das Abrechnungsprofil eines Kunden zu aktualisieren, rufen Sie das Abrechnungsprofil ab und aktualisieren Sie die Eigenschaften nach Bedarf. Rufen Sie dann Ihre IPartner.Customers-Auflistung ab, und rufen Sie dann die ById()- Methode auf. Rufen Sie dann die Eigenschaft Profiles und anschließend die Eigenschaft Billing auf. Beenden Sie dann den Vorgang, indem Sie die Update ()- oder UpdateAsync()- Methode aufrufen.

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

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

// Apply changes to profile;

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

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

REST-Anforderung

Anforderungssyntax

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

URI-Parameter

Verwenden Sie den folgenden Abfrageparameter, um das Abrechnungsprofil zu aktualisieren.

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

• If-Match: "<ETag>" ist für die Parallelitätserkennung erforderlich. Weitere Informationen finden Sie unter Partner Center REST-Header.

Anfragekörper

Die vollständige Ressource.

Beispielanfrage

PUT https://api.partnercenter.microsoft.com/v1/customers/<customer-tenant-id>/profiles/billing HTTP/1.1
Authorization: Bearer <token>
Accept: application/json
MS-RequestId: ff85f13a-eb65-4b8e-9b67-05beb0565410
MS-CorrelationId: aaaa0000-bb11-2222-33cc-444444dddddd
Content-Type: application/json
Content-Length: 639
Expect: 100-continue

{
    "Id": "a58ceba5-60ac-48e4-a0bc-2a855811807a",
    "FirstName": "FirstName",
    "LastName": "LastName",
    "Email": "email@sample.com",
    "Culture": "en-US",
    "Language": "en",
    "CompanyName": "CompanyName",
    "DefaultAddress": {
        "Country": "US",
        "Region": null,
        "City": "Redmond",
        "State": "WA",
        "AddressLine1": "One Microsoft Way",
        "AddressLine2": null,
        "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"
    }
}

REST-Antwort

Bei erfolgreicher Ausführung gibt diese Methode aktualisierte Eigenschaften der Profile-Ressource im Antworttext zurück. Für diesen Aufruf ist ein ETag für die Parallelitätserkennung erforderlich.

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: 1210
Content-Type: application/json
MS-CorrelationId: aaaa0000-bb11-2222-33cc-444444dddddd
MS-RequestId: ff85f13a-eb65-4b8e-9b67-05beb0565410
Date: Mon, 23 Nov 2015 18:20:43 GMT

{
    "id": "a58ceba5-60ac-48e4-a0bc-2a855811807a",
    "firstName": "FirstName",
    "lastName": "LastName",
    "email": "email@sample.com",
    "culture": "en-US",
    "language": "en",
    "companyName": "companyName",
    "defaultAddress": {
        "country": "US",
        "city": "Redmond",
        "state": "WA",
        "addressLine1": "One 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"
    }
}