Dela via

Hämta distributionsinformation för en appinlämning

Använd den här metoden i Microsoft Store API för inlämning för att hämta paketdistribution information för en paketflyginlämning. Mer information om processen för att skapa en appöverföring med hjälp av Microsoft Store-api:et för insändning finns i Hantera appöverföringar.

Förutsättningar

Om du vill använda den här metoden måste du först göra följande:

  • Om du inte redan har gjort det, slutför alla krav för inlämning till Microsoft Store-API:et.
  • Hämta en Azure AD-åtkomsttoken som ska användas i begärandehuvudet för den här metoden. När du har fått en åtkomsttoken har du 60 minuter på dig att använda den innan den upphör att gälla. När token har upphört att gälla kan du skaffa en ny.
  • Skapa en sändning för en av dina appar. Du kan göra detta i Partner Center, eller genom att använda metoden skapa en appinlämning.

Begäran

Den här metoden har följande syntax. Se följande avsnitt för användningsexempel och beskrivningar av parametrarna för sidhuvud och begäran.

Metod Begäran om URI
FÅ https://manage.devcenter.microsoft.com/v1.0/my/applications/{applicationId}/submissions/{submissionId}/packagerollout

Förfrågningshuvudrad

Rubrik Typ Beskrivning
Auktorisering snöre Obligatoriskt. Azure AD-åtkomsttokenet i formen Bearer<token>.

Parametrar för begäran

Namn Typ Beskrivning
applicationId snöre Obligatoriskt. Store-ID för appen som innehåller inlämningen med den paketdistributionsinformation du vill få tag i. Mer information om Store-ID finns i Visa information om appidentitet.
insändningsID snöre Obligatoriskt. ID:t för sändningen med den information om paketdistribution som du vill få. Det här ID:t finns i svarsdatan för begäran om att skicka in en app. För en inlämning som har skapats i Partnercenter är detta ID också tillgängligt i URL:en för insändningssidan i Partnercenter.

begäranens innehåll

Ange ingen begärandetext för den här metoden.

Exempel på begäran

I följande exempel visas hur du hämtar utrullningsinformation för en appinlämning.

GET https://manage.devcenter.microsoft.com/v1.0/my/applications/9NBLGGH4R315/submissions/1152921504621243649/packagerollout HTTP/1.1
Authorization: Bearer <your access token>

Svar

I följande exempel visas JSON-svarstexten för ett lyckat anrop till den här metoden för en appöverföring med gradvis paketdistribution aktiverad. Mer information om värdena i svarstexten finns i Resurs för paketdistribution.

{
    "isPackageRollout": true,
    "packageRolloutPercentage": 25.0,
    "packageRolloutStatus": "PackageRolloutInProgress",
    "fallbackSubmissionId": "1212922684621243058"
}

Om apputskicket inte har aktiverat gradvis distribution av paket returneras följande svarsinnehåll.

{
    "isPackageRollout": false,
    "packageRolloutPercentage": 0.0,
    "packageRolloutStatus": "PackageRolloutNotStarted",
    "fallbackSubmissionId": "0"
}

Felkoder

Om begäran inte kan slutföras innehåller svaret någon av följande HTTP-felkoder.

Felkod Beskrivning
404 Det gick inte att hitta insändningen.
409 Sändningen tillhör inte den angivna appen, eller så använder appen en PartnerCenter-funktion som för närvarande inte stöds av Microsoft Store-api:et för överföring.
  • Last updated on