Abgerechnete und nicht abgerechnete tägliche Nutzungsabstimmungs-API v2 (GA)

Gilt für: Partner Center (nicht verfügbar in Azure Government oder Azure China 21Vianet.)

Unsere neue asynchrone API bietet eine schnellere und effizientere Möglichkeit, über Azure-Blobs auf Ihre Abrechnungs- und Abstimmungsdaten zuzugreifen. Anstatt eine Verbindung für Stunden offen zu halten oder Batches von 2.000 Zeilenelementen zu verarbeiten, können Sie ihren Workflow jetzt optimieren, die Serverlast reduzieren und Datenverarbeitungszeiten verbessern.

Die neuen täglich bewerteten Nutzungssausgleichs-APIs verwenden erweiterte Techniken wie Valet-Schlüssel und asynchrone Anforderungsantwortmuster . Das Valet-Schlüsselmuster unterstützt den sicheren Zugriff auf Ressourcen ohne Freigabe von Anmeldeinformationen, während das asynchrone Anforderungsantwortmuster die effiziente Kommunikation zwischen Systemen ermöglicht.

Diese APIs bieten Ihnen ein SAS-Token (Shared Access Signature), das Sie verwenden können, um entweder auf alle Attribute oder eine Teilmenge der täglich bewerteten Nutzungsabstimmungsdaten zuzugreifen. Dieses Token verbessert die Sicherheit, indem ein zeitlich beschränkter Zugriff gewährt und das Verwalten von Datenzugriffsberechtigungen flexibel gestaltet wird.

Durch die Nutzung unserer optimierten APIs können Sie schnellere Ergebnisse mit weniger Aufwand erzielen, den Datenzugriff vereinfachen und die Gesamteffizienz verbessern. Nutzen Sie diese Tools, um Ihren Workflow zu optimieren und Berechtigungen effektiver zu verwalten.

Hinweis

Die neuen APIs werden nicht auf dem Partner Center-API-Host gehostet. Stattdessen finden Sie sie auf MS Graph unter Verwendung der Microsoft Graph-API zum Exportieren von Partnerabrechnungsdaten – Microsoft Graph v1.0 | Microsoft Learn. Informationen zum Zugriff auf diese APIs finden Sie in den folgenden Details.

Sie können diese APIs nur für die öffentliche globale MS Graph-Cloud verwenden. Sie sind noch nicht für Azure Government oder Azure China verfügbar.

Zulassen, dass Ihre App auf Partnerabrechnungsdaten zugreifen kann

Um Ihrer App den Zugriff auf Partnerabrechnungsdaten zu ermöglichen, folgen Sie diesem Link und machen Sie sich mit den Authentifizierungs- und Autorisierungsgrundlagen für Microsoft Graphvertraut. Dieser Schritt ist entscheidend, da so sichergestellt wird, dass Ihre App sicher auf die erforderlichen Daten zugreifen kann.

Zuweisen der Berechtigung PartnerBilling.Read.All

Weisen Sie die Berechtigung "PartnerBilling.Read.All" entweder über das Azure-Portal oder das Microsoft Entra Admin Center zu. Diese Schritte stellen sicher, dass Ihre App über den erforderlichen Zugriff auf die Partnerabrechnungsdaten verfügt.

1. Registrieren Sie Ihre App auf der Microsoft Entra-Startseite unter dem Abschnitt App-Registrierungen.
2. Erteilen Sie die erforderlichen Berechtigungen, indem Sie zur Seite "Microsoft Entra App" wechseln. Wählen Sie im Abschnitt zu den API-Berechtigungen zunächst die Option Berechtigung hinzufügen und dann den Bereich PartnerBilling.Read.All aus.

Grundlegendes zu den Unterschieden zwischen beta- und GA-Versionen

Wenn Sie unsere Betaversion verwendet haben, finden Sie wahrscheinlich den Übergang zur allgemeinen Verfügbarkeit (GA)-Version reibungslos und intuitiv. Um Ihnen zu helfen, die Updates und Verbesserungen zu verstehen, empfehlen wir, Beta- und GA-Versionen zu vergleichen. Wenn Sie diese Updates verstehen, können Sie die neuen Features und Verbesserungen maximieren, die in der GA-Version verfügbar sind.

Wichtig

Die neue täglich bewertete Nutzung des Commerce umfasst nicht die Gebühren für diese Produkte:

