Method: edits.images.upload
تنظيم صفحاتك في مجموعات
يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
تحمّل صورة باللغة المحدّدة ونوع الصورة المحدّدَين، وتضيفها إلى التعديل.
طلب HTTP
- تحميل عنوان URI، لطلبات تحميل الوسائط:
POST https://androidpublisher.googleapis.com/upload/androidpublisher/v3/applications/{packageName}/edits/{editId}/listings/{language}/{imageType}
- معرّف الموارد المنتظم (URI) للبيانات الوصفية لطلبات البيانات الوصفية فقط:
POST https://androidpublisher.googleapis.com/androidpublisher/v3/applications/{packageName}/edits/{editId}/listings/{language}/{imageType}
يستخدِم عنوان URL بنية تحويل ترميز gRPC.
مَعلمات المسار
| المعلمات |
packageName |
string
اسم حزمة التطبيق
|
editId |
string
معرّف التعديل.
|
language |
string
رمز أقلمة اللغة (علامة لغة BCP-47، على سبيل المثال، "de-AT" للغة الألمانية النمساوية). لا يمكن تقديم لغة غير متاحة في التطبيق.
|
imageType |
enum (AppImageType)
نوع الصورة.
|
نص الطلب
يحتوي نص الطلب على مثال ImagesUploadRequestBody.
نص الاستجابة
الرد على تحميل صورة
إذا كانت الاستجابة ناجحة، سيحتوي نص الاستجابة على بيانات بالبنية التالية:
| تمثيل JSON |
{
"image": {
object (Image)
}
} |
| الحقول |
image |
object (Image)
الصورة التي تم تحميلها
|
نطاقات الأذونات
يجب توفير نطاق OAuth التالي:
https://www.googleapis.com/auth/androidpublisher
إنّ محتوى هذه الصفحة مرخّص بموجب ترخيص Creative Commons Attribution 4.0 ما لم يُنصّ على خلاف ذلك، ونماذج الرموز مرخّصة بموجب ترخيص Apache 2.0. للاطّلاع على التفاصيل، يُرجى مراجعة سياسات موقع Google Developers. إنّ Java هي علامة تجارية مسجَّلة لشركة Oracle و/أو شركائها التابعين.
تاريخ التعديل الأخير: 2025-07-26 (حسب التوقيت العالمي المتفَّق عليه)
[null,null,["تاريخ التعديل الأخير: 2025-07-26 (حسب التوقيت العالمي المتفَّق عليه)"],[[["\u003cp\u003eUploads an image of the specified language and image type, and adds it to the edit.\u003c/p\u003e\n"],["\u003cp\u003eUtilizes HTTP POST requests to upload media or metadata for app listings.\u003c/p\u003e\n"],["\u003cp\u003eRequires path parameters such as package name, edit ID, language, and image type.\u003c/p\u003e\n"],["\u003cp\u003eThe request body should contain an \u003ccode\u003eImagesUploadRequestBody\u003c/code\u003e instance.\u003c/p\u003e\n"],["\u003cp\u003eSuccessful responses include an \u003ccode\u003eImage\u003c/code\u003e object representing the uploaded image.\u003c/p\u003e\n"]]],["This document details the process for uploading images to an Android app's listing. Key actions involve making a `POST` request to either an upload URI or a metadata URI, specifying parameters like `packageName`, `editId`, `language`, and `imageType`. The request body, which is `ImagesUploadRequestBody`, needs to be provided and a JSON response containing image data is returned. Authorization using `https://www.googleapis.com/auth/androidpublisher` scope is also necessary for the request.\n"],null,["# Method: edits.images.upload\n\n- [HTTP request](#body.HTTP_TEMPLATE)\n- [Path parameters](#body.PATH_PARAMETERS)\n- [Request body](#body.request_body)\n- [Response body](#body.response_body)\n - [JSON representation](#body.ImagesUploadResponse.SCHEMA_REPRESENTATION)\n- [Authorization scopes](#body.aspect)\n- [Try it!](#try-it)\n\nUploads an image of the specified language and image type, and adds to the edit.\n\n### HTTP request\n\n- Upload URI, for media upload requests: \n `POST https://androidpublisher.googleapis.com/upload/androidpublisher/v3/applications/{packageName}/edits/{editId}/listings/{language}/{imageType}`\n- Metadata URI, for metadata-only requests: \n `POST https://androidpublisher.googleapis.com/androidpublisher/v3/applications/{packageName}/edits/{editId}/listings/{language}/{imageType}`\n\nThe URL uses [gRPC Transcoding](https://google.aip.dev/127) syntax.\n\n### Path parameters\n\n| Parameters ||\n|---------------|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `packageName` | `string` Package name of the app. |\n| `editId` | `string` Identifier of the edit. |\n| `language` | `string` Language localization code (a BCP-47 language tag; for example, \"de-AT\" for Austrian German). Providing a language that is not supported by the App is a no-op. |\n| `imageType` | `enum (`[AppImageType](/android-publisher/api-ref/rest/v3/AppImageType)`)` Type of the Image. |\n\n### Request body\n\nThe request body contains an instance of `ImagesUploadRequestBody`.\n\n### Response body\n\nResponse for uploading an image.\n\nIf successful, the response body contains data with the following structure:\n\n| JSON representation |\n|-----------------------------------------------------------------------------------------|\n| ``` { \"image\": { object (/android-publisher/api-ref/rest/v3/edits.images#Image) } } ``` |\n\n| Fields ||\n|---------|-------------------------------------------------------------------------------------------------|\n| `image` | `object (`[Image](/android-publisher/api-ref/rest/v3/edits.images#Image)`)` The uploaded image. |\n\n### Authorization scopes\n\nRequires the following OAuth scope:\n\n- `https://www.googleapis.com/auth/androidpublisher`"]]
