Products

برای لیست روش های این منبع، انتهای این صفحه را ببینید.

بازنمایی منابع

یک منبع محصولات، برنامه‌ای را در فروشگاه 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 نوع ارزش ارائه شده

مقادیر قابل قبول عبارتند از:
  • " bool "
  • " bundle "
  • " bundleArray "
  • " choice "
  • " hidden "
  • " integer "
  • " multiselect "
  • " 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 نوع محدودیت

مقادیر قابل قبول عبارتند از:
  • " bool "
  • " bundle "
  • " bundleArray "
  • " choice "
  • " hidden "
  • " integer "
  • " multiselect "
  • " 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 استفاده کنید.

مقادیر قابل قبول عبارتند از:
  • " alpha "
  • " beta "
  • " production "
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 رتبه بندی محتوا برای این برنامه

مقادیر قابل قبول عبارتند از:
  • " all "
  • " mature "
  • " preTeen "
  • " teen "
description string توضیحات تبلیغاتی محلی، در صورت وجود.
detailsUrl string پیوندی به صفحه جزئیات Google Play (مصرف کننده) برای محصول.
distributionChannel string این بسته چگونه و در اختیار چه کسانی قرار می گیرد. مقدار publicGoogleHosted به این معنی است که بسته از طریق فروشگاه Play در دسترس است و محدود به یک شرکت خاص نیست. مقدار privateGoogleHosted به این معنی است که بسته یک برنامه خصوصی است (محدود به یک شرکت) اما توسط Google میزبانی می شود. مقدار privateSelfHosted به این معنی است که بسته یک برنامه خصوصی است (محدود به یک شرکت) و به صورت خصوصی میزبانی می شود.

مقادیر قابل قبول عبارتند از:
  • " privateGoogleHosted "
  • " privateSelfHosted "
  • " publicGoogleHosted "
features[] list ویژگی های قابل توجه (در صورت وجود) این محصول.
fullDescription string توضیحات فروشگاه برنامه کامل بومی سازی شده، در صورت موجود بودن.
iarcGenericRating string رتبه بندی محتوا برای این برنامه

مقادیر قابل قبول عبارتند از:
  • " eighteenYears "
  • " iarcGenericRatingUnspecified "
  • " sevenYears "
  • " sixteenYears "
  • " threeYears "
  • " twelveYears "
iconUrl string پیوندی به تصویری که می تواند به عنوان نمادی برای محصول استفاده شود. این تصویر برای استفاده تا 512×512 پیکسل مناسب است.
kind string
lastUpdatedTimestampMillis long زمان تقریبی (در عرض 7 روز) آخرین بار برنامه منتشر شده است که بر حسب میلی ثانیه از آن دوره بیان شده است.
minAndroidSdkVersion integer حداقل Android SDK لازم برای اجرای برنامه.
permissions[] list لیستی از مجوزهای مورد نیاز برنامه
permissions[]. permissionId string رشته ای مات که به طور منحصر به فرد مجوز را شناسایی می کند.
permissions[]. state string خواه اجازه پذیرفته شده باشد یا خیر.

مقادیر قابل قبول عبارتند از:
  • " accepted "
  • " required "
productId string یک رشته از app:<package name> . برای مثال، app:com.google.android.gm نشان دهنده برنامه Gmail است.
productPricing string چه این محصول رایگان باشد، چه رایگان با خریدهای درون برنامه ای، چه پولی. اگر قیمت ناشناخته باشد، این بدان معناست که محصول دیگر به طور کلی در دسترس نیست (حتی اگر ممکن است هنوز برای افرادی که آن را دارند در دسترس باشد).

مقادیر قابل قبول عبارتند از:
  • " free "
  • " freeWithInAppPurchase "
  • " paid "
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 مورد نیاز این برنامه را بازیابی می کند.
فهرست
محصولات تایید شده را که با یک جستار مطابقت دارند یا تمام محصولات تایید شده را در صورت عدم وجود درخواست پیدا می کند.
تایید نکردن
محصول مشخص شده را تایید نمی کند (و مجوزهای برنامه مربوطه، در صورت وجود)