Abrufen aller Apps
Verwenden Sie diese Methode in der Microsoft Store-Übermittlungs-API, um Daten für die Apps abzurufen, die in Ihrem Partner Center-Konto registriert sind.
Voraussetzungen
Zur Verwendung dieser Methode sind folgende Schritte erforderlich:
- Wenn Sie dies noch nicht getan haben, müssen Sie alle Voraussetzungen für die Microsoft Store-Übermittlungs-API erfüllen.
- Rufen Sie ein Azure AD-Zugriffstoken ab, das im Anforderungsheader für diese Methode verwendet wird. Nachdem Sie ein Zugriffstoken erhalten haben, haben Sie 60 Minuten Zeit, es zu verwenden, bevor es abläuft. Wenn das Token abgelaufen ist, können Sie ein neues abrufen.
Anforderung
Diese Methode hat die folgende Syntax. In den folgenden Abschnitten finden Sie Verwendungsbeispiele und Beschreibungen des Header und Anforderungstexts.
Methode | Anforderungs-URI |
---|---|
GET | https://manage.devcenter.microsoft.com/v1.0/my/applications |
Anforderungsheader
Header | type | BESCHREIBUNG |
---|---|---|
Authorization | Zeichenfolge | Erforderlich. Das Azure AD-Zugriffstoken im Format Bearertoken<>. |
Anforderungsparameter
Alle Anforderungsparameter sind optional für diese Methode. Wenn Sie diese Methode ohne Parameter aufrufen, enthält die Antwort Daten für die ersten 10 Apps, die bei Ihrem Konto registriert sind.
Parameter | Typ | BESCHREIBUNG | Erforderlich |
---|---|---|---|
top | INT | Die Anzahl von Elementen, die in der Anforderung zurückgegeben werden sollen (d. h. die Anzahl der zurückzugebenden Apps). Wenn Ihr Konto über mehr Apps als der Wert verfügt, den Sie in der Abfrage festlegen, enthält der Antworttext einen relativen URI-Pfad, den Sie an den URI der Methode anfügen können, um die nächste Seite mit Daten anzufordern. | Nein |
skip | INT | Die Anzahl der Elemente, die in der Abfrage umgangen werden sollen, bevor die verbleibenden Elemente zurückgegeben werden. Verwenden Sie diesen Parameter, um große Datensätze durchzublättern. Zum Beispiel werden bei top=10 und skip=0 die Elemente 1 bis 10 abgerufen, bei top=10 und skip=10 die Elemente 11 bis 20 und so weiter. | Nein |
Anforderungstext
Stellen Sie keinen Anforderungstext für diese Methode bereit.
Anforderungsbeispiele
Im folgenden Beispiel wird veranschaulicht, wie die ersten 10 Apps abgerufen werden können, die für Ihr Konto registriert sind.
GET https://manage.devcenter.microsoft.com/v1.0/my/applications HTTP/1.1
Authorization: Bearer <your access token>
Im folgenden Beispiel wird veranschaulicht, wie Informationen über alle Apps abgerufen werden können, die für Ihr Konto registriert wurden. Rufen Sie zunächst die 10 besten Apps ab:
GET https://manage.devcenter.microsoft.com/v1.0/my/applications?top=10 HTTP/1.1
Authorization: Bearer <your access token>
Rufen Sie dann rekursiv auf GET https://manage.devcenter.microsoft.com/v1.0/my/{@nextLink}
, bis {@nextlink}
NULL ist oder in der Antwort nicht vorhanden ist. Beispiel:
GET https://manage.devcenter.microsoft.com/v1.0/my/applications?skip=10&top=10 HTTP/1.1
Authorization: Bearer <your access token>
GET https://manage.devcenter.microsoft.com/v1.0/my/applications?skip=20&top=10 HTTP/1.1
Authorization: Bearer <your access token>
GET https://manage.devcenter.microsoft.com/v1.0/my/applications?skip=30&top=10 HTTP/1.1
Authorization: Bearer <your access token>
Wenn Sie die Gesamtzahl der Apps in Ihrem Konto bereits kennen, können Sie diese Zahl einfach im top-Parameter übergeben, um Informationen zu all Ihren Apps zu erhalten.
GET https://manage.devcenter.microsoft.com/v1.0/my/applications?top=23 HTTP/1.1
Authorization: Bearer <your access token>
Antwort
Im folgenden Beispiel wird der JSON-Antworttext veranschaulicht, der von einer erfolgreichen Anforderung für die ersten 10 Apps zurückgegeben wird, die für ein Entwicklerkonto mit insgesamt 21 Apps registriert wurden. Aus Platzgründen sind in diesem Beispiel nur die Daten für die ersten beiden Apps dargestellt, die von der Anforderung zurückgegeben werden. Weitere Informationen zu den Werten im Antworttext finden Sie im folgenden Abschnitt.
{
"@nextLink": "applications?skip=10&top=10",
"value": [
{
"id": "9NBLGGH4R315",
"primaryName": "Contoso sample app",
"packageFamilyName": "5224ContosoDeveloper.ContosoSampleApp_ng6try80pwt52",
"packageIdentityName": "5224ContosoDeveloper.ContosoSampleApp",
"publisherName": "CN=…",
"firstPublishedDate": "2016-03-11T01:32:11.0747851Z",
"pendingApplicationSubmission": {
"id": "1152921504621134883",
"resourceLocation": "applications/9NBLGGH4R315/submissions/1152921504621134883"
}
},
{
"id": "9NBLGGH29DM8",
"primaryName": "Contoso sample app 2",
"packageFamilyName": "5224ContosoDeveloper.ContosoSampleApp2_ng6try80pwt52",
"packageIdentityName": "5224ContosoDeveloper.ContosoSampleApp2",
"publisherName": "CN=…",
"firstPublishedDate": "2016-03-12T01:49:11.0747851Z",
"lastPublishedApplicationSubmission": {
"id": "1152921504621225621",
"resourceLocation": "applications/9NBLGGH29DM8/submissions/1152921504621225621"
}
// Next 8 apps are omitted for brevity ...
}
],
"totalCount": 21
}
Antworttext
Wert | Typ | BESCHREIBUNG |
---|---|---|
value | array | Ein Array von Objekten, die Informationen zu jeder App enthalten, die für Ihr Konto registriert wurde. Weitere Informationen zu den Daten in den einzelnen Objekten finden Sie unter Anwendungsressource. |
@nextLink | Zeichenfolge | Wenn weitere Datenseiten vorhanden sind, enthält diese Zeichenfolge einen relativen Pfad, den Sie an den Basisanforderungs-URI https://manage.devcenter.microsoft.com/v1.0/my/ zum Anfordern der nächsten Datenseite anfügen können. Wenn beispielsweise der oberste Parameter des ursprünglichen Anforderungstexts auf 10 festgelegt ist, aber 20 Apps in Ihrem Konto registriert sind, enthält der Antworttext den @nextLink Wert , der applications?skip=10&top=10 angibt, dass Sie aufrufen https://manage.devcenter.microsoft.com/v1.0/my/applications?skip=10&top=10 können, um die nächsten 10 Apps anzufordern. |
totalCount | INT | Die Gesamtzahl der Zeilen im Datenergebnis für die Abfrage (d. h. die Gesamtanzahl von Apps, die für Ihr Konto registriert wurden). |
Fehlercodes
Wenn die Anforderung nicht erfolgreich abgeschlossen werden kann, enthält die Antwort einen der folgenden HTTP-Fehlercodes.
Fehlercode | BESCHREIBUNG |
---|---|
404 | Es wurden keine Apps gefunden. |
409 | Die Apps verwenden Partner Center-Features, die derzeit von der Microsoft Store-Übermittlungs-API nicht unterstützt werden. |
Verwandte Themen
Feedback
https://aka.ms/ContentUserFeedback.
Bald verfügbar: Im Laufe des Jahres 2024 werden wir GitHub-Issues stufenweise als Feedbackmechanismus für Inhalte abbauen und durch ein neues Feedbacksystem ersetzen. Weitere Informationen finden Sie unterFeedback senden und anzeigen für