برای لیست روش های این منبع، انتهای این صفحه را ببینید.
بازنمایی منابع
یک منبع محصولات، برنامهای را در فروشگاه Google Play نشان میدهد که حداقل برای برخی از کاربران شرکت در دسترس است. (برخی از برنامه ها به یک شرکت محدود می شوند و هیچ اطلاعاتی در مورد آنها در خارج از آن شرکت در دسترس نیست.)
اطلاعات ارائه شده برای هر محصول (نام محلی، نماد، پیوند به صفحه جزئیات کامل Google Play) برای اجازه دادن به نمایش اولیه محصول در یک رابط کاربری EMM در نظر گرفته شده است.
{ "kind": "androidenterprise#product", "productId": string, "title": string, "authorName": string, "iconUrl": string, "smallIconUrl": string, "detailsUrl": string, "workDetailsUrl": string, "requiresContainerApp": boolean, "appVersion": [ { "versionString": string, "versionCode": integer, "track": string, "targetSdkVersion": integer, "trackId": [ string ], "isProduction": boolean } ], "distributionChannel": string, "productPricing": string, "signingCertificate": { "certificateHashSha256": string, "certificateHashSha1": string }, "availableTracks": [ string ], "appTracks": [ { "trackId": string, "trackAlias": string } ], "description": string, "fullDescription": string, "screenshotUrls": [ string ], "category": string, "recentChanges": string, "minAndroidSdkVersion": integer, "contentRating": string, "lastUpdatedTimestampMillis": long, "permissions": [ { "permissionId": string, "state": string } ], "availableCountries": [ string ], "features": [ string ], "iarcGenericRating": string, "appRestrictionsSchema": { "kind": string, "restrictions": [ { "key": string, "title": string, "restrictionType": string, "description": string, "entry": [ string ], "entryValue": [ string ], "defaultValue": { "type": string, "valueBool": boolean, "valueString": string, "valueInteger": integer, "valueMultiselect": [ string ] }, "nestedRestriction": [ (AppRestrictionsSchemaRestriction) ] } ] } }
نام ملک | ارزش | توضیحات | یادداشت ها |
---|---|---|---|
appRestrictionsSchema | nested object | طرح محدودیت اپلیکیشن | |
appRestrictionsSchema. kind | string | منسوخ شده است. | |
appRestrictionsSchema. restrictions[] | list | مجموعه محدودیت هایی که این طرحواره را تشکیل می دهد. | |
appRestrictionsSchema.restrictions[]. defaultValue | nested object | مقدار پیش فرض محدودیت. محدودیت های bundle و bundleArray هرگز یک مقدار پیش فرض ندارند. | |
appRestrictionsSchema.restrictions[].defaultValue. type | string | نوع ارزش ارائه شده مقادیر قابل قبول عبارتند از:
| |
appRestrictionsSchema.restrictions[].defaultValue. valueBool | boolean | مقدار بولی - این فقط در صورتی وجود دارد که نوع bool باشد. | |
appRestrictionsSchema.restrictions[].defaultValue. valueInteger | integer | مقدار صحیح - این فقط در صورتی وجود دارد که نوع عدد صحیح باشد. | |
appRestrictionsSchema.restrictions[].defaultValue. valueMultiselect[] | list | لیست مقادیر رشته - این فقط در صورتی وجود دارد که نوع چند انتخابی باشد. | |
appRestrictionsSchema.restrictions[].defaultValue. valueString | string | مقدار رشته - این مقدار برای انواع رشته، انتخاب و مخفی وجود خواهد داشت. | |
appRestrictionsSchema.restrictions[]. description | string | شرح طولانی تر از محدودیت، ارائه جزئیات بیشتر از آنچه که آن را تحت تاثیر قرار. | |
appRestrictionsSchema.restrictions[]. entryValue[] | list | برای محدودیتهای choice یا multiselect ، فهرستی از مقادیر قابل خواندن توسط ماشین ورودیهای ممکن. این مقادیر باید در پیکربندی استفاده شوند، یا به عنوان یک مقدار string برای یک محدودیت choice یا در یک stringArray برای یک محدودیت multiselect . | |
appRestrictionsSchema.restrictions[]. entry[] | list | برای محدودیتهای choice یا multiselect ، فهرستی از نامهای ورودیهای احتمالی قابل خواندن توسط انسان. | |
appRestrictionsSchema.restrictions[]. key | string | کلید منحصر به فردی که محصول برای شناسایی محدودیت استفاده می کند، به عنوان مثال "com.google.android.gm.fieldname". | |
appRestrictionsSchema.restrictions[]. nestedRestriction[] | list | برای محدودیتهای bundle یا bundleArray ، فهرستی از محدودیتهای تودرتو. یک محدودیت bundle همیشه در داخل یک محدودیت bundleArray قرار دارد و یک محدودیت bundleArray حداکثر در دو سطح عمیق است. | |
appRestrictionsSchema.restrictions[]. restrictionType | string | نوع محدودیت مقادیر قابل قبول عبارتند از:
| |
appRestrictionsSchema.restrictions[]. title | string | نام محدودیت. | |
appTracks[] | list | مسیرهای قابل مشاهده برای شرکت | |
appTracks[]. trackAlias | string | یک نام قابل تغییر برای یک آهنگ این نام قابل مشاهده در کنسول توسعه دهنده play است. | |
appTracks[]. trackId | string | شناسه تراک غیرقابل تغییر و منحصر به فرد. این شناسه releaseTrackId در url صفحه کنسول توسعه دهنده play است که اطلاعات آهنگ را نمایش می دهد. | |
appVersion[] | list | نسخه های برنامه در حال حاضر برای این محصول موجود است. | |
appVersion[]. isProduction | boolean | اگر این نسخه یک APK تولیدی باشد درست است. | |
appVersion[]. targetSdkVersion | integer | نسخه SDK مورد نظر این برنامه، همانطور که در مانیفست APK مشخص شده است. به http://developer.android.com/guide/topics/manifest/uses-sdk-element.html مراجعه کنید | |
appVersion[]. track | string | منسوخ شده است، به جای آن از trackId استفاده کنید.مقادیر قابل قبول عبارتند از:
| |
appVersion[]. trackId[] | list | شناسههای آهنگی که نسخه برنامه در آنها منتشر شده است. جایگزین فیلد track (منسوخ شده) میشود، اما مسیر تولید را شامل نمیشود (به جای آن به isProduction مراجعه کنید). | |
appVersion[]. versionCode | integer | شناسه افزایشی منحصر به فرد برای نسخه برنامه. | |
appVersion[]. versionString | string | رشته ای که توسعه دهنده برنامه در فروشگاه Play برای شناسایی نسخه استفاده می کند. رشته لزوما منحصر به فرد یا محلی نیست (به عنوان مثال، رشته می تواند "1.4" باشد). | |
authorName | string | نام نویسنده محصول (به عنوان مثال، توسعه دهنده برنامه). | |
availableCountries[] | list | کشورهایی که این برنامه در آنها موجود است. | |
availableTracks[] | list | منسوخ شده است، به جای آن از appTracks استفاده کنید. | |
category | string | دسته برنامه (مانند RACING، SOCIAL، و غیره) | |
contentRating | string | رتبه بندی محتوا برای این برنامه مقادیر قابل قبول عبارتند از:
| |
description | string | توضیحات تبلیغاتی محلی، در صورت وجود. | |
detailsUrl | string | پیوندی به صفحه جزئیات Google Play (مصرف کننده) برای محصول. | |
distributionChannel | string | این بسته چگونه و در اختیار چه کسانی قرار می گیرد. مقدار publicGoogleHosted به این معنی است که بسته از طریق فروشگاه Play در دسترس است و محدود به یک شرکت خاص نیست. مقدار privateGoogleHosted به این معنی است که بسته یک برنامه خصوصی است (محدود به یک شرکت) اما توسط Google میزبانی می شود. مقدار privateSelfHosted به این معنی است که بسته یک برنامه خصوصی است (محدود به یک شرکت) و به صورت خصوصی میزبانی می شود.مقادیر قابل قبول عبارتند از:
| |
features[] | list | ویژگی های قابل توجه (در صورت وجود) این محصول. | |
fullDescription | string | توضیحات فروشگاه برنامه کامل بومی سازی شده، در صورت موجود بودن. | |
iarcGenericRating | string | رتبه بندی محتوا برای این برنامه مقادیر قابل قبول عبارتند از:
| |
iconUrl | string | پیوندی به تصویری که می تواند به عنوان نمادی برای محصول استفاده شود. این تصویر برای استفاده تا 512×512 پیکسل مناسب است. | |
kind | string | ||
lastUpdatedTimestampMillis | long | زمان تقریبی (در عرض 7 روز) آخرین بار برنامه منتشر شده است که بر حسب میلی ثانیه از آن دوره بیان شده است. | |
minAndroidSdkVersion | integer | حداقل Android SDK لازم برای اجرای برنامه. | |
permissions[] | list | لیستی از مجوزهای مورد نیاز برنامه | |
permissions[]. permissionId | string | رشته ای مات که به طور منحصر به فرد مجوز را شناسایی می کند. | |
permissions[]. state | string | خواه اجازه پذیرفته شده باشد یا خیر. مقادیر قابل قبول عبارتند از:
| |
productId | string | یک رشته از app:<package name> . برای مثال، app:com.google.android.gm نشان دهنده برنامه Gmail است. | |
productPricing | string | چه این محصول رایگان باشد، چه رایگان با خریدهای درون برنامه ای، چه پولی. اگر قیمت ناشناخته باشد، این بدان معناست که محصول دیگر به طور کلی در دسترس نیست (حتی اگر ممکن است هنوز برای افرادی که آن را دارند در دسترس باشد). مقادیر قابل قبول عبارتند از:
| |
recentChanges | string | شرح تغییرات اخیر ایجاد شده در برنامه. | |
requiresContainerApp | boolean | منسوخ شده است. | |
screenshotUrls[] | list | لیستی از پیوندهای اسکرین شات نشان دهنده برنامه. | |
signingCertificate | nested object | گواهی استفاده شده برای امضای این محصول. | |
signingCertificate. certificateHashSha1 | string | urlsafe base64 هش SHA1 گواهی را رمزگذاری کرد. (این فیلد به نفع SHA2-256 منسوخ شده است. نباید از آن استفاده کرد و ممکن است در هر زمانی حذف شود.) | |
signingCertificate. certificateHashSha256 | string | urlsafe base64 هش SHA2-256 گواهی را رمزگذاری کرد. | |
smallIconUrl | string | پیوندی به یک تصویر کوچکتر که می تواند به عنوان نمادی برای محصول استفاده شود. این تصویر برای استفاده تا 128×128 پیکسل مناسب است. | |
title | string | نام محصول. | |
workDetailsUrl | string | پیوندی به صفحه جزئیات مدیریت شده Google Play برای محصول، برای استفاده توسط سرپرست Enterprise. |
روش ها
- تایید کند
در صورت وجود، محصول مشخص شده و مجوزهای برنامه مربوطه را تأیید می کند. حداکثر تعداد محصولاتی که می توانید به ازای هر مشتری سازمانی تأیید کنید 1000 است.
برای آشنایی با نحوه استفاده از Google Play مدیریت شده برای طراحی و ایجاد طرحبندی فروشگاه برای نمایش محصولات تأیید شده به کاربران، به طراحی چیدمان فروشگاه مراجعه کنید.
- generateApprovalUrl
- نشانی اینترنتی ایجاد می کند که می تواند در iframe برای نمایش مجوزهای (در صورت وجود) یک محصول ارائه شود. یک سرپرست سازمانی باید این مجوزها را ببیند و آنها را از طرف سازمان خود بپذیرد تا آن محصول را تأیید کند.
سرپرستان باید مجوزهای نمایش داده شده را با تعامل با یک عنصر رابط کاربری جداگانه در کنسول EMM بپذیرند، که به نوبه خود باید استفاده از این نشانی اینترنتی را به عنوان ویژگیapprovalUrlInfo.approvalUrl
در تماسProducts.approve
برای تأیید محصول فعال کند. این URL فقط برای نمایش مجوزها تا 1 روز قابل استفاده است. - دریافت کنید
- جزئیات یک محصول را برای نمایش به یک مدیر سازمانی بازیابی می کند.
- getAppRestrictionsSchema
- طرحی را که ویژگی های قابل تنظیم برای این محصول را تعریف می کند، بازیابی می کند. همه محصولات دارای یک طرح هستند، اما اگر هیچ پیکربندی مدیریت شده ای تعریف نشده باشد، ممکن است این طرح خالی باشد. این طرح را می توان برای پر کردن یک رابط کاربری استفاده کرد که به مدیر اجازه می دهد محصول را پیکربندی کند. برای اعمال یک پیکربندی مدیریت شده بر اساس طرح به دست آمده با استفاده از این API، به تنظیمات مدیریت شده از طریق Play مراجعه کنید.
- دریافت مجوزها
- مجوزهای برنامه Android مورد نیاز این برنامه را بازیابی می کند.
- فهرست
- محصولات تایید شده را که با یک جستار مطابقت دارند یا تمام محصولات تایید شده را در صورت عدم وجود درخواست پیدا می کند.
- تایید نکردن
- محصول مشخص شده را تایید نمی کند (و مجوزهای برنامه مربوطه، در صورت وجود)