• Azure-Reservierung
• Azure-Sparplan
• Office
• Dynamics
• Microsoft Power Apps
• Unbefristete Software
• Softwareabonnement
• SaaS-Produkt ohne Microsoft oder Marketplace

Verstehen und Verwenden der API-Endpunkte

Um Ihnen beim asynchronen Abrufen von täglich bewerteten E-Commerce-Nutzungspositionen zu helfen, bieten wir zwei wichtige API-Endpunkte an. Folgen Sie diesem optimierten Leitfaden, um schnell loszulegen.

Verwenden Sie den Zeilenelement-Endpunkt

Verwenden Sie zunächst diese API, um täglich bewertete Nutzungszeilenelemente für den neuen Commerce abzurufen. Wenn Sie eine Anforderung stellen, erhalten Sie einen HTTP-Status 202 und einen Speicherortheader mit einer URL. Rufen Sie diese URL regelmäßig ab, bis Sie einen Erfolgsstatus und eine Manifest-URL erhalten.

Verwenden Sie den Betriebsstatus-Endpunkt

Indem Sie diese Schritte ausführen, können Sie Ihren Rechnungsausgleichsprozess effizient verwalten.

Überprüfen Sie den Vorgangsstatus, indem Sie diese API in regelmäßigen Abständen aufrufen. Wenn die Daten nicht bereit sind, enthält die Antwort einen Retry-After-Header , der angibt, wie lange gewartet werden soll, bevor sie es erneut versuchen. Nach Abschluss des Vorgangs erhalten Sie eine Manifestressource mit einem Speicherordnerlink zum Herunterladen der Nutzungsdaten. Die Antwortsegmente der Dateien, um den Durchsatz zu verbessern und die E/A-Parallelität zu ermöglichen.

Herunterladen von Abstimmungsdaten

Hier ist ein Sequenzdiagramm, das die Schritte zum Herunterladen der Abstimmungsdaten zeigt.

Befolgen Sie die Benutzeraktionssequenz

Dies sind die Schritte für den Benutzer, um neue gewerbliche Bestellpositionen zur Abstimmung der täglich bewerteten Nutzung abzurufen:

• Senden einer Anforderung
• Überprüfen des Anforderungsstatus
• Herunterladen der Bestellpositionen zur Abstimmung der täglich bewerteten Nutzung aus Azure Blob Storage

Einreichen einer Anforderung

Senden Sie eine POST-Anforderung an den API-Endpunkt.

Abrufen nicht abgerechneter täglich bewerteter Nutzungspositionen

Erhalten Sie neue e-Commerce unbilligte täglich bewertete Nutzungspositionen für den aktuellen oder letzten Kalendermonat oder Abrechnungszeitraum.

Hinweis

Sie können über das API- oder Partner Center-Portal auf Ihre nicht abgerechneten täglich bewerteten Nutzungspositionen zugreifen. Um die Datengenauigkeit sicherzustellen, sollten Sie bis zu 24 Stunden warten, bis die Daten verfügbar sind. Je nach Standort und dem Zeitpunkt, an dem die Zähler die Nutzung melden, kann es weitere Verzögerungen geben.

Wir priorisieren zuerst die Rechtzeitige Lieferung von in Rechnung gestellten täglich bewerteten Nutzungsdaten. Gelegentlich werden die Daten zur neuesten, nicht abgerechneten täglich bewerteten Nutzung erst angezeigt, wenn die in Rechnung gestellten Daten des vorherigen Monats verfügbar sind. Nachdem Sie die in Rechnung gestellten Daten erhalten haben, können Sie ab Beginn des Monats auf alle aktualisierten nicht abgerechneten Nutzungsdaten zugreifen.

Wichtige Punkte:

• Rechnen Sie mit bis zu 24 Stunden für die Datenverfügbarkeit.
• Je nach Standort und Berichterstellungszeiten der Verbrauchseinheit kann es weitere Verzögerungen geben.
• Die täglich berechneten bewerteten Nutzungsdaten werden über nicht berechnete Daten priorisiert.

Ihr Verständnis und Ihre Geduld werden geschätzt, da wir uns bemühen, möglichst genaue und zeitnahe Informationen bereitzustellen.

API-Anforderung

POST https://graph.microsoft.com/v1.0/reports/partners/billing/usage/unbilled/export

