Udostępnij przez

Aktualizacja zgłoszenia lotu w pakiecie

Użyj tej metody w interfejsie API przesyłania do Microsoft Store, aby zaktualizować istniejące zgłoszenie lotu pakietu. Po pomyślnym zaktualizowaniu przesłania przy użyciu tej metody, należy zatwierdzić przesłanie do przyjęcia i publikacji.

Aby uzyskać więcej informacji o tym, jak ta metoda pasuje do procesu tworzenia przesyłania pakietu przy użyciu interfejsu API przesyłania pakietu ze sklepu Microsoft Store, zobacz Zarządzanie przesyłaniem pakietów.

Wymagania wstępne

Aby użyć tej metody, należy najpierw wykonać następujące czynności:

  • Jeśli jeszcze tego nie zrobiłeś(-łaś), zrealizuj wszystkie wymagania wstępne dla API przesyłania do Microsoft Store.
  • Uzyskaj token dostępu usługi Azure AD do użycia w nagłówku żądania dla tej metody. Po uzyskaniu tokenu dostępu należy 60 minut używać go przed jego wygaśnięciem. Po wygaśnięciu tokenu można uzyskać nowy.
  • Utwórz zgłoszenie pakietu testowego dla jednej z Twoich aplikacji. Możesz to zrobić w Centrum partnerskim lub przy użyciu metody przesyłania pakietu lotu .

Żądanie

Ta metoda ma następującą składnię. Zapoznaj się z poniższymi sekcjami, aby zapoznać się z przykładami użycia i opisami nagłówka i treści żądania.

Metoda Żądanie URI
POŁÓŻ https://manage.devcenter.microsoft.com/v1.0/my/applications/{applicationId}/flights/{flightId}/submissions/{submissionId}

Nagłówek żądania

Nagłówek Typ Opis
Autoryzacja sznurek To jest wymagane. Token dostępu usługi Azure AD w postaci tokenu typu Bearer <>.

Parametry żądania

Nazwa Typ Opis
applicationId (identyfikator aplikacji) sznurek To jest wymagane. Identyfikator sklepu aplikacji, dla której chcesz zaktualizować przesyłkę lotu pakietu. Aby uzyskać więcej informacji na temat identyfikatora sklepu, zobacz Wyświetlanie szczegółów tożsamości aplikacji.
flightId (identyfikator lotu) sznurek To jest wymagane. Identyfikator pakietu lotu, dla którego chcesz zaktualizować zgłoszenie. Ten identyfikator jest dostępny w danych odpowiedzi dla żądań utworzenia lotu paczki i uzyskania lotów paczek dla aplikacji. W przypadku lotu utworzonego w Centrum partnerskim ten identyfikator jest również dostępny w adresie URL strony lotu w Centrum partnerskim.
ID zgłoszenia sznurek To jest wymagane. Identyfikator zgłoszenia do aktualizacji. Identyfikator ten jest dostępny w danych odpowiedzi dla żądań przesłania zgłoszenia pakietu lotu . W przypadku przesłania utworzonego w Centrum partnerskim ten identyfikator jest również dostępny w adresie URL strony przesyłania w Centrum partnerskim.
packageId (identyfikator pakietu) sznurek To jest wymagane. Identyfikator istniejącego pakietu.

Ciało żądania

Treść żądania ma następujące parametry.

Wartość Typ Opis
pakiety lotnicze układ Zawiera obiekty, które dostarczają szczegółowych informacji o każdym pakiecie w zgłoszeniu. Aby uzyskać więcej informacji na temat wartości w treści odpowiedzi, zobacz Zasób pakietu lotów. Podczas wywoływania tej metody, aby zaktualizować przesłanie aplikacji, wartości fileName, fileStatus, minimumDirectXVersion i minimumSystemRam tych obiektów są wymagane w treści żądania. Pozostałe wartości są wypełniane przez Partner Center.
OpcjeDostawyPakietu przedmiot Zawiera stopniowe wdrażanie pakietu oraz obowiązkowe ustawienia aktualizacji dla zgłoszenia. Aby uzyskać więcej informacji, zobacz Obiekt Opcje dostarczania pakietów.
tryb publikacji docelowej sznurek Tryb publikacji zgłoszenia. Może to być jedna z następujących wartości:
  • Bezpośredni
  • Podręcznik
  • OkreślonaData
