Method: apprecovery.addTargeting
تنظيم صفحاتك في مجموعات
يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
عدِّل الاستهداف بشكل تدريجي لتنفيذ إجراء الاسترداد. يُرجى ملاحظة أنّه لا يمكن توسيع سوى المعايير التي تم اختيارها أثناء إنشاء إجراء الاسترداد.
طلب HTTP
POST https://androidpublisher.googleapis.com/androidpublisher/v3/applications/{packageName}/appRecoveries/{appRecoveryId}:addTargeting
يستخدِم عنوان URL بنية تحويل ترميز gRPC.
مَعلمات المسار
| المعلمات |
packageName |
string
مطلوب. اسم حزمة التطبيق الذي سيتم تحديث إجراء الاسترداد له.
|
appRecoveryId |
string (int64 format)
مطلوب. رقم التعريف المقابل لإجراء استرداد التطبيق.
|
نص الطلب
يحتوي نص الطلب على بيانات بالبنية التالية:
| الحقول |
targetingUpdate |
object (TargetingUpdate)
لتحديد التحديثات المستهدفة مثل المناطق وإصدارات حزمة تطوير البرامج (SDK) لنظام التشغيل Android وما إلى ذلك.
|
نص الاستجابة
إذا كانت الاستجابة ناجحة، يكون نص الاستجابة فارغًا.
نطاقات الأذونات
يجب توفير نطاق 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. معايير الاستهداف أثناء إجراء الاسترداد يُرجى ملاحظة أنّه ما لم تكن المعايير is all_users، يجب أن تكون المعايير دائمًا هي نفسها المعايير التي تم استخدامها أثناء إنشاء إجراء استرداد التطبيق. وبخلاف ذلك، يتم رفض التحديث. وفي حال ضبط المعايير سابقًا على استهداف all_users، سيتعذّر تعديل الاستهداف. وفي حال تعذّر توسيع المجموعة المستهدفة وفقًا للطلب، يحدث خطأ. يمكن أن يكون criteria واحدًا فقط مما يلي: |
regions |
object (Regions)
يتم استهداف مناطق إضافية من خلال إجراء الاسترداد.
|
androidSdks |
object (AndroidSdks)
يستهدف إجراء الاسترداد مستويات حزمة تطوير البرامج (SDK) الإضافية لنظام التشغيل Android.
|
allUsers |
object (AllUsers)
يتم استهداف جميع المستخدمين.
|
إنّ محتوى هذه الصفحة مرخّص بموجب ترخيص Creative Commons Attribution 4.0 ما لم يُنصّ على خلاف ذلك، ونماذج الرموز مرخّصة بموجب ترخيص Apache 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. |"]]