Accept: application/json

Content-Type: application/json

{

"currencyCode": "USD",

"billingPeriod": "current",

"attributeSet": "basic"

}

Anforderungstext

Attribut	Erforderlich	Type	Beschreibung
attributeSet	False	String	Wählen Sie "vollständig" für alle Attribute oder "Einfach" für einen begrenzten Satz aus. Wenn nicht angegeben, ist "full" der Standardwert. Überprüfen Sie die Liste der Attribute in diesem Abschnitt. Optional.
billingPeriod	True	String	Um Daten zur nicht abgerechneten täglich bewerteten Nutzung zu erhalten, verwenden Sie „Aktuell“ für den aktuellen Abrechnungszeitraum oder „Letzte“ für den vorherigen Abrechnungszeitraum (identisch mit „Vorherige“ bei der v1 API). Erforderlich.
currencyCode	True	String	Partnerabrechnungswährungscode. Erforderlich.

Anforderungsheader

Informationen zum Anfordern von Headern für die API finden Sie unter Zuverlässigkeit und Support.

API-Antwort

HTTP/1.1 202 Accepted  
Location: https://graph.microsoft.com/v1.0/reports/partners/billing/operations/9ab9cb54-d07f-4f52-9ea6-a09d7de52c14

Die API antwortet in der Regel mit einem HTTP 202-Status. Gemäß Ihren Anforderungen können auch andere Status auftreten. Diese Status werden im Abschnitt "Standard-API-Antwortstatus" aufgeführt.

Code	Beschreibung
202 - Akzeptiert	Ihre Anfrage wurde angenommen. Um den Status Ihrer Anforderung zu überprüfen, fragen Sie die url ab, die im Speicherortheader angegeben ist.

Abrufen der täglich bewerteten Nutzungspositionen

Erhalten Sie neue, täglich bewertete Nutzungspositionen für eine Rechnung für den abgeschlossenen Abrechnungszeitraum.

API-Anforderung

POST https://graph.microsoft.com/v1.0/reports/partners/billing/usage/billed/export

{  
"invoiceId": "G00012345",  
"attributeSet": "full"  
}

Abfrageparameter

N/V

Anforderungstext

Attribut	Erforderlich	Type	Beschreibung
invoiceId	True	String	Ein eindeutiger Bezeichner für jede Rechnung. Erforderlich.
attributeSet	False	String	Wählen Sie "vollständig" für alle Attribute oder "Einfach" für einen begrenzten Satz aus. Wenn nicht angegeben, ist "full" der Standardwert. Überprüfen Sie die Liste der Attribute in diesem Abschnitt. Optional.

Anforderungsheader

Anforderungsheader für die API. Weitere Informationen finden Sie unter Zuverlässigkeit und Support.

API-Antwort

HTTP/1.1 202 akzeptiert
Ort: https://graph.microsoft.com/v1.0/reports/partners/billing/operations/9ab9cb54-d07f-4f52-9ea6-a09d7de52c14

Wenn Sie die API verwenden, wird in der Regel ein HTTP 202-Status zurückgegeben. Weitere mögliche Statusmeldungen, die auf Ihren Anforderungen basieren, finden Sie unter Status.

Code	Beschreibung
202 - Akzeptiert	Ihre Anfrage wurde angenommen. Um den Status Ihrer Anforderung zu überprüfen, fragen Sie die url ab, die im Speicherortheader angegeben ist.

Überprüfen des Anforderungsstatus

Um den Status einer Anforderung nachzuverfolgen, stellen Sie sicher, dass Sie eine HTTP 200-Antwort erhalten. Dabei handelt es sich um einen Standardstatuscode, der den Status „erfolgreich“ oder „fehlgeschlagen“ angibt. Bei erfolgreichem Status finden Sie die Manifest-URL im Attribut „resourceLocation“. Dieses Attribut stellt einen Endpunkt für den Zugriff auf die erforderlichen Informationen bereit.

Vorgangsstatus abrufen

Ruft den Status einer Anforderung ab.

API-Anforderung

GET https://graph.microsoft.com/v1.0/reports/partners/billing/operations/9ab9cb54-d07f-4f52-9ea6-a09d7de52c14

Anforderungsparameter

