Skapa en appöverföring

Använd den här metoden i Microsoft Store-api:et för överföring för att skapa en ny överföring för en app som är registrerad på ditt Partnercenter-konto. När du har skapat en ny insändning med hjälp av den här metoden uppdaterar du sändningen för att göra nödvändiga ändringar i insändningsdata och genomför sedan insändningen för inmatning och publicering.

Mer information om hur den här metoden passar in i 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:

  • Har du inte redan gjort det, slutför alla förutsättningar för Microsoft Store-API:et för inlämning.
  • 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.
  • Kontrollera att appen redan har minst en sändning med åldersklassificeringsinformationen slutförd.

Begäran

Den här metoden har följande syntax. Se följande avsnitt för användningsexempel och beskrivningar av rubriken och begärandetexten.

Metod Begär URI
Posten https://manage.devcenter.microsoft.com/v1.0/my/applications/{applicationId}/submissions

Begärandehuvud

Rubrik Typ Beskrivning
Tillstånd sträng Krävs. Azure AD-åtkomsttoken i formatet Bearer-token<>.

Parametrar för begäran

Namn Typ Beskrivning
applicationId sträng Krävs. Store-ID:t för appen som du vill skapa en inlämning för. Mer information om Store-ID finns i Visa information om appidentitet.

Begärandetext

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

Exempel på begäran

I följande exempel visas hur du skapar en ny insändning för en app.

POST https://manage.devcenter.microsoft.com/v1.0/my/applications/9NBLGGH4R315/submissions 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. Svarstexten innehåller information om den nya insändningen. För mer information om värdena i svarstexten, se Resurs för appinlämning.

{
  "id": "1152921504621243540",
  "applicationCategory": "BooksAndReference_EReader",
  "pricing": {
    "trialPeriod": "FifteenDays",
    "marketSpecificPricings": {},
    "sales": [],
    "priceId": "Tier2",
    "isAdvancedPricingModel": true
  },
  "visibility": "Public",
  "targetPublishMode": "Manual",
  "targetPublishDate": "1601-01-01T00:00:00Z",
  "listings": {
    "en-us": {
      "baseListing": {
        "copyrightAndTrademarkInfo": "",
        "keywords": [
           "epub"
        ],
        "licenseTerms": "",
        "privacyPolicy": "",
        "supportContact": "",
        "websiteUrl": "",
        "description": "Description",
        "features": [
          "Free ebook reader"
        ],
        "releaseNotes": "",
        "images": [
          {
            "fileName": "contoso.png",
            "fileStatus": "Uploaded",
            "id": "1152921504672272757",
            "imageType": "Screenshot"
          }
        ],
        "recommendedHardware": [],
        "title": "Contoso ebook reader"
      },
      "platformOverrides": {
        "Windows81": {
          "description": "Ebook reader for Windows 8.1"
        }
      }
    }
  },
  "hardwarePreferences": [
    "Touch"
  ],
  "automaticBackupEnabled": false,
  "canInstallOnRemovableMedia": true,
  "isGameDvrEnabled": false,
  "gamingOptions": [],
  "hasExternalInAppProducts": false,
  "meetAccessibilityGuidelines": true,
  "notesForCertification": "",
  "status": "PendingCommit",
  "statusDetails": {
    "errors": [],
    "warnings": [],
    "certificationReports": []
  },
  "fileUploadUrl": "https://productingestionbin1.blob.core.windows.net/ingestion/387a9ea8-a412-43a9-8fb3-a38d03eb483d?sv=2014-02-14&sr=b&sig=sdd12JmoaT6BhvC%2BZUrwRweA%2Fkvj%2BEBCY09C2SZZowg%3D&se=2016-06-17T18:32:26Z&sp=rwl",
  "applicationPackages": [
    {
      "fileName": "contoso_app.appx",
      "fileStatus": "Uploaded",
      "id": "1152921504620138797",
      "version": "1.0.0.0",
      "architecture": "ARM",
      "languages": [
        "en-US"
      ],
      "capabilities": [
        "ID_RESOLUTION_HD720P",
        "ID_RESOLUTION_WVGA",
        "ID_RESOLUTION_WXGA"
      ],
      "minimumDirectXVersion": "None",
      "minimumSystemRam": "None",
      "targetDeviceFamilies": [
        "Windows.Mobile min version 10.0.10240.0"
      ]
    }
  ],
  "packageDeliveryOptions": {
    "packageRollout": {
        "isPackageRollout": false,
        "packageRolloutPercentage": 0.0,
        "packageRolloutStatus": "PackageRolloutNotStarted",
        "fallbackSubmissionId": "0"
    },
    "isMandatoryUpdate": false,
    "mandatoryUpdateEffectiveDate": "1601-01-01T00:00:00.0000000Z"
  },
  "enterpriseLicensing": "Online",
  "allowMicrosoftDecideAppAvailabilityToFutureDeviceFamilies": true,
  "allowTargetFutureDeviceFamilies": {
    "Desktop": false,
    "Mobile": true,
    "Holographic": true,
    "Xbox": false,
    "Team": true
  },
  "friendlyName": "Submission 2",
  "trailers": []
}

Felkoder

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

Felkod Beskrivning
400 Det gick inte att skapa sändningen eftersom begäran är ogiltig.
409 Det gick inte att skapa insändningen på grund av appens aktuella tillstånd, 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