- طلب HTTP
- مَعلمات المسار
- نص الطلب
- نص الاستجابة
- نطاقات الأذونات
- GeneratedApksPerSigningKey
- GeneratedSplitApk
- GeneratedAssetPackSlice
- GeneratedStandaloneApk
- GeneratedUniversalApk
- GeneratedRecoveryApk
- TargetingInfo
- SplitApkVariant
- VariantTargeting
- SdkVersionTargeting
- SdkVersion
- AbiTargeting
- آبي
- AbiAlias
- ScreenDensityTargeting
- ScreenDensity
- DensityAlias
- MultiAbiTargeting
- MultiAbi
- TextureCompressionFormatTargeting
- TextureCompressionFormat
- TextureCompressionFormatAlias
- ApkSet
- ModuleMetadata
- FeatureModuleType
- DeliveryType
- ModuleTargeting
- DeviceFeatureTargeting
- DeviceFeature
- UserCountriesTargeting
- ApkDescription
- ApkTargeting
- LanguageTargeting
- SplitApkMetadata
- StandaloneApkMetadata
- AssetSliceSet
- AssetModuleMetadata
- جرِّبه الآن
تعرض هذه الطريقة البيانات الوصفية للتنزيل لجميع حِزم APK التي تم إنشاؤها من حِزمة تطبيق معيّنة.
طلب HTTP
GET https://androidpublisher.googleapis.com/androidpublisher/v3/applications/{packageName}/generatedApks/{versionCode}
يستخدم عنوان URL بنية تحويل الترميز إلى gRPC.
مَعلمات المسار
| المعلمات | |
|---|---|
packageName |
اسم حزمة التطبيق |
versionCode |
رمز إصدار حزمة التطبيق |
نص الطلب
يجب أن يكون نص الطلب فارغًا.
نص الاستجابة
ردّ لعرض حِزم APK التي تم إنشاؤها
إذا كانت الاستجابة ناجحة، سيحتوي نص الاستجابة على بيانات بالبنية التالية:
| تمثيل JSON |
|---|
{
"generatedApks": [
{
object ( |
| الحقل | |
|---|---|
generatedApks[] |
جميع حِزم APK التي تم إنشاؤها، ويتم تجميعها حسب مفتاح توقيع حِزمة APK. |
نطاقات الأذونات
يجب توفير نطاق OAuth التالي:
https://www.googleapis.com/auth/androidpublisher
GeneratedApksPerSigningKey
generatedapks.download بيانات وصفية لحِزم APK المقسّمة والمستقلة والعامة، بالإضافة إلى شرائح حِزم مواد العرض، والموقَّعة بمفتاح معيّن
| تمثيل JSON |
|---|
{ "certificateSha256Hash": string, "generatedSplitApks": [ { object ( |
| الحقل | |
|---|---|
certificateSha256Hash |
تجزئة SHA256 لشهادة المفتاح العام لتوقيع حِزم APK |
generatedSplitApks[] |
generatedapks.list of generated split APKs, signed with a key corresponding to certificateSha256Hash. |
generatedAssetPackSlices[] |
generatedapks.list of asset pack slices which will be served for this app bundle, signed with a key corresponding to certificateSha256Hash. |
generatedStandaloneApks[] |
generatedapks.list: قائمة بحِزم APK المستقلة التي تم إنشاؤها، والتي تم توقيعها باستخدام مفتاح مطابق لـ certificateSha256Hash. |
generatedUniversalApk |
حزمة APK عامة تم إنشاؤها وتوقيعها باستخدام مفتاح مطابق لـ certificateSha256Hash لا يتم ضبط هذا الحقل في حال عدم إنشاء حِزمة APK عامة لمفتاح التوقيع هذا. |
generatedRecoveryModules[] |
تم إنشاء حِزم APK للاسترداد من أجل إجراءات الاسترداد التي تم توقيعها باستخدام مفتاح يتوافق مع certificateSha256Hash. ويشمل ذلك جميع حِزم APK المخصّصة للاسترداد التي تم إنشاؤها، بما في ذلك تلك التي في حالة مسودّة أو تم إلغاؤها. لا يتم ضبط هذا الحقل في حال عدم إنشاء أي إجراءات استرداد لمفتاح التوقيع هذا. |
unprotectedGeneratedSplitApks[] |
generatedapks.list of generated split APKs without automatic protection, signed with a key corresponding to certificateSha256Hash. لا يظهر هذا الحقل إلا إذا كان التطبيق يستخدم ميزة "الحماية التلقائية". في هذه الحالة، يحتوي |
unprotectedGeneratedStandaloneApks[] |
generatedapks.list of generated standalone APKs without automatic protection, signed with a key corresponding to certificateSha256Hash. لا يظهر هذا الحقل إلا إذا كان التطبيق يستخدم ميزة "الحماية التلقائية". في هذه الحالة، يحتوي |
targetingInfo |
يحتوي على معلومات الاستهداف حول حِزم APK التي تم إنشاؤها. |
GeneratedSplitApk
generatedapks.download البيانات الوصفية لحِزمة APK مجزّأة
| تمثيل JSON |
|---|
{ "downloadId": string, "variantId": integer, "moduleName": string, "splitId": string } |
| الحقل | |
|---|---|
downloadId |
المعرّف generatedapks.download، الذي يحدّد حزمة APK المطلوب تنزيلها بشكلٍ فريد يجب توفيرها لطريقة |
variantId |
معرّف خيار المنتج الذي تم إنشاؤه. |
moduleName |
اسم الوحدة التي ينتمي إليها حِزمة APK هذه |
splitId |
معرّف التقسيم يجب أن يكون فارغًا للتقسيم الرئيسي للوحدة الأساسية. |
GeneratedAssetPackSlice
generatedapks.download البيانات الوصفية لشريحة حِزمة مواد العرض.
| تمثيل JSON |
|---|
{ "downloadId": string, "moduleName": string, "sliceId": string, "version": string } |
| الحقل | |
|---|---|
downloadId |
المعرّف generatedapks.download، الذي يحدّد حزمة APK المطلوب تنزيلها بشكلٍ فريد يجب توفيرها لطريقة |
moduleName |
اسم الوحدة التي ينتمي إليها جزء مادة العرض هذا. |
sliceId |
رقم تعريف شريحة مادة العرض |
version |
إصدار وحدة مواد العرض |
GeneratedStandaloneApk
generatedapks.download البيانات الوصفية لحِزمة APK مستقلة
| تمثيل JSON |
|---|
{ "downloadId": string, "variantId": integer } |
| الحقل | |
|---|---|
downloadId |
المعرّف generatedapks.download، الذي يحدّد حزمة APK المطلوب تنزيلها بشكلٍ فريد يجب توفيرها لطريقة |
variantId |
معرّف خيار المنتج الذي تم إنشاؤه. |
GeneratedUniversalApk
generatedapks.download البيانات الوصفية لحزمة APK عامة
| تمثيل JSON |
|---|
{ "downloadId": string } |
| الحقل | |
|---|---|
downloadId |
المعرّف generatedapks.download، الذي يحدّد حزمة APK المطلوب تنزيلها بشكلٍ فريد يجب توفيرها لطريقة |
GeneratedRecoveryApk
generatedapks.download البيانات الوصفية لوحدة استرداد تطبيق
| تمثيل JSON |
|---|
{
"downloadId": string,
"recoveryId": string,
"recoveryStatus": enum ( |
| الحقل | |
|---|---|
downloadId |
المعرّف generatedapks.download، الذي يحدّد حزمة APK المطلوب تنزيلها بشكلٍ فريد يجب توفيرها لطريقة |
recoveryId |
معرّف إجراء الاسترداد |
recoveryStatus |
حالة إجراء الاسترداد المرتبط بحزمة APK الخاصة بالاسترداد |
moduleName |
اسم الوحدة التي ينتمي إليها حِزمة APK الخاصة بالاسترداد. |
TargetingInfo
معلومات الاستهداف حول حِزم APK التي تم إنشاؤها
| تمثيل JSON |
|---|
{ "packageName": string, "variant": [ { object ( |
| الحقل | |
|---|---|
packageName |
اسم حزمة هذا التطبيق. |
variant[] |
generatedapks.list of the created variants. |
assetSliceSet[] |
generatedapks.list of created asset slices. |
SplitApkVariant
الصيغة هي مجموعة من حِزم APK التي تغطي جزءًا من مساحة إعدادات الجهاز. لا يتم مطلقًا الجمع بين حِزم APK من صيغ مختلفة على جهاز واحد.
| تمثيل JSON |
|---|
{ "targeting": { object ( |
| الحقل | |
|---|---|
targeting |
الاستهداف على مستوى خيار المنتج |
apkSet[] |
مجموعة من حِزم APK، مجموعة واحدة لكل وحدة |
variantNumber |
رقم خيار المنتج، بدءًا من 0 (ما لم يتم إلغاء ذلك). سيتلقّى الجهاز حِزم APK من أول صيغة تطابق إعدادات الجهاز، مع منح الأولوية لأرقام الصيغ الأعلى على أرقام الصيغ الأقل. |
VariantTargeting
الاستهداف على مستوى خيارات المنتج
| تمثيل JSON |
|---|
{ "sdkVersionTargeting": { object ( |
| الحقل | |
|---|---|
sdkVersionTargeting |
إصدار حزمة تطوير البرامج (SDK) الذي يستهدفه البديل |
abiTargeting |
واجهة التطبيق الثنائية (ABI) التي تستهدفها الصيغة |
screenDensityTargeting |
كثافات الشاشة التي يتوافق معها هذا النوع |
multiAbiTargeting |
الاستهداف على مستويات متعددة من واجهة برمجة التطبيقات |
textureCompressionFormatTargeting |
الاستهداف على مستوى صيغة ضغط البنية |
SdkVersionTargeting
الاستهداف استنادًا إلى إصدار حزمة تطوير البرامج (SDK)
| تمثيل JSON |
|---|
{ "value": [ { object ( |
| الحقل | |
|---|---|
value[] |
قيمة إصدار حزمة تطوير البرامج (SDK). |
alternatives[] |
استهداف أدلة فرعية أخرى كانت مضمّنة في الحزمة بالنسبة إلى الانقسامات الرئيسية، يكون هذا الاستهداف للانقسامات الرئيسية الأخرى. |
SdkVersion
تمثّل هذه السمة إصدار حزمة تطوير البرامج (SDK).
| تمثيل JSON |
|---|
{ "min": integer } |
| الحقل | |
|---|---|
min |
الحد الأدنى الشامل لإصدار حزمة تطوير البرامج (SDK). |
AbiTargeting
الاستهداف استنادًا إلى Abi
| تمثيل JSON |
|---|
{ "value": [ { object ( |
| الحقل | |
|---|---|
value[] |
قيمة abi |
alternatives[] |
استهداف أدلة فرعية أخرى كانت مضمّنة في الحزمة بالنسبة إلى الانقسامات الرئيسية، يكون هذا الاستهداف للانقسامات الرئيسية الأخرى. |
Abi
تمثّل هذه السمة واجهة برمجة تطبيقات ثنائية (ABI).
| تمثيل JSON |
|---|
{
"alias": enum ( |
| الحقل | |
|---|---|
alias |
اسم مستعار لـ abi |
AbiAlias
تعريف الاسم المستعار لواجهات التطبيقات الثنائية
| عمليات التعداد | |
|---|---|
UNSPECIFIED_CPU_ARCHITECTURE |
Unspecified abi. |
ARMEABI |
ARMEABI abi. |
ARMEABI_V7A |
ARMEABI_V7A abi. |
ARM64_V8A |
ARM64_V8A abi. |
X86 |
واجهة التطبيق الثنائية (ABI) لنظام التشغيل X86 |
X86_64 |
واجهة التطبيق الثنائية X86_64 |
RISCV64 |
RISCV64 abi. |
ScreenDensityTargeting
الاستهداف استنادًا إلى كثافة الشاشة
| تمثيل JSON |
|---|
{ "value": [ { object ( |
| الحقل | |
|---|---|
value[] |
قيمة كثافة الشاشة |
alternatives[] |
استهداف أدلة فرعية أخرى كانت مضمّنة في الحزمة بالنسبة إلى الانقسامات الرئيسية، يكون هذا الاستهداف للانقسامات الرئيسية الأخرى. |
ScreenDensity
تمثّل هذه السمة كثافة الشاشة.
| تمثيل JSON |
|---|
{ // Union field |
| الحقل | |
|---|---|
حقل الربط يمكن أن يكون التعليق |
|
densityAlias |
اسم مستعار لكثافة الشاشة |
densityDpi |
قيمة الكثافة لكل بوصة. |
DensityAlias
تعريف الاسم المستعار لقيم كثافة الشاشة
| عمليات التعداد | |
|---|---|
DENSITY_UNSPECIFIED |
كثافة شاشة غير محدّدة |
NODPI |
كثافة الشاشة NODPI |
LDPI |
كثافة الشاشة LDPI |
MDPI |
كثافة شاشة MDPI |
TVDPI |
كثافة الشاشة TVDPI |
HDPI |
كثافة الشاشة العالية الدقة |
XHDPI |
كثافة الشاشة XHDPI |
XXHDPI |
كثافة الشاشة XXHDPI |
XXXHDPI |
كثافة شاشة XXXHDPI |
MultiAbiTargeting
الاستهداف استنادًا إلى أرقام تعريف متعددة لمقدمي خدمات البث
| تمثيل JSON |
|---|
{ "value": [ { object ( |
| الحقل | |
|---|---|
value[] |
قيمة واجهة التطبيق الثنائية المتعددة |
alternatives[] |
استهداف أدلة فرعية أخرى كانت مضمّنة في الحزمة بالنسبة إلى عمليات التقسيم الرئيسية، يكون ذلك استهدافًا لعمليات التقسيم الرئيسية الأخرى. |
MultiAbi
تمثّل هذه السمة قائمة بواجهات التطبيق الثنائية (ABI).
| تمثيل JSON |
|---|
{
"abi": [
{
object ( |
| الحقل | |
|---|---|
abi[] |
قائمة بواجهات التطبيق الثنائية المستهدَفة، كما هو موضّح في "نظام Android الأساسي" |
TextureCompressionFormatTargeting
الاستهداف حسب تنسيق ضغط بنية.
| تمثيل JSON |
|---|
{ "value": [ { object ( |
| الحقل | |
|---|---|
value[] |
قائمة إطارات عمل الشفافية والموافقة المستهدَفة يجب ألا يكون فارغًا. |
alternatives[] |
generatedapks.list of alternative TCFs (TCFs targeted by the sibling splits). |
TextureCompressionFormat
تمثّل هذه السمة تنسيق ضغط البنية.
| تمثيل JSON |
|---|
{
"alias": enum ( |
| الحقل | |
|---|---|
alias |
اسم مستعار لتنسيق ضغط البنية |
TextureCompressionFormatAlias
تعريف الاسم المستعار لتنسيقات ضغط البنية
| عمليات التعداد | |
|---|---|
UNSPECIFIED_TEXTURE_COMPRESSION_FORMAT |
تنسيق غير محدّد |
ETC1_RGB8 |
تنسيق ETC1_RGB8 |
PALETTED |
تنسيق PALETTED |
THREE_DC |
تنسيق THREE_DC |
ATC |
تنسيق ATC |
LATC |
تنسيق LATC |
DXT1 |
تنسيق DXT1 |
S3TC |
تنسيق S3TC |
PVRTC |
تنسيق PVRTC |
ASTC |
تنسيق ASTC |
ETC2 |
تنسيق ETC2 |
ApkSet
مجموعة من حِزم APK تمثّل وحدة.
| تمثيل JSON |
|---|
{ "moduleMetadata": { object ( |
| الحقل | |
|---|---|
moduleMetadata |
بيانات وصفية حول الوحدة التي يمثّلها ApkSet |
apkDescription[] |
وصف حِزم APK التي تم إنشاؤها |
ModuleMetadata
البيانات الوصفية لوحدة
| تمثيل JSON |
|---|
{ "name": string, "moduleType": enum ( |
| الحقل | |
|---|---|
name |
اسم الوحدة |
moduleType |
تشير هذه السمة إلى نوع وحدة الميزات هذه. |
deliveryType |
تشير هذه السمة إلى نوع التسليم (مثل عند الطلب) للوحدة. |
dependencies[] |
أسماء الوحدات التي تعتمد عليها هذه الوحدة مباشرةً. تعتمد كل وحدة ضمنيًا على الوحدة الأساسية. |
targeting |
الاستهداف الذي يؤدي إلى تثبيت وحدة مشروطة ينطبق ذلك على حِزم APK المجزّأة فقط. |
FeatureModuleType
نوع وحدة الميزات.
| عمليات التعداد | |
|---|---|
UNKNOWN_MODULE_TYPE |
وحدة ميزات غير معروفة |
FEATURE_MODULE |
وحدة ميزات عادية |
DeliveryType
تشير إلى نوع تسليم الوحدة.
| عمليات التعداد | |
|---|---|
UNKNOWN_DELIVERY_TYPE |
نوع التسليم غير محدَّد. |
INSTALL_TIME |
سيتم دائمًا تنزيل هذه الوحدة كجزء من عملية التثبيت الأوّلي للتطبيق. |
ON_DEMAND |
يتم طلب هذه الوحدة عند الحاجة إليها، ما يعني أنّها لن تكون جزءًا من عملية التثبيت الأولية، ولن يتم إرسالها إلا عندما يطلبها العميل. |
FAST_FOLLOW |
سيتم تنزيل هذه الوحدة مباشرةً بعد انتهاء عملية التثبيت الأولية. ويمكن فتح التطبيق قبل تنزيل هذه الوحدات. |
ModuleTargeting
الاستهداف على مستوى الوحدة
| تمثيل JSON |
|---|
{ "sdkVersionTargeting": { object ( |
| الحقل | |
|---|---|
sdkVersionTargeting |
إصدار حزمة تطوير البرامج (SDK) الذي يستهدفه البديل |
deviceFeatureTargeting[] |
استهداف ميزات الأجهزة |
userCountriesTargeting |
الاستهداف على مستوى البلدان |
DeviceFeatureTargeting
استهداف ميزة في الجهاز
| تمثيل JSON |
|---|
{
"requiredFeature": {
object ( |
| الحقل | |
|---|---|
requiredFeature |
تمثّل هذه السمة ميزة الجهاز. |
DeviceFeature
تمثّل هذه السمة إحدى ميزات الجهاز.
| تمثيل JSON |
|---|
{ "featureName": string, "featureVersion": integer } |
| الحقل | |
|---|---|
featureName |
اسم الميزة |
featureVersion |
إصدار الميزة المحدّد بواسطة android:glEsVersion أو android:version في |
UserCountriesTargeting
تصف هذه السمة قائمة شاملة/مستثناة من رموز البلدان التي يستهدفها الوحدة.
| تمثيل JSON |
|---|
{ "countryCodes": [ string ], "exclude": boolean } |
| الحقل | |
|---|---|
countryCodes[] |
generatedapks.list of country codes in the two-letter CLDR territory format. |
exclude |
يشير إلى ما إذا كانت القائمة أعلاه حصرية. |
ApkDescription
وصف حِزم APK التي تم إنشاؤها
| تمثيل JSON |
|---|
{ "targeting": { object ( |
| الحقل | |
|---|---|
targeting |
الاستهداف على مستوى حِزم APK |
path |
مسار حزمة APK، سيكون بالتنسيق التالي: |
حقل الربط يمكن أن يكون التعليق |
|
splitApkMetadata |
يتم ضبط هذا الخيار لحِزم APK المجزّأة فقط. |
standaloneApkMetadata |
يتم ضبط هذا الخيار لحِزم APK المستقلة فقط. |
instantApkMetadata |
يتم ضبط هذا الخيار لحِزم APK المجزّأة للتطبيقات الفورية فقط. |
assetSliceMetadata |
يتم ضبطها لشرائح مواد العرض فقط. |
ApkTargeting
تمثّل هذه السمة مجموعة من الاستهدافات على مستوى حِزم APK.
| تمثيل JSON |
|---|
{ "abiTargeting": { object ( |
| الحقل | |
|---|---|
abiTargeting |
واجهة التطبيق الثنائية (ABI) التي تستهدفها حزمة APK |
languageTargeting |
اللغة التي تستهدفها حزمة APK |
screenDensityTargeting |
كثافة الشاشة التي تتوافق معها حزمة APK هذه |
sdkVersionTargeting |
إصدار حزمة تطوير البرامج (SDK) الذي تستهدفه حزمة APK |
textureCompressionFormatTargeting |
الاستهداف على مستوى صيغة ضغط البنية |
multiAbiTargeting |
استهداف مستويات متعدّدة لواجهة برمجة التطبيقات |
LanguageTargeting
الاستهداف استنادًا إلى اللغة
| تمثيل JSON |
|---|
{ "value": [ string ], "alternatives": [ string ] } |
| الحقل | |
|---|---|
value[] |
ISO-639: رمز اللغة المكوّن من حرفَين أو ثلاثة أحرف |
alternatives[] |
اللغات البديلة |
SplitApkMetadata
تحتوي على بيانات خاصة بحِزم APK المجزّأة.
| تمثيل JSON |
|---|
{ "splitId": string, "isMasterSplit": boolean } |
| الحقل | |
|---|---|
splitId |
معرّف عملية التقسيم. |
isMasterSplit |
تشير إلى ما إذا كان حِزمة APK هذه هي الحزمة الرئيسية للوحدة. |
StandaloneApkMetadata
تحتوي على بيانات خاصة بحِزم APK المستقلة.
| تمثيل JSON |
|---|
{ "fusedModuleName": [ string ] } |
| الحقل | |
|---|---|
fusedModuleName[] |
أسماء الوحدات المدمجة في حزمة APK المستقلة هذه |
AssetSliceSet
مجموعة من شرائح مواد العرض التي تنتمي إلى وحدة مادة عرض واحدة
| تمثيل JSON |
|---|
{ "assetModuleMetadata": { object ( |
| الحقل | |
|---|---|
assetModuleMetadata |
البيانات الوصفية على مستوى الوحدة |
apkDescription[] |
شرائح مواد العرض |
AssetModuleMetadata
البيانات الوصفية لوحدة مواد عرض
| تمثيل JSON |
|---|
{
"name": string,
"deliveryType": enum ( |
| الحقل | |
|---|---|
name |
اسم الوحدة |
deliveryType |
تشير هذه السمة إلى نوع التسليم للتثبيت الدائم. |