Name	Einschließen in	Erforderlich	Type	Beschreibung
operationId	Anforderungs-URI	True	String	Ein eindeutiger Bezeichner, um den Anforderungsstatus zu überprüfen. Erforderlich.

Anforderungsheader

Informationen zum Anfordern von Headern für die API finden Sie unter Zuverlässigkeit und Support.

Anforderungstext

Nicht zutreffend.

Antwortstatus

Abgesehen von den standardmäßigen HTTP-Status, die in Standard-API-Antwortstatus aufgeführt sind, kann die API auch den folgenden HTTP-Status zurückgeben:

Code	Beschreibung
410 - Nicht mehr vorhanden	Der Manifestlink läuft nach einer festgelegten Zeit ab. Um den Manifestlink erneut abzurufen, senden Sie eine neue Anforderung.

Antwortnutzlast

Die API-Antwortnutzlast enthält die folgenden Attribute:

Attribut	Erforderlich	Beschreibung
id	True	Ein eindeutiger Bezeichner für jede Antwort. Erforderlich.
status	True	Werte und Aktionen: Erforderlich: notstarted: Warten Sie die im Retry-After-Header angegebene Zeit ab, und führen Sie dann einen weiteren Aufruf aus, um den Status zu überprüfen. running: Warten Sie die im Retry-After-Header angegebene Zeit ab, und führen Sie dann einen weiteren Aufruf aus, um den Status zu überprüfen. erfolgreich: Die Daten sind bereit. Rufen Sie die Manifestnutzlast mithilfe des in resourceLocation angegebenen URI ab. failed: The operation failed permanent. Starten Sie ihn neu.
createdDateTime	True	Der Zeitpunkt, zu dem die Anforderung gestellt wurde. Erforderlich.
lastActionDateTime	True	Das letzte Mal, wenn der Status geändert wurde. Erforderlich.
resourceLocation	False	Der URI für die Manifestnutzlast. Optional.
error	False	Details zu Fehlern, die im JSON-Format bereitgestellt werden. Optional. Enthaltene Attribute: message: Beschreibung des Fehlers. code: Der Typ des Fehlers.

Ressourcenspeicherortobjekt

Attribut	Beschreibung
id	Ein eindeutiger Bezeichner für das Manifest.
schemaVersion	Version des Manifestschemas.
dataFormat	Format der Abrechnungsdatendatei. compressedJSON: Data format where each blob is a compressed file that contains data in JSON lines format. Um die Daten aus jedem Blob abzurufen, dekomprimieren Sie sie.
createdDateTime	Datum und Uhrzeit der Erstellung der Manifestdatei.
eTag	Version der Manifestdaten. Eine Änderung der Abrechnungsinformationen generiert einen neuen Wert.
partnerTenantId	Microsoft Entra-ID des Mandanten des Partners.
rootDirectory	Stammverzeichnis der Datei.
sasToken>	SAS-Token (Freigegebene Zugriffssignatur), mit dem Sie alle Dateien unter dem Verzeichnis lesen können.
partitionType	Dividiert Daten basierend auf dem Attribut "partitionValue" in mehrere Blobs. Das System teilt Partitionen auf, die die unterstützte Zahl überschreiten. Standardmäßig werden Daten basierend auf der Anzahl der Zeilenelemente in der Datei partitioniert. Vermeiden Sie es, Zeilenanzahlen oder Dateigrößen fest einzuprogrammieren, da sie sich ändern können.
blobCount	Gesamtanzahl der Dateien für diese Partnermandanten-ID.
blobs	Ein JSON-Array von "blob"-Objekten, die die Dateidetails für die Partnermandanten-ID enthalten.
Blob-Objekt	Ein Objekt mit den folgenden Details: Name und partitionValue
name	Der Name des Blobs.
partitionValue	Partition, die die Datei enthält. Die große Partition wird basierend auf bestimmten Kriterien in mehrere Dateien aufgeteilt, z. B. Dateigröße oder Anzahl von Datensätzen, wobei jede Datei denselben "partitionValue"enthält.

API-Anforderung

GET <https://graph.microsoft.com/v1.0/reports/partners/billing/operations/9ab9cb54-d07f-4f52-9ea6-a09d7de52c14>

API-Antwort

Die Antwort empfiehlt, auf 10 Sekunden zu warten, bevor sie beim Verarbeiten von Daten erneut versucht wird.

