Method: edits.expansionfiles.upload
تنظيم صفحاتك في مجموعات
يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
يتم تحميل ملف بيانات موسّعة جديد ويتم إرفاقه بحزمة APK المحدّدة.
طلب HTTP
- تحميل عنوان URI، لطلبات تحميل الوسائط:
POST https://androidpublisher.googleapis.com/upload/androidpublisher/v3/applications/{packageName}/edits/{editId}/apks/{apkVersionCode}/expansionFiles/{expansionFileType}
- معرّف الموارد المنتظم (URI) للبيانات الوصفية لطلبات البيانات الوصفية فقط:
POST https://androidpublisher.googleapis.com/androidpublisher/v3/applications/{packageName}/edits/{editId}/apks/{apkVersionCode}/expansionFiles/{expansionFileType}
يستخدِم عنوان URL بنية تحويل ترميز gRPC.
مَعلمات المسار
| المعلمات |
packageName |
string
اسم حزمة التطبيق
|
editId |
string
معرّف التعديل.
|
apkVersionCode |
integer
رمز إصدار حزمة APK التي تتم قراءة إعدادات ملف البيانات الموسّعة فيها أو تعديلها.
|
expansionFileType |
enum (ExpansionFileType)
نوع ملف إعدادات ملف البيانات الموسّعة الذي يتم تعديله
|
نص الطلب
يحتوي نص الطلب على مثال ExpansionFilesUploadRequestBody.
نص الاستجابة
رد لتحميل ملف بيانات موسّعة.
إذا كانت الاستجابة ناجحة، سيحتوي نص الاستجابة على بيانات بالبنية التالية:
| الحقول |
expansionFile |
object (ExpansionFile)
إعدادات ملف البيانات الموسّعة الذي تم تحميله
|
نطاقات الأذونات
يجب توفير نطاق 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 a new expansion file and attaches it to a specified Android application package (APK).\u003c/p\u003e\n"],["\u003cp\u003eRequires providing package name, edit ID, APK version code, and expansion file type.\u003c/p\u003e\n"],["\u003cp\u003eSupports two request types: one for uploading media and another for metadata.\u003c/p\u003e\n"],["\u003cp\u003eUpon successful upload, the API returns the uploaded expansion file configuration details.\u003c/p\u003e\n"],["\u003cp\u003eNeeds authorization with the \u003ccode\u003ehttps://www.googleapis.com/auth/androidpublisher\u003c/code\u003e scope.\u003c/p\u003e\n"]]],["This document details how to upload an expansion file to an Android app. Key actions include sending a `POST` HTTP request to either a media or metadata URI, specifying `packageName`, `editId`, `apkVersionCode`, and `expansionFileType` as path parameters. The request body, an `ExpansionFilesUploadRequestBody` instance, is used for uploading. A successful response includes an `ExpansionFile` object within a JSON structure. The process requires the `androidpublisher` authorization scope.\n"],null,["# Method: edits.expansionfiles.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.ExpansionFilesUploadResponse.SCHEMA_REPRESENTATION)\n- [Authorization scopes](#body.aspect)\n- [Try it!](#try-it)\n\nUploads a new expansion file and attaches to the specified APK.\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}/apks/{apkVersionCode}/expansionFiles/{expansionFileType}`\n- Metadata URI, for metadata-only requests: \n `POST https://androidpublisher.googleapis.com/androidpublisher/v3/applications/{packageName}/edits/{editId}/apks/{apkVersionCode}/expansionFiles/{expansionFileType}`\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| `apkVersionCode` | `integer` The version code of the APK whose expansion file configuration is being read or modified. |\n| `expansionFileType` | `enum (`[ExpansionFileType](/android-publisher/api-ref/rest/v3/ExpansionFileType)`)` The file type of the expansion file configuration which is being updated. |\n\n### Request body\n\nThe request body contains an instance of `ExpansionFilesUploadRequestBody`.\n\n### Response body\n\nResponse for uploading an expansion file.\n\nIf successful, the response body contains data with the following structure:\n\n| JSON representation |\n|-----------------------------------------------------------------------------------------------------------------|\n| ``` { \"expansionFile\": { object (/android-publisher/api-ref/rest/v3/edits.expansionfiles#ExpansionFile) } } ``` |\n\n| Fields ||\n|-----------------|------------------------------------------------------------------------------------------------------------------------------------------------|\n| `expansionFile` | `object (`[ExpansionFile](/android-publisher/api-ref/rest/v3/edits.expansionfiles#ExpansionFile)`)` The uploaded expansion file configuration. |\n\n### Authorization scopes\n\nRequires the following OAuth scope:\n\n- `https://www.googleapis.com/auth/androidpublisher`"]]
