- طلب 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: قائمة بحِزم APK المجزّأة التي تم إنشاؤها، وموقّعة باستخدام مفتاح مطابق لشهادةSha256Hash |
generatedAssetPackSlices[] |
segmentation createapks.list |
generatedStandaloneApks[] |
createapks.list لحِزم APK المستقلة التي تم إنشاؤها، والتي تم توقيعها باستخدام مفتاح يتوافق مع CertificateSha256Hash. |
generatedUniversalApk |
حزمة APK عامة تم إنشاؤها وموقَّعة باستخدام مفتاح مطابق لشهادةSha256Hash لا يتم ضبط هذا الحقل إذا لم يتم إنشاء حزمة APK عامة لمفتاح التوقيع هذا. |
generatedRecoveryModules[] |
تم إنشاء ملفات APK خاصة باسترداد إجراءات الاسترداد وتم توقيعها باستخدام مفتاح يتوافق مع CertificateSha256Hash. يشمل ذلك جميع حِزم APK المخصّصة لاسترداد الحساب التي تم إنشاؤها، وأيضًا تلك التي في حالة مسودّة أو ملغاة. لا يتم ضبط هذا الحقل في حال عدم إنشاء أي إجراءات لاسترداد مفتاح التوقيع هذا. |
targetingInfo |
يحتوي على معلومات الاستهداف حول حِزم apk التي تم إنشاؤها. |
GeneratedSplitApk
generateapks.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 |
generateapks.download ID، والذي يعرّف بشكل فريد حزمة 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 من الصيغ التي تم إنشاؤها |
assetSliceSet[] |
createapks.list لشرائح مواد العرض المنشأة. |
SplitApkVariant
الصيغة هي مجموعة من ملفات APK التي تغطي جزءًا من مساحة إعداد الجهاز. ولا يتم مطلقًا دمج حِزم APK من نُسخ متعددة على جهاز واحد.
تمثيل JSON |
---|
{ "targeting": { object ( |
الحقول | |
---|---|
targeting |
الاستهداف على مستوى الصيغة |
apkSet[] |
مجموعة من حِزم APK، مجموعة واحدة لكل وحدة |
variantNumber |
رقم الصنف، بدءًا من 0 (ما لم يتم إلغاؤه) سيتلقّى الجهاز حِزم APK من خيار الصيغة الأول الذي يتطابق مع إعدادات الجهاز، مع إعطاء الأولوية لأرقام خيارات الصيغة الأعلى على أرقام خيارات الصيغة الأقل. |
VariantTargeting
الاستهداف على مستوى الصيغ.
تمثيل JSON |
---|
{ "sdkVersionTargeting": { object ( |
الحقول | |
---|---|
sdkVersionTargeting |
إصدار حزمة تطوير البرامج (SDK) الذي يستهدفه الصيغة |
abiTargeting |
واجهة برمجة التطبيقات التي يستهدفها الصيغة |
screenDensityTargeting |
كثافات الشاشة التي يتوافق معها هذا السعر المتغير |
multiAbiTargeting |
استهداف متعدد مستويات واجهات برمجة التطبيقات |
textureCompressionFormatTargeting |
الاستهداف على مستوى تنسيق ضغط البنية |
SdkVersionTargeting
الاستهداف استنادًا إلى إصدار حزمة تطوير البرامج (SDK)
تمثيل JSON |
---|
{ "value": [ { object ( |
الحقول | |
---|---|
value[] |
قيمة إصدار حزمة تطوير البرامج (SDK) |
alternatives[] |
استهداف الأدلة الشقيقة الأخرى التي كانت في الحِزمة بالنسبة إلى التقسيمات الرئيسية، يعني ذلك استهداف التقسيمات الرئيسية الأخرى. |
SdkVersion
يمثّل إصدار حزمة SDK.
تمثيل JSON |
---|
{ "min": integer } |
الحقول | |
---|---|
min |
قيمة أدنى شاملة لإصدار حزمة تطوير البرامج (SDK) |
AbiTargeting
الاستهداف استنادًا إلى آبي.
تمثيل JSON |
---|
{ "value": [ { object ( |
الحقول | |
---|---|
value[] |
قيمة آبي. |
alternatives[] |
استهداف الأدلة التابعة الأخرى التي كانت في الحزمة. بالنسبة إلى الأقسام الرئيسية، يستهدف هذا القسم الأقسام الرئيسية الأخرى. |
آبي
يمثّل عنصر Abi.
تمثيل JSON |
---|
{
"alias": enum ( |
الحقول | |
---|---|
alias |
الاسم المستعار لـ abi. |
AbiAlias
تعريف الاسم المعرِّف لواجهات ABI
عمليات التعداد | |
---|---|
UNSPECIFIED_CPU_ARCHITECTURE |
واجهة برمجة تطبيقات غير محدّدة |
ARMEABI |
أرMEABI آبي. |
ARMEABI_V7A |
ARMEABI_V7A abi. |
ARM64_V8A |
واجهة برمجة التطبيقات ARM64_V8A |
X86 |
X86 abi. |
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 |
كثافة شاشة HDPI. |
XHDPI |
كثافة شاشة XHDPI |
XXHDPI |
كثافة الشاشة هي XXHDPI. |
XXXHDPI |
كثافة شاشة XXXHDPI |
MultiAbiTargeting
الاستهداف استنادًا إلى قيم متعددة.
تمثيل JSON |
---|
{ "value": [ { object ( |
الحقول | |
---|---|
value[] |
قيمة حزمة abi متعددة. |
alternatives[] |
استهداف الأدلة التابعة الأخرى التي كانت في الحزمة. بالنسبة إلى التقسيمات الرئيسية، يعني ذلك استهداف التقسيمات الرئيسية الأخرى. |
MultiAbi
يمثّل قائمة بواجهات برمجة التطبيقات.
تمثيل JSON |
---|
{
"abi": [
{
object ( |
الحقول | |
---|---|
abi[] |
قائمة بواجهات برمجة التطبيقات المستهدَفة، كما تمثّلها منصة Android |
TextureCompressionFormatTargeting
الاستهداف حسب تنسيق ضغط النسيج
تمثيل JSON |
---|
{ "value": [ { object ( |
الحقول | |
---|---|
value[] |
قائمة إطارات الشفافية والموافقة المستهدَفة يجب ألا يكون فارغًا. |
alternatives[] |
createapks.list of TCFs البديلة (إطار الشفافية والموافقة الذي تستهدفه التقسيمات التابعة). |
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 بتنسيق رمز المنطقة المكوّن من حرفَين في CLDR |
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 |
يشير إلى نوع العرض للتثبيت الدائم. |