HTTP/1.1 200 OK  
Retry-After: 10  
{  
"id": "9ab9cb54-d07f-4f52-9ea6-a09d7de52c14",  
"createdDateTime": "2022-06-1T10-01-03.4Z",  
"lastActionDateTime": "2022-06-1T10-01-05Z",  
"status": "running"  
}

API-Anforderung

(10 Sekunden nach der vorherigen Anforderung...)

GET <https://graph.microsoft.com/v1.0/reports/partners/billing/operations/9ab9cb54-d07f-4f52-9ea6-a09d7de52c14>

API-Antwort

Die API gibt den Status "erfolgreich" und den URI für "resourceLocation" zurück.

HTTP/1.1 200 OK  
Content-Type: application/json  
{

    "@odata.context": "https://graph.microsoft.com/v1.0/\$metadata#reports/partners/billing/operations/\$entity",

    "@odata.type": "#microsoft.graph.partners.billing.exportSuccessOperation",

    "id": "f2170b13-6a8e-47d6-b481-6988490dc0cb",

    "createdDateTime": "2023-12-05T21:17:29Z",

    "lastActionDateTime": "2023-12-05T21:18:00.8897902Z",

    "status": "succeeded",

    "resourceLocation": {

        "id": "44e8500b-ab92-490e-8ac3-90500a1d3427",

        "createdDateTime": "2023-11-06T19:58:47.513Z",

        "schemaVersion": "2",

        "dataFormat": "compressedJSON",

        "partitionType": "default",

        "eTag": "RwDrn7fbiTXy6UULE",

        "partnerTenantId": "aaaabbbb-0000-cccc-1111-dddd2222eeee",

        "rootDirectory": "https://adlsreconbuprodeastus201.blob.core.windows.net/path_id",

        "sasToken": "{token}",

        "blobCount": 1,

        "blobs": \[

            {

                "name": "part-00123-5a93fa5d-749f-48bc-a372-9b021d93c3fa.c000.json.gz",

                "partitionValue": "default"

            }

        \]

    }

}

Herunterladen der Bestellpositionen zur Abstimmung der täglich bewerteten Nutzung aus Azure Blob Storage

Zunächst müssen Sie das SAS-Token (Shared Access Signature) und den Blob-Speicherort abrufen. Sie finden diese Details in den Eigenschaften sasToken und rootDirectory der API-Antwort auf die Manifestnutzlast. Um die BLOB-Datei herunterzuladen und zu entzippen, verwenden Sie dann das Azure Storage SDK/Tool. Sie befindet sich im JSONLines-Format .

Tipp

Sehen Sie sich unseren Beispielcode an. Es zeigt Ihnen, wie Sie die Azure-BLOB-Datei in Ihre lokale Datenbank herunterladen und entpacken.

Grundlegendes zu den Standardmäßigen API-Antwortstatus

Möglicherweise erhalten Sie diese HTTP-Status aus der API-Antwort:

Code	Beschreibung
400 - Ungültige Anforderung	Die Anforderung fehlt oder enthält falsche Daten. Überprüfen Sie den Antworttext auf Fehlerdetails.
401 - Nicht autorisiert	Die Authentifizierung ist erforderlich, bevor der erste Anruf erfolgt. Authentifizieren mit dem Partner-API-Dienst.
403 - Verboten	Sie verfügen nicht über die erforderliche Autorisierung, um die Anforderung zu stellen.
404 - Nicht gefunden	Die angeforderten Ressourcen sind nicht mit den bereitgestellten Eingabeparametern verfügbar.
410 - Nicht mehr vorhanden	Der Manifestlink ist nicht mehr gültig oder aktiv. Senden Sie eine neue Anforderung.
500 – Interner Serverfehler	Die API oder ihre Abhängigkeiten können die Anforderung im Moment nicht erfüllen. Versuchen Sie es später noch einmal.
5000 - Keine Daten verfügbar	Das System hat keine Daten für die bereitgestellten Eingabeparameter.

Vergleichen von Beta- und GA-Versionen

Schauen Sie sich die folgende Vergleichstabelle an, um die Unterschiede zwischen der Betaversion und den allgemein verfügbaren (GA)-Versionen zu sehen. Wenn Sie derzeit die Betaversion verwenden, dürfte der Übergang zur GA-Version einfach und unkompliziert sein.

