- درخواست HTTP
- پارامترهای مسیر
- درخواست بدنه
- بدنه پاسخ
- دامنههای مجوز
- GeneratedApksPerSigningKey
- SplitApk تولید شده
- برش GeneratedAssetPack
- بستهی مستقل تولید شده
- GeneratedUniversalApk
- بازیابی تولید شده APK
- اطلاعات هدفگیری
- SplitApkVariant
- هدفگیری متغیر
- هدفگیری نسخههای SDK
- نسخه SDK
- ابی تارگتینگ
- ابی
- ابی الیاس
- هدفگیری تراکم صفحه
- تراکم صفحه نمایش
- نام مستعار چگالی
- هدفگیری چندگانه
- مولتیآبی
- فشردهسازی بافتقالببندیهدفگیری
- قالب فشردهسازی بافت
- نام مستعار قالب فشردهسازی بافت
- ApkSet
- ماژول فراداده
- نوع ماژول ویژگی
- نوع تحویل
- ماژول هدفگیری
- هدفگیری ویژگیهای دستگاه
- ویژگی دستگاه
- هدفگیری کاربران کشورها
- توضیحات APK
- ApkTargeting
- هدفگیری زبانی
- فراداده SplitApk
- مستقلApkفراداده
- مجموعه برش دارایی
- ماژول داراییفراداده
- امتحانش کن!
متادیتای دانلود تمام فایلهای APK تولید شده از یک بستهی نرمافزاری مشخص را برمیگرداند.
درخواست HTTP
GET https://androidpublisher.googleapis.com/androidpublisher/v3/applications/{packageName}/generatedApks/{versionCode}
این URL از سینتکس Transcoding در gRPC استفاده میکند.
پارامترهای مسیر
| پارامترها | |
|---|---|
packageName | نام بسته برنامه. |
versionCode | کد نسخه بسته نرمافزاری. |
درخواست بدنه
بدنه درخواست باید خالی باشد.
بدنه پاسخ
پاسخ به APK های تولید شده در لیست.
در صورت موفقیت، بدنه پاسخ شامل دادههایی با ساختار زیر است:
| نمایش JSON |
|---|
{
"generatedApks": [
{
object ( |
| فیلدها | |
|---|---|
generatedApks[] | تمام APK های تولید شده، بر اساس کلید امضای APK گروه بندی شده اند. |
دامنههای مجوز
به محدوده OAuth زیر نیاز دارد:
-
https://www.googleapis.com/auth/androidpublisher
GeneratedApksPerSigningKey
فرادادههای generateapks.download برای APKهای چندبخشی، مستقل و جهانی، و همچنین برشهای بستههای دارایی، که با یک کلید مشخص امضا شدهاند.
| نمایش JSON |
|---|
{ "certificateSha256Hash": string, "generatedSplitApks": [ { object ( |
| فیلدها | |
|---|---|
certificateSha256Hash | هش SHA256 مربوط به گواهی کلید عمومی امضای APK. |
generatedSplitApks[] | generateapks.list از APK های تقسیم شده تولید شده، که با کلیدی مربوط به certificateSha256Hash امضا شده اند. |
generatedAssetPackSlices[] | generateapks.list از برشهای بسته دارایی که برای این بسته برنامه ارائه خواهند شد، با کلیدی مربوط به certificateSha256Hash امضا شدهاند. |
generatedStandaloneApks[] | generateapks.list از APK های مستقل تولید شده، که با کلیدی مربوط به certificateSha256Hash امضا شدهاند. |
generatedUniversalApk | APK جهانی تولید شده، با کلیدی مربوط به certificateSha256Hash امضا شده است. اگر هیچ APK جهانی برای این کلید امضا ایجاد نشده باشد، این فیلد تنظیم نمیشود. |
generatedRecoveryModules[] | فایلهای apk بازیابی تولید شده برای اقدامات بازیابی که با کلیدی مربوط به certificateSha256Hash امضا شدهاند. این شامل همه فایلهای apk بازیابی تولید شده، همچنین آنهایی که در حالت پیشنویس یا لغو شده هستند، میشود. اگر هیچ اقدام بازیابی برای این کلید امضا ایجاد نشده باشد، این فیلد تنظیم نمیشود. |
unprotectedGeneratedSplitApks[] | generatedapks.list از APK های تقسیم شده تولید شده بدون محافظت خودکار، که با کلیدی مربوط به certificateSha256Hash امضا شده اند. این فیلد فقط در صورتی وجود دارد که برنامه از محافظت خودکار استفاده کند. در این حالت، |
unprotectedGeneratedStandaloneApks[] | generateapks.list از APK های مستقل تولید شده بدون محافظت خودکار، که با کلیدی مربوط به certificateSha256Hash امضا شدهاند. این فیلد فقط در صورتی وجود دارد که برنامه از محافظت خودکار استفاده کند. در این حالت، |
targetingInfo | حاوی اطلاعات هدفگیری در مورد apk های تولید شده است. |
SplitApk تولید شده
دانلود فراداده برای یک APK چند قسمتی.
| نمایش JSON |
|---|
{ "downloadId": string, "variantId": integer, "moduleName": string, "splitId": string } |
| فیلدها | |
|---|---|
downloadId | شناسه generateapks.download که به طور منحصر به فرد فایل APK مورد نظر برای دانلود را مشخص میکند. باید به متد |
variantId | شناسهی گونهی تولید شده. |
moduleName | نام ماژولی که این APK به آن تعلق دارد. |
splitId | شناسه تقسیمشده. برای تقسیم اصلی ماژول پایه خالی است. |
برش GeneratedAssetPack
فرادادههای generateapks.download برای یک برش از بسته دارایی.
| نمایش JSON |
|---|
{ "downloadId": string, "moduleName": string, "sliceId": string, "version": string } |
| فیلدها | |
|---|---|
downloadId | شناسه generateapks.download که به طور منحصر به فرد فایل APK مورد نظر برای دانلود را مشخص میکند. باید به متد |
moduleName | نام ماژولی که این قطعه دارایی به آن تعلق دارد. |
sliceId | شناسه برش دارایی. |
version | نسخه ماژول دارایی. |
بستهی مستقل تولید شده
دانلود فراداده برای یک APK مستقل.
| نمایش JSON |
|---|
{ "downloadId": string, "variantId": integer } |
| فیلدها | |
|---|---|
downloadId | شناسه generateapks.download که به طور منحصر به فرد فایل APK مورد نظر برای دانلود را مشخص میکند. باید به متد |
variantId | شناسهی گونهی تولید شده. |
GeneratedUniversalApk
فرادادههای generateapks.download برای یک APK جهانی.
| نمایش JSON |
|---|
{ "downloadId": string } |
| فیلدها | |
|---|---|
downloadId | شناسه generateapks.download که به طور منحصر به فرد فایل APK مورد نظر برای دانلود را مشخص میکند. باید به متد |
بازیابی تولید شده APK
فرادادههای generateapks.download برای ماژول بازیابی برنامه.
| نمایش JSON |
|---|
{
"downloadId": string,
"recoveryId": string,
"recoveryStatus": enum ( |
| فیلدها | |
|---|---|
downloadId | شناسه generateapks.download که به طور منحصر به فرد فایل APK مورد نظر برای دانلود را مشخص میکند. باید به متد |
recoveryId | شناسه اقدام بازیابی. |
recoveryStatus | وضعیت اقدام بازیابی مربوط به apk بازیابی. |
moduleName | نام ماژولی که فایل apk ریکاوری به آن تعلق دارد. |
اطلاعات هدفگیری
هدف قرار دادن اطلاعات مربوط به apk های تولید شده.
| نمایش JSON |
|---|
{ "packageName": string, "variant": [ { object ( |
| فیلدها | |
|---|---|
packageName | نام بسته این برنامه. |
variant[] | generateapks.list از انواع ایجاد شده. |
assetSliceSet[] | generateapks.list از برشهای دارایی ایجاد شده. |
SplitApkVariant
نسخههای مختلف، گروهی از APKها هستند که بخشی از فضای پیکربندی دستگاه را پوشش میدهند. APKهای چندین نسخه هرگز در یک دستگاه ترکیب نمیشوند.
| نمایش JSON |
|---|
{ "targeting": { object ( |
| فیلدها | |
|---|---|
targeting | هدفگذاری در سطوح متغیر. |
apkSet[] | مجموعهای از APKها، یک مجموعه برای هر ماژول. |
variantNumber | شمارهی گونه، از ۰ شروع میشود (مگر اینکه لغو شده باشد). یک دستگاه، APKها را از اولین گونهای که با پیکربندی دستگاه مطابقت دارد دریافت میکند، و شمارههای گونهی بالاتر نسبت به شمارههای گونهی پایینتر اولویت دارند. |
هدفگیری متغیر
هدفگذاری در سطح متغیرها.
| نمایش JSON |
|---|
{ "sdkVersionTargeting": { object ( |
| فیلدها | |
|---|---|
sdkVersionTargeting | نسخه sdk که این نوع بدافزار آن را هدف قرار میدهد |
abiTargeting | abi که این گونه هدف قرار میدهد |
screenDensityTargeting | تراکم صفحه نمایشهایی که این مدل پشتیبانی میکند |
multiAbiTargeting | هدفگیری چند سطحی API |
textureCompressionFormatTargeting | هدفگیری در سطح قالب فشردهسازی بافت |
هدفگیری نسخههای SDK
هدفگیری بر اساس نسخه sdk.
| نمایش JSON |
|---|
{ "value": [ { object ( |
| فیلدها | |
|---|---|
value[] | مقدار یک نسخه sdk. |
alternatives[] | هدف قرار دادن سایر دایرکتوریهای خواهر و برادر که در Bundle بودند. برای تقسیمبندیهای اصلی، این هدف قرار دادن سایر تقسیمبندیهای اصلی است. |
نسخه SDK
نشان دهنده نسخه sdk است.
| نمایش JSON |
|---|
{ "min": integer } |
| فیلدها | |
|---|---|
min | حداقل مقدار شامل یک نسخه sdk. |
ابی تارگتینگ
هدفگیری بر اساس ابی.
| نمایش JSON |
|---|
{ "value": [ { object ( |
| فیلدها | |
|---|---|
value[] | ارزش یک آبی. |
alternatives[] | هدف قرار دادن سایر دایرکتوریهای خواهر و برادر که در Bundle بودند. برای تقسیمبندیهای اصلی، این هدف قرار دادن سایر تقسیمبندیهای اصلی است. |
ابی
نماینده یک ابی است.
| نمایش JSON |
|---|
{
"alias": enum ( |
| فیلدها | |
|---|---|
alias | نام مستعار برای یک آبی. |
ابی الیاس
تعریف نام مستعار برای abis.
| انومها | |
|---|---|
UNSPECIFIED_CPU_ARCHITECTURE | ابی نامشخص. |
ARMEABI | آرمئابی ابی. |
ARMEABI_V7A | ARMEABI_V7A (با احترام) |
ARM64_V8A | ARM64_V8A به این شکل است. |
X86 | ایکس۸۶ ابی. |
X86_64 | X86_64 آبی. |
RISCV64 | RISCV64 ab. |
هدفگیری تراکم صفحه
هدفگذاری بر اساس تراکم صفحه نمایش
| نمایش JSON |
|---|
{ "value": [ { object ( |
| فیلدها | |
|---|---|
value[] | مقدار چگالی صفحه نمایش. |
alternatives[] | هدف قرار دادن سایر دایرکتوریهای خواهر و برادر که در Bundle بودند. برای تقسیمبندیهای اصلی، این هدف قرار دادن سایر تقسیمبندیهای اصلی است. |
تراکم صفحه نمایش
نشان دهنده تراکم صفحه نمایش است.
| نمایش JSON |
|---|
{ // Union field |
| فیلدها | |
|---|---|
| |
densityAlias | نام مستعار برای تراکم صفحه نمایش. |
densityDpi | مقدار چگالی dpi. |
نام مستعار چگالی
تعریف نام مستعار برای تراکم صفحه نمایش.
| انومها | |
|---|---|
DENSITY_UNSPECIFIED | تراکم صفحه نمایش نامشخص. |
NODPI | تراکم صفحه نمایش NODPI. |
LDPI | تراکم صفحه نمایش LDPI |
MDPI | تراکم صفحه نمایش MDPI |
TVDPI | تراکم صفحه نمایش TVDPI |
HDPI | تراکم صفحه نمایش HDPI |
XHDPI | تراکم صفحه نمایش XHDPI |
XXHDPI | تراکم صفحه نمایش XXHDPI. |
XXXHDPI | تراکم صفحه نمایش XXXHDPI |
هدفگیری چندگانه
هدفگیری بر اساس چندین هدف.
| نمایش JSON |
|---|
{ "value": [ { object ( |
| فیلدها | |
|---|---|
value[] | ارزش یک مولتی ابی. |
alternatives[] | هدف قرار دادن سایر دایرکتوریهای خواهر و برادر که در Bundle بودند. برای تقسیمبندیهای اصلی، این هدف قرار دادن سایر تقسیمبندیهای اصلی است. |
مولتیآبی
لیستی از ABI ها را نشان می دهد.
| نمایش JSON |
|---|
{
"abi": [
{
object ( |
| فیلدها | |
|---|---|
abi[] | فهرستی از ABIهای هدف، همانطور که توسط پلتفرم اندروید نشان داده شده است |
فشردهسازی بافتقالببندیهدفگیری
هدفگیری با استفاده از یک قالب فشردهسازی بافت.
| نمایش JSON |
|---|
{ "value": [ { object ( |
| فیلدها | |
|---|---|
value[] | فهرست TCF های هدفمند. نباید خالی باشد. |
alternatives[] | generateapks.list از TCF های جایگزین (TCF های هدف قرار گرفته توسط انشعابات خواهر و برادر). |
قالب فشردهسازی بافت
نشان دهنده فرمت فشرده سازی بافت است.
| نمایش JSON |
|---|
{
"alias": enum ( |
| فیلدها | |
|---|---|
alias | نام مستعار برای قالب فشردهسازی بافت. |
نام مستعار قالب فشردهسازی بافت
تعریف نام مستعار برای قالبهای فشردهسازی بافت.
| انومها | |
|---|---|
UNSPECIFIED_TEXTURE_COMPRESSION_FORMAT | قالب نامشخص. |
ETC1_RGB8 | فرمت ETC1_RGB8. |
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 های تولید شده. |
ماژول فراداده
متادیتای یک ماژول.
| نمایش JSON |
|---|
{ "name": string, "moduleType": enum ( |
| فیلدها | |
|---|---|
name | نام ماژول. |
moduleType | نوع این ماژول ویژگی را نشان میدهد. |
deliveryType | نوع تحویل (مثلاً بر اساس تقاضا) ماژول را نشان میدهد. |
dependencies[] | نام ماژولهایی که این ماژول مستقیماً به آنها وابسته است. هر ماژول به طور ضمنی به ماژول پایه وابسته است. |
targeting | هدفگیری که باعث نصب یک ماژول شرطی میشود. فقط برای APKهای تقسیمشده مرتبط است. |
نوع ماژول ویژگی
نوع ماژول ویژگی.
| انومها | |
|---|---|
UNKNOWN_MODULE_TYPE | ماژول ویژگی ناشناخته. |
FEATURE_MODULE | ماژول ویژگی معمولی. |
نوع تحویل
نوع تحویل ماژول را نشان میدهد.
| انومها | |
|---|---|
UNKNOWN_DELIVERY_TYPE | نوع تحویل نامشخص |
INSTALL_TIME | این ماژول همیشه به عنوان بخشی از نصب اولیه برنامه دانلود میشود. |
ON_DEMAND | این ماژول بنا به درخواست (on-demand) درخواست میشود، به این معنی که بخشی از نصب اولیه نخواهد بود و فقط در صورت درخواست مشتری ارسال میشود. |
FAST_FOLLOW | این ماژول بلافاصله پس از اتمام نصب اولیه دانلود خواهد شد. برنامه را میتوان قبل از دانلود این ماژولها باز کرد. |
ماژول هدفگیری
هدفگذاری در سطح ماژول.
| نمایش JSON |
|---|
{ "sdkVersionTargeting": { object ( |
| فیلدها | |
|---|---|
sdkVersionTargeting | نسخه sdk که این نوع بدافزار آن را هدف قرار میدهد |
deviceFeatureTargeting[] | هدف قرار دادن ویژگیهای دستگاه. |
userCountriesTargeting | هدفگذاری در سطح کشورها |
هدفگیری ویژگیهای دستگاه
هدف قرار دادن یک ویژگی دستگاه.
| نمایش JSON |
|---|
{
"requiredFeature": {
object ( |
| فیلدها | |
|---|---|
requiredFeature | ویژگی دستگاه. |
ویژگی دستگاه
نشان دهنده یک ویژگی دستگاه است.
| نمایش JSON |
|---|
{ "featureName": string, "featureVersion": integer } |
| فیلدها | |
|---|---|
featureName | نام ویژگی. |
featureVersion | نسخه ویژگی مشخص شده توسط android:glEsVersion یا android:version در |
هدفگیری کاربران کشورها
فهرستی شامل/منحصر به فرد از کدهای کشوری که ماژول آنها را هدف قرار میدهد، شرح میدهد.
| نمایش JSON |
|---|
{ "countryCodes": [ string ], "exclude": boolean } |
| فیلدها | |
|---|---|
countryCodes[] | generateapks.list کدهای کشور در قالب قلمرو دو حرفی CLDR. |
exclude | نشان میدهد که آیا لیست بالا انحصاری است یا خیر. |
توضیحات APK
توضیحات apk های ایجاد شده.
| نمایش JSON |
|---|
{ "targeting": { object ( |
| فیلدها | |
|---|---|
targeting | هدفگیری در سطح Apk. |
path | مسیر Apk، به شکل زیر خواهد بود: |
فیلد متحد | |
splitApkMetadata | فقط برای فایلهای APK تقسیمشده تنظیم شود. |
standaloneApkMetadata | فقط برای APK های مستقل تنظیم شده است. |
instantApkMetadata | فقط برای فایلهای APK تقسیمشده فوری تنظیم شود. |
assetSliceMetadata | فقط برای برشهای دارایی تنظیم شود. |
ApkTargeting
مجموعهای از هدفگذاریهای سطح apk را نشان میدهد.
| نمایش JSON |
|---|
{ "abiTargeting": { object ( |
| فیلدها | |
|---|---|
abiTargeting | ابی که apk آن را هدف قرار میدهد |
languageTargeting | زبانی که apk هدف قرار میدهد |
screenDensityTargeting | تراکم صفحه نمایشی که این apk از آن پشتیبانی میکند. |
sdkVersionTargeting | نسخه sdk که apk آن را هدف قرار میدهد |
textureCompressionFormatTargeting | هدفگیری در سطح قالب فشردهسازی بافت |
multiAbiTargeting | هدفگذاری چند سطحی API. |
هدفگیری زبانی
هدفگذاری بر اساس زبان
| نمایش JSON |
|---|
{ "value": [ string ], "alternatives": [ string ] } |
| فیلدها | |
|---|---|
value[] | ISO-639: کد زبان ۲ یا ۳ حرفی. |
alternatives[] | زبانهای جایگزین. |
فراداده SplitApk
دادههای مخصوص فایلهای APK تقسیمشده را نگه میدارد.
| نمایش JSON |
|---|
{ "splitId": string, "isMasterSplit": boolean } |
| فیلدها | |
|---|---|
splitId | شناسهی تقسیم. |
isMasterSplit | نشان میدهد که آیا این APK، بخش اصلی ماژول است یا خیر. |
مستقلApkفراداده
دادههای مخصوص فایلهای APK مستقل را نگهداری میکند.
| نمایش JSON |
|---|
{ "fusedModuleName": [ string ] } |
| فیلدها | |
|---|---|
fusedModuleName[] | نام ماژولهای ادغامشده در این APK مستقل. |
مجموعه برش دارایی
مجموعهای از برشهای دارایی متعلق به یک ماژول دارایی واحد.
| نمایش JSON |
|---|
{ "assetModuleMetadata": { object ( |
| فیلدها | |
|---|---|
assetModuleMetadata | فراداده سطح ماژول. |
apkDescription[] | برشهای دارایی. |
ماژول داراییفراداده
فراداده یک ماژول دارایی.
| نمایش JSON |
|---|
{
"name": string,
"deliveryType": enum ( |
| فیلدها | |
|---|---|
name | نام ماژول. |
deliveryType | نوع تحویل برای نصب مداوم را نشان میدهد. |