planowanaDataPublikacji sznurek Data publikacji przesyłania w formacie ISO 8601, jeśli element targetPublishMode ma ustawioną wartość SpecificDate.
notatkiDoCertyfikacji sznurek Udostępnia dodatkowe informacje dla testerów certyfikacji, takich jak poświadczenia konta testowego i kroki uzyskiwania dostępu do funkcji i ich weryfikowania. Aby uzyskać więcej informacji, zobacz Uwagi dotyczące certyfikacji.

Przykład zapytania

W poniższym przykładzie pokazano, jak zaktualizować przesyłanie pakietu lotu do aplikacji.

PUT https://manage.devcenter.microsoft.com/v1.0/my/applications/9NBLGGH4R315/flights/43e448df-97c9-4a43-a0bc-2a445e736bcd/submissions/1152921504621243649 HTTP/1.1
Authorization: Bearer <your access token>
Content-Type: application/json
{
  "flightPackages": [
    {
      "id": "existingPackage.Id",
      "fileName": "newPackage.appx",
      "fileStatus": "PendingUpload",
      "minimumDirectXVersion": "None",
      "minimumSystemRam": "None"
    }
  ],
  "packageDeliveryOptions": {
    "packageRollout": {
        "isPackageRollout": false,
        "packageRolloutPercentage": 0.0,
        "packageRolloutStatus": "PackageRolloutNotStarted",
        "fallbackSubmissionId": "0"
    },
    "isMandatoryUpdate": false,
    "mandatoryUpdateEffectiveDate": "1601-01-01T00:00:00.0000000Z"
  },
  "targetPublishMode": "Immediate",
  "targetPublishDate": "",
  "notesForCertification": "No special steps are required for certification of this app."
}

Odpowiedź

W poniższym przykładzie pokazano treść odpowiedzi JSON dla pomyślnego wywołania tej metody. Treść odpowiedzi zawiera informacje o zaktualizowanym zgłoszeniu. Aby uzyskać więcej informacji na temat wartości w treści odpowiedzi, zobacz Package flight submission resource (Zasób przesyłania pakietów).

{
  "id": "1152921504621243649",
  "flightId": "cd2e368a-0da5-4026-9f34-0e7934bc6f23",
  "status": "PendingCommit",
  "statusDetails": {
    "errors": [],
    "warnings": [],
    "certificationReports": []
  },
  "flightPackages": [
    {
      "fileName": "newPackage.appx",
      "fileStatus": "PendingUpload",
      "id": "",
      "version": "1.0.0.0",
      "languages": ["en-us"],
      "capabilities": [],
      "minimumDirectXVersion": "None",
      "minimumSystemRam": "None"
    }
  ],
  "packageDeliveryOptions": {
    "packageRollout": {
        "isPackageRollout": false,
        "packageRolloutPercentage": 0.0,
        "packageRolloutStatus": "PackageRolloutNotStarted",
        "fallbackSubmissionId": "0"
    },
    "isMandatoryUpdate": false,
    "mandatoryUpdateEffectiveDate": "1601-01-01T00:00:00.0000000Z"
  },
  "fileUploadUrl": "https://productingestionbin1.blob.core.windows.net/ingestion/8b389577-5d5e-4cbe-a744-1ff2e97a9eb8?sv=2014-02-14&sr=b&sig=wgMCQPjPDkuuxNLkeG35rfHaMToebCxBNMPw7WABdXU%3D&se=2016-06-17T21:29:44Z&sp=rwl",
  "targetPublishMode": "Immediate",
  "targetPublishDate": "",
  "notesForCertification": "No special steps are required for certification of this app."
}

Kody błędów

Jeśli nie można pomyślnie ukończyć żądania, odpowiedź będzie zawierać jeden z następujących kodów błędów HTTP.

Kod błędu Opis
400 Nie można zaktualizować przesłania pakietu, ponieważ żądanie jest nieprawidłowe.
409 Nie można zaktualizować przesłania pakietu z powodu bieżącego stanu aplikacji lub aplikacja korzysta z funkcji Centrum partnerskiego, która nie jest obecnie obsługiwana przez interfejs API przesyłania ze Sklepu Microsoft.
  • Last updated on