Method: apprecovery.addTargeting
透過集合功能整理內容
你可以依據偏好儲存及分類內容。
逐步更新復原動作的指定目標。請注意,您只能展開建立復原動作時選取的條件。
HTTP 要求
POST https://androidpublisher.googleapis.com/androidpublisher/v3/applications/{packageName}/appRecoveries/{appRecoveryId}:addTargeting
這個網址使用 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 )
已指定所有使用者。
|
除非另有註明,否則本頁面中的內容是採用創用 CC 姓名標示 4.0 授權,程式碼範例則為阿帕契 2.0 授權。詳情請參閱《Google Developers 網站政策》。Java 是 Oracle 和/或其關聯企業的註冊商標。
上次更新時間:2025-07-26 (世界標準時間)。
[null,null,["上次更新時間:2025-07-26 (世界標準時間)。"],[[["\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. |"]]