Wichtige Informationen	Beta	Allgemein verfügbar
API-Hostendpunkt	https://ep-billingreconservice-prod-d5bfczcnfvbqbdhx.z01.azurefd.net/	https://graph.microsoft.com/v1.0/reports/partners/billing/usage/
HTTP-Methode	POST	POST
Nicht abgerechneter endpunkt der täglich bewerteten Nutzungs-API	https://ep-billingreconservice-prod-d5bfczcnfvbqbdhx.z01.azurefd.net/v1/unbilledusage	https://graph.microsoft.com/v1.0/reports/partners/billing/usage/unbilled/export
Eingabeparameter für die nicht berechnete tägliche Nutzungs-API	Um Parameter in der API-Anforderung anzugeben, fügen Sie sie in die Abfragezeichenfolge der Anforderungs-URL ein. Um beispielsweise die Parameter "period" und "currencyCode" anzugeben, fügen Sie sie an die Anforderungs-URL an ?period=current&currencyCode=usd .	Um Eingaben bereitzustellen, fügen Sie ein JSON-Objekt in den Anforderungstext ein. Ihr JSON sollte über die folgenden Eigenschaften verfügen: * currencyCode: Ihre Abrechnungswährung. Beispiel: USD. * billingPeriod: Der Abrechnungszeitraum für die Rechnung. Beispiel: aktuell. Hier ist ein JSON-Beispielobjekt, das die CurrencyCode- und billingPeriod-Eigenschaften enthält:<br>{<br> "currencyCode": "USD",<br> "billingPeriod": "current"<br>}
Endpunkt der täglich bewerteten Nutzungs-API	https://ep-billingreconservice-prod-d5bfczcnfvbqbdhx.z01.azurefd.net/v1/billedusage/invoices/{InvoiceId}	https://graph.microsoft.com/v1.0/reports/partners/billing/usage/billed/export
Eingabeparameter für die abgerechnete tägliche Nutzungs-API	Um Parameter in der API-Anforderung anzugeben, fügen Sie die invoiceId in die Anforderungs-URL ein. Darüber hinaus können Sie einen optionalen Fragmentparameter in die Abfragezeichenfolge einschließen, um den vollständigen Satz von Attributen abzurufen. Um beispielsweise den vollständigen Satz von Attributen abzurufen, hängen Sie ?fragment=full an die Anforderungs-URL an.	Um Eingaben bereitzustellen, fügen Sie ein JSON-Objekt in den Anforderungstext ein. Ihr JSON sollte über die folgenden Eigenschaften verfügen: * invoiceId: Der eindeutige Bezeichner der Rechnung. Beispiel: G00012345. * attributeSet: Die Attribute, die in der Antwort enthalten sein sollen, z. B. "vollständig". Hier sehen Sie ein JSON-Beispielobjekt, das die eigenschaften invoiceId und attributeSet enthält: {<br> "invoiceId": "G00012345",<br> "attributeSet": "full"<br>}
Manifestressource	Verwenden Sie eine separate GET /manifests/{id}-Methode, um die Manifestressource abzurufen.	Verwenden Sie die GET /operations/{Id}-Methode, um auf die Manifestressource in resourceLocation zuzugreifen. Diese Methode spart Zeit, da kein separater Aufruf von GET /manifests/{id} erforderlich ist.
Änderungen am Manifestschema
	"id": Nicht verfügbar	"id": Ein eindeutiger Bezeichner für die Manifestressource.
	"version": Verfügbar	"version": in "schemaversion" geändert.
	"dataFormat": Verfügbar	"dataFormat": Verfügbar.
	"utcCretedDateTime": Verfügbar	"utcCretedDateTime": In "createdDateTime" geändert.
	"eTag": Verfügbar	"eTag": Verfügbar.
	"partnerTenantId": Verfügbar	"partnerTenantId": Verfügbar
	"rootFolder": Verfügbar	"rootFolder": in "rootDirectory" geändert.
	"rootFolderSAS": Verfügbar	"rootFolderSAS": In "sasToken" geändert. Dieses Update stellt nur das Token ohne den Stammverzeichnispfad bereit. Verwenden Sie zum Suchen des Verzeichnisses stattdessen die Eigenschaft "rootDirectory".
	"partitionType": Verfügbar	"partitionType": Verfügbar.
	"blobCount": Verfügbar	"blobCount": Verfügbar.
	"sizeInBytes": Verfügbar	"sizeInBytes": Nicht verfügbar.
	"Blobs": Verfügbar	"blobs": Verfügbar.
	"blob-Objekt": Verfügbar	"blob-Objekt": Verfügbar.
	"name": Verfügbar	"name": Verfügbar.
	"partitionValue": Verfügbar	"partitionValue": Verfügbar.

