Gefactureerde en niet-gefactureerde dagelijkse afstemmings-API voor gebruik v2 (GA)
van toepassing op: Partnercentrum (niet beschikbaar in Azure Government of Azure China 21Vianet)
Inzicht in de architectuur
De nieuwe asynchrone API biedt aanzienlijke vooruitgang in de manier waarop we toegang tot facturerings- en afstemmingsgegevens verwerken. Deze aanpak lost uitdagingen op die zijn gekoppeld aan traditionele synchrone methoden, zoals het onderhouden van langdurige verbindingen en het verwerken van grote gegevensbatches. Dit zijn de belangrijkste voordelen en mechanismen van deze API:
Belangrijke onderdelen
Beveiligde toegang met valet sleutel patroon
De -valetsleutel patroon biedt veilige, beperkte toegang tot uw factureringsgegevens. Net als bij hoe iemand met een valetsleutel uw auto kan besturen zonder toegang te krijgen tot de kofferbak, zorgt dit patroon voor gedetailleerd toegangsbeheer. In plaats van referenties te delen, verleent een SAS-token (Shared Access Signature) beperkte, tijdsgebonden toegang tot specifieke resources. Dit patroon vermindert het risico op onbevoegde toegang door nauwkeurige verlooptijden en toegangsmachtigingen te configureren.
Verbeterde efficiëntie via asynchroon aanvraag-antwoordpatroon
U kunt het zien als bestellen in een druk restaurant. In plaats van op de teller te wachten, ontvangt u een buzzer en kunt u andere dingen doen terwijl uw bestelling wordt voorbereid. Wanneer de gegevens gereed zijn, krijgt u een bericht van het systeem.
De asynchrone aard van de API betekent dat u een aanvraag indient en dat het systeem deze op de achtergrond verwerkt. Deze asynchrone verzoek-antwoord maakt efficiënt gebruik van resources, vermindert de belasting van de server en minimaliseert time-outs en fouten die vaak voorkomen bij het ophalen van synchrone gegevens.
Flexibiliteit in machtigingen voor gegevenstoegang
SAS-tokens bieden flexibiliteit bij het beheren van machtigingen voor gegevenstoegang. U kunt tokens genereren die toegang verlenen tot alle kenmerken van de gefactureerde factuurafstemmingsgegevens of de toegang tot specifieke subsets beperken. Met deze granulariteit kunnen organisaties de toegang tot gegevens aanpassen volgens intern beleid en wettelijke vereisten, waardoor beveiliging en naleving worden verbeterd.
Vereenvoudigde werkstroom en verbeterde verwerkingstijden
Het asynchrone aanvraagantwoordpatroon stroomlijnt gegevensverwerking door dynamische toegang toe te staan in plaats van vaste batches van 2000 regelitems. Deze aanpak leidt tot snellere resultaten en verbeterde verwerkingstijden, waardoor de integratie van facturerings- en afstemmingsgegevens in bestaande systemen en werkstromen wordt vereenvoudigd.
Voordelen
Prestatievoordelen
In plaats van langdurige verbindingen te onderhouden en vaste batches te verwerken, kunt u met het nieuwe systeem:
Maak een snelle eerste aanvraag.
Een beveiligd toegangstoken ontvangen.
Gegevens in uw eigen tempo verwerken.
Krijg precies toegang tot wat u nodig hebt wanneer u het nodig hebt.
Beveiligingsverbeteringen
Het valetsleutelpatroon, geïmplementeerd via SAS-tokens, biedt:
Beperkte toegang.
Beperkte machtigingen.
Verwijdering van het delen of opslaan van permanente referenties.
Fijnmazig toegangsbeheer.
Architectonische voordelen
Het asynchrone aanvraagantwoordpatroon fungeert als een persoonlijke assistent die:
Verwerkt uw aanvraag.
Hiermee wordt de taak op de achtergrond verwerkt.
U krijgt een bericht wanneer alles klaar is.
Geoptimaliseerde API's gebruiken voor verbeterde prestaties
Het gebruik van deze geoptimaliseerde API's stroomlijnt de werkstroom en verbetert de algehele prestaties in gegevensbeheer. Door veilige toegangsbeheer en efficiënte mechanismen voor het ophalen te gebruiken, bereikt u betere resultaten met minder inspanning, wat leidt tot een verbeterde operationele efficiëntie.
Tot slot is de nieuwe asynchrone API voor toegang tot facturerings- en afstemmingsgegevens via Azure-blobs een krachtig hulpprogramma. Het biedt veilige, efficiënte toegang tot financiële gegevens, stroomlijnende werkstromen, het verminderen van de belasting van de server en het verbeteren van verwerkingstijden, allemaal met hoge beveiliging en naleving.
Notitie
De nieuwe API's worden niet gehost op de Partner Center API-host. In plaats daarvan kunt u ze vinden in MS Graph op Gebruik de Microsoft Graph API om factureringsgegevens van partners te exporteren. Raadpleeg de volgende details om toegang te krijgen tot deze API's.
U kunt deze API's voorlopig alleen gebruiken voor de openbare wereldwijde MS Graph-cloud. Ze zijn nog niet beschikbaar voor Azure Government of Azure China.
Uw app toegang geven tot factureringsgegevens van partners
Volg deze koppeling om uw app toegang te geven tot factureringsgegevens van partners en vertrouwd te raken met de basisbeginselen voor verificatie en autorisatie van voor Microsoft Graph. Deze stap is van cruciaal belang omdat uw app veilig toegang heeft tot de benodigde gegevens.
De machtiging PartnerBilling.Read.All toewijzen
Wijs de machtiging PartnerBilling.Read.All toe met behulp van de Azure-portal of het Microsoft Entra-beheercentrum. Deze stappen zorgen ervoor dat uw app de vereiste toegang heeft tot de factureringsgegevens van de partner.
- Registreer uw app op de startpagina van Microsoft Entra onder de sectie App-registraties.
- Verleen de benodigde machtigingen door naar de Microsoft Entra App-pagina te gaan. Selecteer in de sectie API-machtigingen Een machtiging toevoegen en kies het bereik PartnerBilling.Read.All.
Inzicht in de verschillen tussen de bèta- en GA-versies
Als u onze bètaversie gebruikt, zult u waarschijnlijk de overgang naar de algemene beschikbaarheidsversie (GA) soepel en intuïtief vinden. Om u inzicht te geven in de updates en verbeteringen, raden we u aan bèta- en GA-versies te vergelijken. Als u deze updates begrijpt, kunt u de nieuwe functies en verbeteringen die beschikbaar zijn in de GA-versie maximaliseren.
Belangrijk
Het nieuwe dagelijkse gebruik van de handel omvat niet de kosten voor deze producten:
- Azure-reservering
- Azure-besparingsplan
- Office
- Dynamics
- Microsoft Power Apps
- Eeuwigdurende software
- Softwareabonnement
- SaaS-product dat niet van Microsoft of marketplace is
De API-eindpunten begrijpen en gebruiken
Om u te helpen bij het ophalen van gefactureerde nieuwe commerce dagelijks geclassificeerde gebruiksregelitems asynchroon, bieden we twee belangrijke API-eindpunten. Volg deze gestroomlijnde handleiding om snel aan de slag te gaan.
Het eindpunt van het regelitem gebruiken
Gebruik eerst deze API om nieuwe dagelijkse verbruiksartikelen op te halen. Wanneer u een aanvraag indient, ontvangt u een HTTP-status van 202 en een locatieheader met een URL. Peil deze URL regelmatig totdat u de status geslaagd en een manifest-URL krijgt.
Gebruik het eindpunt voor de bewerkingsstatus
Door deze stappen te volgen, kunt u uw factuurafstemmingsproces efficiënt beheren.
Controleer de bewerkingsstatus door deze API regelmatig aan te roepen. Als de gegevens niet gereed zijn, bevat het antwoord een header Opnieuw proberen na die aangeeft hoe lang moet worden gewacht voordat u het opnieuw probeert. Zodra de bewerking is voltooid, ontvangt u een manifestresource met een koppeling naar de opslagmap om de gebruiksgegevens te downloaden. Het antwoord segmenteren de bestanden om de doorvoer te verbeteren en I/O parallellisme mogelijk te maken.
Het sequentiediagram voor afstemmingsgegevens controleren
Hier volgt een sequentiediagram met de stappen voor het downloaden van de afstemmingsgegevens.
Volg de actiereeks van de gebruiker
Hier volgen de stappen voor de gebruikersactie om nieuwe commerce- dagelijkse afstemmingsregelitems voor gebruik op te halen:
- een aanvraag indienen
- De status van de aanvraag controleren
- Afstemmingsregelitems downloaden uit Azure Blob Storage-
Een aanvraag indienen
Dien een POST-aanvraag in bij het API-eindpunt.
Niet-gefactureerde dagelijkse verbruiksregelitems ophalen
Ontvang nieuwe handelsverkeer niet-gefactureerde dagelijkse verbruiksregelitems voor de huidige of laatste kalendermaand of factureringsperiode.
Notitie
U hebt toegang tot uw niet-gefactureerde dagelijkse verbruiksregelitems via de API- of Partnercentrum-portal. Om de nauwkeurigheid van gegevens te garanderen, kunt u maximaal 24 uur beschikbaar zijn. Afhankelijk van uw locatie en wanneer de meters het gebruik rapporteren, kunnen er verdere vertragingen optreden.
We prioriteren eerst de levering van gefactureerde dagelijkse gebruiksgegevens. Af en toe worden de meest recente niet-gefactureerde gegevens over dagelijks gebruik mogelijk niet weergegeven totdat de gefactureerde gegevens van de vorige maand beschikbaar zijn. Zodra u de gefactureerde gegevens hebt ontvangen, hebt u vanaf het begin van de maand toegang tot alle bijgewerkte niet-gefactureerde gebruiksgegevens.
belangrijkste punten:
- Het kan tot 24 uur duren voordat de gegevens beschikbaar zijn.
- Er kunnen verdere vertragingen optreden, afhankelijk van de rapportagetijden van uw locatie en meter.
- Gefactureerde dagelijkse gebruiksgegevens krijgen prioriteit boven niet-gefactureerde gegevens.
Uw begrip en geduld worden gewaardeerd omdat we ernaar streven om de meest nauwkeurige en tijdige informatie te bieden.
API-aanvraag
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"
}
Aanvraagtekst
| Kenmerk | Vereist | Type | Description |
|---|---|---|---|
| attributeSet | Onwaar | String | Kies 'volledig' voor alle kenmerken of basic voor een beperkte set. Als dit niet is opgegeven, is 'volledig' de standaardwaarde. Controleer de lijst met kenmerken in deze sectie. Optioneel. |
| billingPeriod | Waar | String | Als u niet-gefactureerd dagelijks gebruik wilt ophalen, gebruikt u 'current' voor de huidige factureringsperiode of 'laatste' voor de vorige factureringsperiode (hetzelfde als 'vorige' in v1 API). Vereist. |
| currencyCode | Waar | String | Valutacode voor partnerfacturering. Vereist. |
Aanvraagheaders
Als u headers voor de API wilt aanvragen, raadpleegt u Betrouwbaarheid en ondersteuning.
API-reactie
HTTP/1.1 202 Accepted
Location: https://graph.microsoft.com/v1.0/reports/partners/billing/operations/9ab9cb54-d07f-4f52-9ea6-a09d7de52c14
De API reageert meestal met een HTTP 202-status. U kunt ook andere statussen tegenkomen, afhankelijk van uw aanvragen. Deze statussen worden weergegeven in de sectie Statussen van standaard-API-antwoorden.
| Code | Description |
|---|---|
| 202 - Geaccepteerd | Uw aanvraag is geaccepteerd. Als u de status van uw aanvraag wilt controleren, voert u een query uit op de URL die is opgegeven in de locatieheader. |
Gefactureerde dagelijkse verbruiksregelitems ophalen
Ontvang nieuwe commerce gefactureerde dagelijkse verbruiksregelitems voor een factuur voor de gesloten factureringsperiode.
API-aanvraag
POST https://graph.microsoft.com/v1.0/reports/partners/billing/usage/billed/export
{
"invoiceId": "G00012345",
"attributeSet": "full"
}
Queryparameters
N.v.t.
Aanvraagtekst
| Kenmerk | Vereist | Type | Description |
|---|---|---|---|
| InvoiceId | Waar | String | Een unieke id voor elke factuur. Vereist. |
| attributeSet | Onwaar | String | Kies 'volledig' voor alle kenmerken of basic voor een beperkte set. Als dit niet is opgegeven, is 'volledig' de standaardwaarde. Controleer de lijst met kenmerken in deze sectie. Optioneel. |
Aanvraagheader
Aanvraagheaders voor de API. Zie de betrouwbaarheid en ondersteuning voor meer informatie.
API-reactie
HTTP/1.1 202 Geaccepteerd
Locatie: https://graph.microsoft.com/v1.0/reports/partners/billing/operations/9ab9cb54-d07f-4f52-9ea6-a09d7de52c14
Wanneer u de API gebruikt, wordt doorgaans een HTTP 202-status geretourneerd. Zie statussenvoor andere mogelijke statussen op basis van uw aanvragen.
| Code | Description |
|---|---|
| 202 - Geaccepteerd | Uw aanvraag is geaccepteerd. Als u de status van uw aanvraag wilt controleren, voert u een query uit op de URL die is opgegeven in de locatieheader. |
De aanvraagstatus controleren
Als u de status van een aanvraag wilt bijhouden, moet u ervoor zorgen dat u een HTTP 200-antwoord ontvangt. Dit is een standaardstatuscode die 'geslaagd' of 'mislukt' aangeeft. Als dit lukt, vindt u de manifest-URL in het kenmerk resourceLocation. Dit kenmerk biedt een eindpunt voor toegang tot de vereiste informatie.
Bewerkingsstatus ophalen
Haalt de status van een aanvraag op.
API-aanvraag
Aanvraagparameters
| Naam | Opnemen in | Vereist | Type | Description |
|---|---|---|---|---|
| operationId | Aanvraag-URI | Waar | String | Een unieke id om de aanvraagstatus te controleren. Vereist. |
Aanvraagheader
Als u headers voor de API wilt aanvragen, raadpleegt u Betrouwbaarheid en ondersteuning.
Aanvraagtekst
N.v.t.
Antwoordstatus
Naast de standaard HTTP-statussen die worden vermeld in de standaard-API-antwoordstatussen, kan de API ook de volgende HTTP-status retourneren:
| Code | Description |
|---|---|
| 410 - Verdwenen | De manifestkoppeling verloopt na een ingestelde tijd. Als u de manifestkoppeling opnieuw wilt ophalen, verzendt u een nieuwe aanvraag. |
Nettolading van antwoord
De nettolading van het API-antwoord bevat de volgende kenmerken:
| Kenmerk | Vereist | Description |
|---|---|---|
| id | Waar | Een unieke id voor elk antwoord. Vereist. |
| status | Waar |
Waarden en acties: vereist: niet gestart: wacht op de opgegeven duur in de header 'Opnieuw proberen-na', en voer vervolgens nog een aanroep uit om de status te controleren. wordt uitgevoerd: wacht op de opgegeven duur in de header 'Opnieuw proberen-na', en voer vervolgens nog een aanroep uit om de status te controleren. geslaagd: de gegevens zijn gereed. Haal de nettolading van het manifest op met behulp van de URI die is opgegeven in resourceLocation. mislukt: de bewerking is permanent mislukt. Start het opnieuw op. |
| createdDateTime | Waar | Het tijdstip waarop de aanvraag is ingediend. Vereist. |
| lastActionDateTime | Waar | De laatste keer dat de status is gewijzigd. Vereist. |
| resourceLocation | Onwaar | De URI voor de nettolading van het manifest. Optioneel. |
| error | Onwaar | Details over eventuele fouten, opgegeven in JSON-indeling. Optioneel. Kenmerken zijn opgenomen: bericht: Beschrijving van de fout. code: Het type fout. |
Resourcelocatieobject
| Kenmerk | Description |
|---|---|
| id | Een unieke id voor het manifest. |
| schemaVersion | Versie van het manifestschema. |
| dataFormat | Indeling van het factureringsgegevensbestand. compressedJSON: gegevensindeling waarbij elke blob een gecomprimeerd bestand is dat gegevens in JSON-regelsindeling bevat. Als u de gegevens uit elke blob wilt ophalen, moet u deze decomprimeren. |
| createdDateTime | Datum en tijd waarop het manifestbestand is gemaakt. |
| eTag | Versie van de manifestgegevens. Een wijziging in factureringsgegevens genereert een nieuwe waarde. |
| partnerTenantId | Microsoft Entra-id van de tenant van de partner. |
| rootDirectory | Hoofdmap van het bestand. |
| sasToken | SAS-token (Shared Access Signature) waarmee u alle bestanden in de map kunt lezen. |
| partitionType | Verdeelt gegevens in meerdere blobs op basis van het kenmerk partitionValue . Het systeem splitst partities die het ondersteunde aantal overschrijden. Standaard worden gegevens gepartitioneerd op basis van het aantal regelitems in het bestand. Vermijd hardcodering van regelitems of bestandsgrootten, omdat deze kunnen veranderen. |
| blobCount | Totaal aantal bestanden voor deze partnertenant-id. |
| blobs | Een JSON-matrix van 'blob'-objecten die de bestandsgegevens voor de tenant-id van de partner bevatten. |
| blobobject | Een object met de volgende details: naam en partitionValue |
| naam | Naam van de blob. |
| partitionValue | Partitie die het bestand bevat. De grote partitie wordt gesplitst in meerdere bestanden op basis van bepaalde criteria, zoals de bestandsgrootte of het aantal records, waarbij elk bestand dezelfde "partitionValue"bevat. |
API-aanvraag
GET <https://graph.microsoft.com/v1.0/reports/partners/billing/operations/9ab9cb54-d07f-4f52-9ea6-a09d7de52c14>
API-reactie
Het antwoord raadt aan om 10 seconden te wachten voordat u het opnieuw probeert bij het verwerken van gegevens.
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-aanvraag
(10 seconden na de vorige aanvraag...)
GET <https://graph.microsoft.com/v1.0/reports/partners/billing/operations/9ab9cb54-d07f-4f52-9ea6-a09d7de52c14>
API-reactie
De API retourneert de status Geslaagd en de URI voor resourceLocation.
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"
}
\]
}
}
Afstemmingsregelitems downloaden uit Azure Blob Storage
Eerst moet u het SAS-token (Shared Access Signature) en de blobopslaglocatie verkrijgen. Zoek deze details in de sasToken- en rootDirectory-eigenschappen van de payload API-respons van het manifest.
Voer de volgende stappen uit om door te gaan:
- Download het blobbestand met behulp van de Azure Storage SDK/het hulpprogramma.
- Pak het bestand uit, dat zich in de JSONLines indeling bevindt.
Tip
Bekijk de voorbeeldcode. U ziet hoe u het Azure-blobbestand downloadt en uitpakt naar uw lokale database.
Inzicht in de standaard-API-antwoordstatussen
Mogelijk ontvangt u deze HTTP-statussen van het API-antwoord:
| Code | Beschrijving |
|---|---|
| 400 - Foute aanvraag | De aanvraag ontbreekt of bevat onjuiste gegevens. Controleer de hoofdtekst van het antwoord op foutdetails. |
| 401 - Onbevoegd | Verificatie is vereist voordat u de eerste aanroep doet. Verifiëren met de partner-API-service. |
| 403 - Verboden | U hebt niet de benodigde autorisatie om de aanvraag te doen. |
| 404 - Niet gevonden | De aangevraagde resources zijn niet beschikbaar met de opgegeven invoerparameters. |
| 410 - Verdwenen | De manifestkoppeling is niet meer geldig of actief. Dien een nieuwe aanvraag in. |
| 500 - Interne serverfout | De API of de bijbehorende afhankelijkheden kunnen momenteel niet voldoen aan de aanvraag. Probeer het later opnieuw. |
| 5000 - Geen gegevens beschikbaar | Het systeem heeft geen gegevens voor de opgegeven invoerparameters. |
Bèta- en GA-versies vergelijken
Bekijk de volgende vergelijkingstabel om de verschillen tussen de bètaversie en de algemeen beschikbare (GA)-versies te bekijken. Als u momenteel de bètaversie gebruikt, is de overgang naar de GA-versie waarschijnlijk eenvoudig en eenvoudig.
| Belangrijke informatie | Bèta | Algemeen beschikbaar |
|---|---|---|
| API-hosteindpunt | https://ep-billingreconservice-prod-d5bfczcnfvbqbdhx.z01.azurefd.net/ |
https://graph.microsoft.com/v1.0/reports/partners/billing/usage/ |
| HTTP-methode | POSTEN | POSTEN |
| Niet-gefactureerd dagelijks geclassificeerd gebruiks-API-eindpunt | https://ep-billingreconservice-prod-d5bfczcnfvbqbdhx.z01.azurefd.net/v1/unbilledusage |
https://graph.microsoft.com/v1.0/reports/partners/billing/usage/unbilled/export |
| Invoerparameters voor de niet-gefactureerde dagelijkse gebruiks-API | Als u parameters in de API-aanvraag wilt opgeven, neemt u deze op in de querytekenreeks van de aanvraag-URL. Als u bijvoorbeeld de parameters periode en currencyCode wilt opgeven, voegt u deze toe aan ?period=current¤cyCode=usd de aanvraag-URL. |
Als u invoer wilt opgeven, neemt u een JSON-object op in de aanvraagbody. Uw JSON moet de volgende eigenschappen hebben: * currencyCode: uw factureringsvaluta. Bijvoorbeeld USD. * billingPeriod: De factureringsperiode voor de factuur. Bijvoorbeeld huidige. Hier volgt een voorbeeld van een JSON-object dat de eigenschappen currencyCode en billingPeriod bevat: <br>{<br> "currencyCode": "USD",<br> "billingPeriod": "current"<br>} |
| Gefactureerd dagelijks geclassificeerd api-eindpunt voor gebruik | https://ep-billingreconservice-prod-d5bfczcnfvbqbdhx.z01.azurefd.net/v1/billedusage/invoices/{InvoiceId} |
https://graph.microsoft.com/v1.0/reports/partners/billing/usage/billed/export |
| Invoerparameters voor de gefactureerde dagelijkse gebruiks-API | Als u parameters in de API-aanvraag wilt opgeven, neemt u de invoiceId op in de aanvraag-URL. Daarnaast kunt u een optionele fragmentparameter in de querytekenreeks opnemen om de volledige set kenmerken op te halen. Als u bijvoorbeeld de volledige set kenmerken wilt ophalen, voegt u deze toe ?fragment=full aan de aanvraag-URL. |
Als u invoer wilt opgeven, neemt u een JSON-object op in de aanvraagbody. Uw JSON moet de volgende eigenschappen hebben: * invoiceId: de unieke id van de factuur. Bijvoorbeeld G00012345. * attributeSet: de kenmerken die in het antwoord moeten staan, zoals volledig. Hier volgt een voorbeeld van een JSON-object dat de eigenschappen invoiceId en attributeSet bevat: {<br> "invoiceId": "G00012345",<br> "attributeSet": "full"<br>} |
| Manifestresource | Gebruik een afzonderlijke METHODE GET /manifests/{id} om de manifestresource op te halen. | Gebruik de methode GET /operations/{Id} om toegang te krijgen tot de manifestresource in resourceLocation. Deze methode bespaart tijd door de noodzaak van een afzonderlijke aanroep naar GET /manifests/{id} te elimineren. |
| Wijzigingen in het manifestschema | ||
| "id": niet beschikbaar | 'id': een unieke id voor de manifestresource. | |
| "versie": Beschikbaar | "version": gewijzigd in "schemaversion.". | |
| "dataFormat": Beschikbaar | "dataFormat": Beschikbaar. | |
| "utcCretedDateTime": Beschikbaar | "utcCretedDateTime": gewijzigd in "createdDateTime.". | |
| "eTag": Beschikbaar | "eTag": Beschikbaar. | |
| "partnerTenantId": Beschikbaar | "partnerTenantId": Beschikbaar | |
| "rootFolder": Beschikbaar | "rootFolder": gewijzigd in "rootDirectory." | |
| "rootFolderSAS": Beschikbaar | 'rootFolderSAS': gewijzigd in 'sasToken'. Deze update biedt alleen het token zonder het pad naar de hoofdmap. Als u de map wilt zoeken, gebruikt u in plaats daarvan de eigenschap rootDirectory. | |
| "partitionType": Beschikbaar | "partitionType": Beschikbaar. | |
| "blobCount": Beschikbaar | "blobCount": Beschikbaar. | |
| "sizeInBytes": Beschikbaar | "sizeInBytes": Niet beschikbaar. | |
| "blobs": Beschikbaar | "blobs": Beschikbaar. | |
| "blob-object": Beschikbaar | "blobobject": Beschikbaar. | |
| "name": Beschikbaar | "name": Beschikbaar. | |
| "partitionValue": Beschikbaar | "partitionValue": Beschikbaar. |
Basis- en volledige dagelijkse afstemmingskenmerken voor gebruik vergelijken
Raadpleeg deze tabel om de kenmerken te vergelijken die worden geretourneerd door de gefactureerde of niet-gefactureerde gebruiksafstemmings-API voor de 'volledige' of 'basis'-kenmerksets. Zie de Velden in het bestand met dagelijkse afstemming van het geschatte gebruik voor meer informatie over deze kenmerken en hun betekenissen.
| Kenmerk | Volledig | Basis |
|---|---|---|
| PartnerId | ja | ja |
| PartnerName | ja | ja |
| CustomerId | ja | ja |
| CustomerName | ja | Ja |
| CustomerDomainName | ja | nee |
| CustomerCountry | ja | nee |
| MpnId | ja | nee |
| Tier2MpnId | ja | nee |
| InvoiceNumber | ja | ja |
| Product-id | ja | ja |
| SkuId | ja | ja |
| AvailabilityId | ja | nee |
| SkuName | ja | ja |
| ProductName | ja | nee |
| PublisherName | ja | ja |
| PublisherId | ja | nee |
| SubscriptionDescription | ja | nee |
| SubscriptionId | ja | ja |
| ChargeStartDate | ja | ja |
| ChargeEndDate | ja | ja |
| UsageDate | ja | ja |
| MeterType | ja | nee |
| MeterCategory | ja | nee |
| MeterId | ja | nee |
| MeterSubCategory | ja | nee |
| MeterName | ja | nee |
| MeterRegion | ja | nee |
| Eenheid | ja | ja |
| ResourceLocation | ja | nee |
| ConsumedService | ja | nee |
| ResourceGroup | ja | nee |
| ResourceURI | ja | ja |
| ChargeType | ja | ja |
| UnitPrice | ja | ja |
| Hoeveelheid | ja | ja |
| UnitType | ja | nee |
| BillingPreTaxTotal | ja | ja |
| BillingCurrency | ja | ja |
| PricingPreTaxTotal | ja | ja |
| PricingCurrency | ja | ja |
| ServiceInfo1 | ja | nee |
| ServiceInfo2 | ja | nee |
| Tags | ja | nee |
| AdditionalInfo | ja | nee |
| EffectiveUnitPrice | ja | ja |
| PCToBCExchangeRate | ja | ja |
| PCToBCExchangeRateDate | ja | nee |
| EntitlementId | ja | ja |
| EntitlementDescription | ja | nee |
| PartnerEarnedCreditPercentage | ja | nee |
| CreditPercentage | ja | ja |
| CreditType | ja | ja |
| BenefitOrderID | ja | ja |
| BenefitID | ja | nee |
| BenefitType | ja | ja |
Belangrijk
Noteer deze wijzigingen wanneer u overstapt van API v1 naar v2.
Elke kenmerknaam begint met een hoofdletter letter om de consistentie met het bestand te behouden en de leesbaarheid te verbeteren.
unitOfMeasure wordt bijgewerkt naar Unit. De betekenis en waarde blijven ongewijzigd, waardoor de kenmerknaam wordt vereenvoudigd.
resellerMpnId is nu Tier2MpnId. De betekenis en waarde zijn hetzelfde.
rateOfPartnerEarnedCredit wordt bijgewerkt naar PartnerEarnedCreditPercentage. De nieuwe naam en waarde weerspiegelen het percentage in plaats van als breukgetal, waardoor het gemakkelijker te begrijpen is. 0,15 is nu bijvoorbeeld 15%.
rateOfCredit is nu CreditPercentage. Zowel de naam als de waarde zijn gewijzigd om een duidelijker begrip te bieden. 1,00 is nu bijvoorbeeld 100%.
We geloven dat deze wijzigingen ervoor zorgen dat de API's intuïtiever en eenvoudiger te gebruiken zijn.
Voorbeeldcode
Als u hulp nodig hebt bij het migreren naar deze API, raadpleegt u de koppeling met C#-voorbeeldcode.
Voorbeelden van partnercentrum-API' s: factureringsgegevens ophalen.