앱 제출 업데이트Update an app submission

Microsoft Store 제출 API에서이 방법을 사용 하 여 기존 앱 제출을 업데이트 합니다.Use this method in the Microsoft Store submission API to update an existing app submission. 이 방법을 사용 하 여 제출을 성공적으로 업데이트 한 후에는 수집 및 게시를 위해 제출을 커밋해야 합니다.After you successfully update a submission by using this method, you must commit the submission for ingestion and publishing.

Microsoft Store 제출 API를 사용 하 여 앱 제출을 만드는 프로세스에이 방법을 사용 하는 방법에 대 한 자세한 내용은 앱 제출 관리를 참조 하세요.For more information about how this method fits into the process of creating an app submission by using the Microsoft Store submission API, see Manage app submissions.

필수 구성 요소Prerequisites

이 방법을 사용 하려면 먼저 다음을 수행 해야 합니다.To use this method, you need to first do the following:

  • 아직 수행 하지 않은 경우 Microsoft Store 제출 API에 대 한 모든 필수 구성 요소 를 완료 합니다.If you have not done so already, complete all the prerequisites for the Microsoft Store submission API.
  • 이 메서드에 대 한 요청 헤더에 사용할 AZURE AD 액세스 토큰을 가져옵니다 .Obtain an Azure AD access token to use in the request header for this method. 액세스 토큰을 얻은 후 만료되기 전에 60분 동안 사용할 수 있습니다.After you obtain an access token, you have 60 minutes to use it before it expires. 토큰이 만료 된 후 새 토큰을 얻을 수 있습니다.After the token expires, you can obtain a new one.
  • 앱 중 하나에 대 한 제출을 만듭니다.Create a submission for one of your apps. 파트너 센터에서이 작업을 수행할 수도 있고, 앱 전송 만들기 방법을 사용 하 여이 작업을 수행할 수도 있습니다.You can do this in Partner Center, or you can do this by using the create an app submission method.

요청Request

이 메서드의 구문은 다음과 같습니다.This method has the following syntax. 헤더 및 요청 본문의 사용 예제와 설명은 다음 섹션을 참조하세요.See the following sections for usage examples and descriptions of the header and request body.

방법Method 요청 URIRequest URI
PUTPUT https://manage.devcenter.microsoft.com/v1.0/my/applications/{applicationId}/submissions/{submissionId}

요청 헤더Request header

headerHeader 유형Type DescriptionDescription
권한 부여Authorization 문자열string 필수 요소.Required. Bearer <token> 형식의 Azure AD 액세스 토큰입니다.The Azure AD access token in the form Bearer <token>.

요청 매개 변수Request parameters

이름Name 유형Type DescriptionDescription
applicationIdapplicationId 문자열string 필수 요소.Required. 제출을 업데이트 하려는 앱의 저장소 ID입니다.The Store ID of the app for which you want to update a submission. 저장소 ID에 대 한 자세한 내용은 앱 id 세부 정보 보기를 참조 하세요.For more information about the Store ID, see View app identity details.
submissionIdsubmissionId 문자열string 필수 요소.Required. 업데이트할 전송의 ID입니다.The ID of the submission to update. 이 ID는 앱 제출을 만들기위한 요청에 대 한 응답 데이터에서 사용할 수 있습니다.This ID is available in the response data for requests to create an app submission. 파트너 센터에서 만든 제출의 경우이 ID는 파트너 센터의 제출 페이지에 대 한 URL 에서도 사용할 수 있습니다.For a submission that was created in Partner Center, this ID is also available in the URL for the submission page in Partner Center.

요청 본문Request body

요청 본문에는 다음 매개 변수가 있습니다.The request body has the following parameters.

Value 형식Type DescriptionDescription
applicationCategoryapplicationCategory 문자열string 앱에 대 한 범주 및/또는 하위 범주를 지정 하는 문자열입니다.A string that specifies the category and/or subcategory for your app. 범주와 하위 범주는 BooksAndReference_EReader와 같이 밑줄 ' _ ' 문자를 사용 하 여 단일 문자열로 결합 됩니다.Categories and subcategories are combined into a single string with the underscore '_' character, such as BooksAndReference_EReader.
가격 책정pricing 개체object 앱에 대 한 가격 정보를 포함 하는 개체입니다.An object that contains pricing info for the app. 자세한 내용은 가격 책정 리소스 섹션을 참조 하세요.For more information, see the Pricing resource section.
표시 여부visibility 문자열string 앱의 표시 여부입니다.The visibility of the app. 다음 값 중 하나일 수 있습니다.This can be one of the following values:
  • 숨김Hidden
  • 공용Public
  • 프라이빗Private
  • NotSetNotSet