Vergleichen Sie die Attribute der Bestellpositionen der täglich bewerteten Nutzung

Informationen zum Vergleichen der Attribute, die von der abgerechneten oder nicht abgerechneten Nutzungsabstimmungs-API für die Attributsätze "full" oder "basic" zurückgegeben werden, finden Sie in dieser Tabelle. Weitere Informationen zu diesen Attributen und ihren Bedeutungen finden Sie in der Datei Felder in der Abstimmung zur täglich bewerteten Nutzung.

Attribut	Vollständig	Grundlegend
PartnerId	ja	ja
PartnerName	ja	ja
CustomerId	ja	ja
CustomerName	ja	Ja
CustomerDomainName	ja	Nein
CustomerCountry	ja	Nein
MpnId	ja	Nein
Tier2MpnId	ja	Nein
InvoiceNumber	ja	ja
ProductId	ja	ja
SkuId	ja	ja
AvailabilityId	ja	Nein
SkuName	ja	ja
ProductName	ja	Nein
PublisherName	ja	ja
PublisherId	ja	Nein
SubscriptionDescription	ja	Nein
SubscriptionId	ja	ja
ChargeStartDate	ja	ja
ChargeEndDate	ja	ja
UsageDate	ja	ja
MeterType	ja	Nein
MeterCategory	ja	Nein
MeterId	ja	Nein
MeterSubCategory	ja	Nein
MeterName	ja	Nein
MeterRegion	ja	Nein
Einheit	ja	ja
ResourceLocation	ja	Nein
ConsumedService	ja	Nein
ResourceGroup	ja	Nein
ResourceURI	ja	ja
ChargeType	ja	ja
UnitPrice	ja	ja
Menge	ja	ja
UnitType	ja	Nein
BillingPreTaxTotal	ja	ja
BillingCurrency	ja	ja
PricingPreTaxTotal	ja	ja
PricingCurrency	ja	ja
ServiceInfo1	ja	Nein
ServiceInfo2	ja	Nein
`Tags`	ja	Nein
AdditionalInfo	ja	Nein
EffectiveUnitPrice	ja	ja
PCToBCExchangeRate	ja	ja
PCToBCExchangeRateDate	ja	Nein
EntitlementId	ja	ja
EntitlementDescription	ja	Nein
PartnerEarnedCreditPercentage	ja	Nein
CreditPercentage	ja	ja
CreditType	ja	ja
BenefitOrderID	ja	ja
BenefitID	ja	Nein
BenefitType	ja	ja

Wichtig

Notieren Sie sich diese Änderungen, wenn Sie von API v1 zu v2 wechseln.

• Jeder Attributname beginnt jetzt mit einem Großbuchstaben, um die Konsistenz mit der Datei aufrechtzuerhalten und die Lesbarkeit zu verbessern.

• unitOfMeasure wird auf Unit aktualisiert. Die Bedeutung und der Wert bleiben unverändert, wodurch der Attributname vereinfacht wird.

• resellerMpnId ist jetzt Tier2MpnId. Die Bedeutung und der Wert sind identisch.

• rateOfPartnerEarnedCredit wird auf PartnerEarnedCreditPercentage aktualisiert. Der neue Name und Wert spiegeln jetzt den Prozentsatz anstelle des Bruchteils wider, wodurch die Werte leichter zu verstehen sind. Beispielsweise beträgt 0,15 jetzt 15 %.

• rateOfCredit ist jetzt CreditPercentage. Sowohl der Name als auch der Wert wurden geändert, um ein klareres Verständnis zu bieten. Beispielsweise ist 1,00 jetzt 100 %.

Wir glauben, dass diese Änderungen die APIs intuitiver und einfacher zu bedienen machen.

Beispielcode abrufen

Informationen zur Verwendung dieser API finden Sie unter dem folgenden Link, der C#-Beispielcode enthält.

Partner Center-API-Beispiele: Abrufen von Abrechnungsdaten.