مهم: ما دیگر ثبت نام های جدید برای Play EMM API را نمی پذیریم. بیشتر بدانید .

این صفحه به‌وسیله ‏Cloud Translation API‏ ترجمه شده است.

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 مورد نیاز این برنامه را بازیابی می کند.

فهرست

محصولات تایید شده را که با یک جستار مطابقت دارند یا تمام محصولات تایید شده را در صورت عدم وجود درخواست پیدا می کند. توجه: این مورد منسوخ شده است. ادغام های جدید نمی توانند از این روش استفاده کنند و می توانند به توصیه های جدید ما مراجعه کنند.

تایید نکردن

محصول مشخص شده را تایید نمی کند (و مجوزهای برنامه مربوطه، در صورت وجود) توجه: این مورد منسوخ شده است. ادغام های جدید نمی توانند از این روش استفاده کنند و می توانند به توصیه های جدید ما مراجعه کنند.