targetPublishModetargetPublishMode 문자열string 제출에 대 한 게시 모드입니다.The publish mode for the submission. 다음 값 중 하나일 수 있습니다.This can be one of the following values:
  • 즉시Immediate
  • 설명서Manual
  • SpecificDateSpecificDate
Target버전targetPublishDate 문자열string TargetSpecificDate mode 가로 설정 된 경우 ISO 8601 형식의 제출에 대 한 게시 날짜입니다.The publish date for the submission in ISO 8601 format, if the targetPublishMode is set to SpecificDate.
목록listings 개체object 키/값 쌍의 사전입니다. 여기서 각 키는 국가 코드이 고 각 값은 앱에 대 한 목록 정보를 포함 하는 목록 리소스 개체입니다.A dictionary of key and value pairs, where each key is a country code and each value is a Listing resource object that contains listing info for the app.
hardwarePreferenceshardwarePreferences arrayarray 앱에 대 한 하드웨어 기본 설정을 정의 하는 문자열 배열입니다.An array of strings that define the hardware preferences for your app. 다음 값 중 하나일 수 있습니다.This can be one of the following values:
  • 터치Touch
  • 키보드Keyboard
  • 마우스Mouse
  • 카메라Camera
  • NfcHceNfcHce
  • ReaderNfc
  • BluetoothLEBluetoothLE
  • TelephonyTelephony
자동 Backup사용automaticBackupEnabled booleanboolean Windows에서 OneDrive에 자동 백업에 앱의 데이터를 포함할 수 있는지 여부를 나타냅니다.Indicates whether Windows can include your app's data in automatic backups to OneDrive. 자세한 내용은 앱 선언을 참조 하세요.For more information, see App declarations.
canInstallOnRemovableMediacanInstallOnRemovableMedia booleanboolean 고객이 이동식 저장소에 앱을 설치할 수 있는지 여부를 나타냅니다.Indicates whether customers can install your app to removable storage. 자세한 내용은 앱 선언을 참조 하세요.For more information, see App declarations.
isGameDvrEnabledisGameDvrEnabled booleanboolean 앱에 게임 DVR이 사용 되는지 여부를 나타냅니다.Indicates whether game DVR is enabled for the app.
gamingOptionsgamingOptions 개체object 앱에 대 한 게임 관련 설정을 정의 하는 게임 옵션 리소스 하나를 포함 하는 배열입니다.An array that contains one gaming options resource that defines game-related settings for the app.
hasExternalInAppProductshasExternalInAppProducts booleanboolean 앱을 통해 사용자가 Microsoft Store 상거래 시스템 외부에서 구매할 수 있는지 여부를 나타냅니다.Indicates whether your app allows users to make purchase outside the Microsoft Store commerce system. 자세한 내용은 앱 선언을 참조 하세요.For more information, see App declarations.
meetAccessibilityGuidelinesmeetAccessibilityGuidelines booleanboolean 앱이 내게 필요한 옵션 지침을 충족 하는지 테스트 되었는지 여부를 나타냅니다.Indicates whether your app has been tested to meet accessibility guidelines. 자세한 내용은 앱 선언을 참조 하세요.For more information, see App declarations.
메모 For인증notesForCertification 문자열string 앱에 대 한 인증에 대 한 정보를 포함 합니다.Contains notes for certification for your app.
applicationPackagesapplicationPackages arrayarray 제출의 각 패키지에 대 한 세부 정보를 제공 하는 개체를 포함 합니다.Contains objects that provide details about each package in the submission. 자세한 내용은 응용 프로그램 패키지 섹션을 참조 하세요.For more information, see the Application package section. 응용 프로그램 제출을 업데이트 하기 위해이 메서드를 호출 하는 경우 요청 본문에 이러한 개체의 fileName, fileStatus,,,가 중 및 ram 값만 필요 합니다. minimumDirectXVersionWhen calling this method to update an app submission, only the fileName, fileStatus, minimumDirectXVersion, and minimumSystemRam values of these objects are required in the request body. 다른 값은 파트너 센터에서 채워집니다.The other values are populated by Partner Center.
packageDeliveryOptionspackageDeliveryOptions 개체object 전송에 대 한 점진적 패키지 롤아웃 및 필수 업데이트 설정이 포함 되어 있습니다.Contains gradual package rollout and mandatory update settings for the submission. 자세한 내용은 패키지 배달 옵션 개체를 참조 하세요.For more information, see Package delivery options object.
enterpriseLicensingenterpriseLicensing 문자열string 앱에 대 한 엔터프라이즈 라이선스 동작을 나타내는 엔터프라이즈 라이선스 값 값 중 하나입니다.One of the enterprise licensing values values that indicate the enterprise licensing behavior for the app.
allowMicrosftDecideAppAvailabilityToFutureDeviceFamiliesallowMicrosftDecideAppAvailabilityToFutureDeviceFamilies booleanboolean Microsoft에서 이후 Windows 10 장치 제품군에 앱을 사용할 수 있도록허용할지 여부를 나타냅니다.Indicates whether Microsoft is allowed to make the app available to future Windows 10 device families.
allowTargetFutureDeviceFamiliesallowTargetFutureDeviceFamilies booleanboolean 앱이 이후 Windows 10 장치 패밀리를 대상으로 할 수 있는지 여부를 나타냅니다.Indicates whether your app is allowed to target future Windows 10 device families.
trailers arrayarray 앱 목록에 대 한 비디오 트레일러를 나타내는 최대 트레일러 리소스 를 포함 하는 배열입니다.An array that contains up to trailer resources that represent video trailers for the app listing.

