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 neuen täglich bewerteten Nutzungssausgleichs-APIs verwenden erweiterte Techniken wie Valet-Schlüssel und asynchrone Anforderungsantwortmuster . 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.
Unsere APIs verwenden optimierte Techniken, um Ihre Effizienz zu steigern, sodass Sie schnellere Ergebnisse mit weniger Aufwand erzielen können. Nutzen Sie diese APIs, um den Datenzugriff zu vereinfachen und Ihre Gesamteffizienz zu verbessern.
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 derzeit nur für die öffentliche/globale Cloud von MS Graph verwenden. Sie sind für Azure Government oder Azure China 21Vianet noch nicht verfügbar.
Wichtig
Um Ihrer App Zugriff auf Partnerabrechnungsdaten zu ermöglichen, folgen Sie diesem Link und machen Sie sich mit den Authentifizierungs- und Autorisierungsgrundlagen für Microsoft Graph vertraut.
Sie können die Berechtigung "PartnerBilling.Read.All" entweder über das Azure-Portal oder das Entra Admin Center zuweisen. Gehen Sie dazu wie folgt vor:
- Registrieren Sie Ihre App auf der Microsoft Entra-Startseite unter dem Abschnitt App-Registrierungen.
- Um die erforderliche Berechtigung zu erteilen, wechseln Sie zur Seite "Microsoft Entra App" unter dem Abschnitt "API-Berechtigungen". Wählen Sie "Berechtigung hinzufügen" und dann den Bereich "PartnerBilling.Read.All" aus.
Durch Ausführen dieser Schritte stellen Sie sicher, dass Ihre App über den erforderlichen Zugriff auf Partnerabrechnungsdaten verfügt.
Hinweis
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.
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
API-Übersicht
Um Ihnen beim asynchronen Abrufen von täglich bewerteten E-Commerce-Nutzungspositionen zu helfen, bieten wir zwei wichtige API-Endpunkte an. Hier ist ein optimiertes Handbuch für die ersten Schritte:
Endpunkt für Verwendungszeilenelemente
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.
Vorgangsstatusendpunkt
Überprüfen Sie als Nächstes 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. Sobald der Vorgang abgeschlossen ist, 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.
Indem Sie diese Schritte ausführen, können Sie Ihren Rechnungsausgleichsprozess effizient verwalten.
Sequenzdiagramm
Hier ist ein Sequenzdiagramm, das die Schritte zum Herunterladen der Abstimmungsdaten zeigt.
Benutzeraktionssequenz
Führen Sie die folgenden Schritte aus, um neue E-Commerce-Artikel für die tägliche Nutzungsabstimmung abzurufen:
Schritt 1: Senden 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 genaue Daten zu gewährleisten, können Sie bis zu 24 Stunden für die Verfügbarkeit zulassen. 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 neuesten nicht abgerechneten täglich bewerteten Nutzungsdaten möglicherweise erst angezeigt, wenn die in Rechnung gestellten Nutzungsdaten des vorherigen Monats verfügbar sind. Nachdem Sie die in Rechnung gestellten Nutzungsdaten erhalten haben, können Sie alle aktualisierten nicht berechneten Nutzungsdaten ab Dem Anfang des Monats abrufen.
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 die tägliche Bewertete Nutzung für den aktuellen oder letzten Kalendermonat oder Abrechnungszeitraum zu erhalten, verwenden Sie "current" oder "last" (identisch mit "previous" in 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. Je nach 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 Status basierend auf Ihren Anforderungen finden Sie unter Statuses.
| 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. |
Schritt 2: Überprüfen des Anforderungsstatus
Um den Status einer Anforderung nachzuverfolgen, stellen Sie sicher, dass Sie eine HTTP 200-Antwort erhalten, die "erfolgreich" oder "fehlgeschlagen" angibt. Bei erfolgreicher Ausführung 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
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 | 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, bis die im Header "Retry-After" angegebene Zeit angegeben ist, und führen Sie dann einen weiteren Aufruf aus, um den Status zu überprüfen. running: Wait for the time specified in the "Retry-After" header, then make another call to check the status. 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
| Attribute | 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. Legen Sie im Code keine feste Anzahl von Zeilenelementen oder Dateigrößen fest, da sich diese Werte ä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 in mehrere Dateien aufgeteilt, 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": "0e195b37-4574-4539-bc42-0e539b9684c0",
"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"
}
\]
}
}
Schritt 3: Herunterladen täglich bewerteter Verwendungs-Abstimmungszeilenelemente aus Azure Blob Storage
Zunächst müssen Sie das SAS-Token (Shared Access Signature) und den Blob-Speicherort abrufen. Diese Details finden Sie in den Eigenschaften "sasToken" und "rootDirectory" der Manifestnutzlast-API-Antwort. Verwenden Sie dann das Azure Storage SDK/Tool, um die BLOB-Datei herunterzuladen und zu entzippen. 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.
Standard-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 – Unzulässig | 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 | 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
Sehen Sie sich die Vergleichstabelle an, um die Unterschiede zwischen der Betaversion und den allgemein verfügbaren (GA)-Versionen zu sehen. Wenn Sie derzeit die Betaversion verwenden, ist der Übergang zur GA-Version einfach und einfach.
| 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¤cyCode=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. |
Attribute des täglich bewerteten Nutzungsausgleichspostens
Informationen zum Vergleichen der Attribute, die von der Rechnungsabstimmungs-API für die Attributsätze "full" oder "basic" zurückgegeben werden, finden Sie in der folgenden Tabelle. Weitere Informationen zu diesen Attributen finden Sie in dieser Dokumentation.
| 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 von v2 wechseln.
Jeder Attributname beginnt jetzt mit einem Großbuchstaben .
unitOfMeasure wird auf Unit aktualisiert. Ihre Bedeutung und ihr Wert bleiben unverändert.
resellerMpnId ist jetzt Tier2MpnId. Die Bedeutung und der Wert sind identisch.
rateOfPartnerEarnedCredit wird auf PartnerEarnedCreditPercentage aktualisiert. Der neue Name und wert geben nun den Prozentsatz anstelle des Bruchs wieder. Beispielsweise beträgt 0,15 jetzt 15 %.
rateOfCredit ist jetzt CreditPercentage. Sowohl der Name als auch der Wert wurden geändert. Beispielsweise ist 1,00 jetzt 100 %.
Wir glauben, dass diese Änderungen die APIs intuitiver und einfacher zu bedienen machen.
Beispielcode
Informationen zur Verwendung dieser API finden Sie unter dem folgenden Link, der C#-Beispielcode enthält.