Method: apprecovery.addTargeting
컬렉션을 사용해 정리하기
내 환경설정을 기준으로 콘텐츠를 저장하고 분류하세요.
복구 작업에 대한 타겟팅을 점진적으로 업데이트합니다. 복구 작업을 만드는 동안 선택한 기준만 확장할 수 있습니다.
HTTP 요청
POST https://androidpublisher.googleapis.com/androidpublisher/v3/applications/{packageName}/appRecoveries/{appRecoveryId}:addTargeting
URL은 gRPC 트랜스코딩 문법을 사용합니다.
경로 매개변수
| 매개변수 |
packageName |
string
필수 항목입니다. 복구 작업을 업데이트할 앱의 패키지 이름입니다.
|
appRecoveryId |
string (int64 format)
필수 항목입니다. 앱 복구 작업에 해당하는 ID입니다.
|
요청 본문
요청 본문에는 다음과 같은 구조의 데이터가 포함됩니다.
| 필드 |
targetingUpdate |
object (TargetingUpdate)
지역, Android SDK 버전 등과 같은 타겟팅 업데이트를 지정합니다.
|
응답 본문
성공한 경우 응답 본문은 비어 있습니다.
승인 범위
다음 OAuth 범위가 필요합니다.
https://www.googleapis.com/auth/androidpublisher
TargetingUpdate
타겟팅 유형을 업데이트합니다. 항상 하위 집합 타겟팅입니다.
| JSON 표현 |
{
// Union field criteria can be only one of the following:
"regions": {
object (Regions)
},
"androidSdks": {
object (AndroidSdks)
},
"allUsers": {
object (AllUsers)
}
// End of list of possible types for union field criteria.
} |
| 필드 |
통합 필드 criteria. 복구 작업의 타겟팅 기준입니다. 기준이 all_users가 아닌 경우 기준은 항상 앱 복구 작업 생성 중 사용된 것과 동일해야 합니다. 그렇지 않으면 업데이트가 거부됩니다. 기준이 이전에 all_users를 타겟팅하도록 설정된 경우 타겟팅 업데이트가 불가능합니다. 요청에 따라 타겟 그룹을 확장할 수 없는 경우 오류가 발생합니다. criteria은 다음 중 하나여야 합니다. |
regions |
object (Regions)
복구 작업으로 추가 리전이 타겟팅됩니다.
|
androidSdks |
object (AndroidSdks)
추가 Android SDK 수준은 복구 작업에서 타겟팅됩니다.
|
allUsers |
object (AllUsers)
모든 사용자가 타겟팅됩니다.
|
달리 명시되지 않는 한 이 페이지의 콘텐츠에는 Creative Commons Attribution 4.0 라이선스에 따라 라이선스가 부여되며, 코드 샘플에는 Apache 2.0 라이선스에 따라 라이선스가 부여됩니다. 자세한 내용은 Google Developers 사이트 정책을 참조하세요. 자바는 Oracle 및/또는 Oracle 계열사의 등록 상표입니다.
최종 업데이트: 2025-07-26(UTC)
[null,null,["최종 업데이트: 2025-07-26(UTC)"],[[["\u003cp\u003eIncrementally update targeting for a recovery action, expanding only criteria selected during its creation.\u003c/p\u003e\n"],["\u003cp\u003eUtilize an HTTP POST request to \u003ccode\u003ehttps://androidpublisher.googleapis.com/androidpublisher/v3/applications/{packageName}/appRecoveries/{appRecoveryId}:addTargeting\u003c/code\u003e to initiate the update.\u003c/p\u003e\n"],["\u003cp\u003eThe request body must contain a \u003ccode\u003etargetingUpdate\u003c/code\u003e object specifying updates for regions, Android SDK versions, or user targeting.\u003c/p\u003e\n"],["\u003cp\u003eTargeting updates must align with the criteria initially set for the recovery action; attempting to expand beyond those parameters will result in an error.\u003c/p\u003e\n"],["\u003cp\u003eSuccessful updates result in an empty response body.\u003c/p\u003e\n"]]],["This outlines how to update the targeting of an app recovery action using a `POST` request to a specific URL. The request requires the app's package name and recovery action ID as path parameters. The request body should contain a `targetingUpdate` object, specifying criteria like `regions` or `androidSdks` to expand the targeted group, the criteria used must be the same that was used in creation of the action. If successful, the response is empty; requires an `androidpublisher` authorization scope.\n"],null,["# Method: apprecovery.addTargeting\n\n- [HTTP request](#body.HTTP_TEMPLATE)\n- [Path parameters](#body.PATH_PARAMETERS)\n- [Request body](#body.request_body)\n - [JSON representation](#body.request_body.SCHEMA_REPRESENTATION)\n- [Response body](#body.response_body)\n- [Authorization scopes](#body.aspect)\n- [TargetingUpdate](#TargetingUpdate)\n - [JSON representation](#TargetingUpdate.SCHEMA_REPRESENTATION)\n- [Try it!](#try-it)\n\nIncrementally update targeting for a recovery action. Note that only the criteria selected during the creation of recovery action can be expanded.\n\n### HTTP request\n\n`POST https://androidpublisher.googleapis.com/androidpublisher/v3/applications/{packageName}/appRecoveries/{appRecoveryId}:addTargeting`\n\nThe URL uses [gRPC Transcoding](https://google.aip.dev/127) syntax.\n\n### Path parameters\n\n| Parameters ||\n|-----------------|--------------------------------------------------------------------------------------------------------------------------------------------|\n| `packageName` | `string` Required. Package name of the app for which recovery action is to be updated. |\n| `appRecoveryId` | `string (`[int64](https://developers.google.com/discovery/v1/type-format)` format)` Required. ID corresponding to the app recovery action. |\n\n### Request body\n\nThe request body contains data with the following structure:\n\n| JSON representation |\n|-------------------------------------------------------------------------------------------------------------------------|\n| ``` { \"targetingUpdate\": { object (/android-publisher/api-ref/rest/v3/apprecovery/addTargeting#TargetingUpdate) } } ``` |\n\n| Fields ||\n|-------------------|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `targetingUpdate` | `object (`[TargetingUpdate](/android-publisher/api-ref/rest/v3/apprecovery/addTargeting#TargetingUpdate)`)` Specifies targeting updates such as regions, android sdk versions etc. |\n\n### Response body\n\nIf successful, the response body is empty.\n\n### Authorization scopes\n\nRequires the following OAuth scope:\n\n- `https://www.googleapis.com/auth/androidpublisher`\n\nTargetingUpdate\n---------------\n\nUpdate type for targeting. Note it is always a subset Targeting.\n\n| JSON representation |\n|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| ``` { // Union field `criteria` can be only one of the following: \"regions\": { object (/android-publisher/api-ref/rest/v3/Regions) }, \"androidSdks\": { object (/android-publisher/api-ref/rest/v3/AndroidSdks) }, \"allUsers\": { object (/android-publisher/api-ref/rest/v3/AllUsers) } // End of list of possible types for union field `criteria`. } ``` |\n\n| Fields ||\n|---------------|-----------------------------------------------------------------------------------------------------------------------------------------------|\n| Union field `criteria`. Criteria for targeting in recovery action. Note that unless the criteria is not all_users, the criteria should always be the same as what was used during creation of app recovery action. Otherwise the update is rejected. In case criteria was previously set to target all_users, targeting update is impossible. In case the target group cannot be expanded as per the request, an error is thrown. `criteria` can be only one of the following: ||\n| `regions` | `object (`[Regions](/android-publisher/api-ref/rest/v3/Regions)`)` Additional regions are targeted by the recovery action. |\n| `androidSdks` | `object (`[AndroidSdks](/android-publisher/api-ref/rest/v3/AndroidSdks)`)` Additional android sdk levels are targeted by the recovery action. |\n| `allUsers` | `object (`[AllUsers](/android-publisher/api-ref/rest/v3/AllUsers)`)` All users are targeted. |"]]