요청 예제Request example

다음 예제에서는 앱 제출을 업데이트 하는 방법을 보여 줍니다.The following example demonstrates how to update an app submission.

PUT https://manage.devcenter.microsoft.com/v1.0/my/applications/9NBLGGH4R315/submissions/1152921504621230023 HTTP/1.1
Authorization: Bearer <your access token>
Content-Type: application/json
{
  "applicationCategory": "BooksAndReference_EReader",
  "pricing": {
    "trialPeriod": "FifteenDays",
    "marketSpecificPricings": {},
    "sales": [],
    "priceId": "Tier2"
  },
  "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": "",
  "applicationPackages": [
    {
      "fileName": "contoso_app.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"
  },
  "enterpriseLicensing": "Online",
  "allowMicrosoftDecideAppAvailabilityToFutureDeviceFamilies": true,
  "allowTargetFutureDeviceFamilies": {
    "Desktop": false,
    "Mobile": true,
    "Holographic": true,
    "Xbox": false,
    "Team": true
  },
  "trailers": []
}

응답Response

다음 예제에서는이 메서드를 성공적으로 호출 하기 위한 JSON 응답 본문을 보여 줍니다.The following example demonstrates the JSON response body for a successful call to this method. 응답 본문에는 업데이트 된 제출에 대 한 정보가 포함 됩니다.The response body contains information about the updated submission. 응답 본문의 값에 대 한 자세한 내용은 앱 제출 리소스를 참조 하세요.For more details about the values in the response body, see App submission resource.

{
  "id": "1152921504621243540",
  "applicationCategory": "BooksAndReference_EReader",
  "pricing": {
    "trialPeriod": "FifteenDays",
    "marketSpecificPricings": {},
    "sales": [],
    "priceId": "Tier2"
  },
  "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": "PendingUpload",
      "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": []
}

오류 코드Error codes

요청이 성공적으로 완료 될 수 없는 경우 응답은 다음 HTTP 오류 코드 중 하나를 포함 합니다.If the request cannot be successfully completed, the response will contain one of the following HTTP error codes.

오류 코드Error code DescriptionDescription
400400 요청이 잘못 되었으므로 제출을 업데이트할 수 없습니다.The submission could not be updated because the request is invalid.
409409 앱의 현재 상태로 인해 제출을 업데이트 하지 못했습니다. 또는 앱이 Microsoft Store 제출 API에서 현재 지원 하지않는 파트너 센터 기능을 사용 합니다.The submission could not be updated because of the current state of the app, or the app uses a Partner Center feature that is currently not supported by the Microsoft Store submission API.