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

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

Enterprises

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

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

یک منبع Enterprises نشان دهنده پیوند بین یک EMM و یک سازمان خاص است. این اتصال را می توان به یکی از دو روش مختلف با استفاده از این API به شرح زیر نمونه برداری کرد:

برای مشتریان دامنه مدیریت‌شده Google، این فرآیند شامل استفاده از Enterprises.enroll و Enterprises.setAccount (همراه با مصنوعات به‌دست‌آمده از کنسول Admin و Google API Console) و از طریق یک فرآیند کم و بیش دستی به EMM ارسال می‌شود.
برای مشتریان حساب‌های Google Play مدیریت‌شده، این فرآیند شامل استفاده از Enterprises.generateSignupUrl و Enterprises.completeSignup همراه با رابط کاربری مدیریت‌شده ثبت‌نام Google Play (مکانیسم ارائه‌شده توسط Google) برای ایجاد اتصال بدون مراحل دستی است.

به عنوان یک EMM، می‌توانید از یکی یا هر دو رویکرد در کنسول EMM خود پشتیبانی کنید. برای جزئیات بیشتر به Create an Enterprise مراجعه کنید.

{
  "kind": "androidenterprise#enterprise",
  "id": string,
  "primaryDomain": string,
  "name": string,
  "administrator": [
    {
      "email": string
    }
  ]
}

نام ملک	ارزش	شرح
`administrator[]`	`list`	مدیران شرکت. این فقط برای شرکت هایی که از طریق جریان آغاز شده توسط EMM ایجاد شده اند پشتیبانی می شود.
`administrator[]. email`	`string`	آدرس ایمیل مدیر.
`id`	`string`	شناسه منحصر به فرد برای شرکت
`kind`	`string`
`name`	`string`	نام شرکت، به عنوان مثال، "Example, Inc".
`primaryDomain`	`string`	دامنه اصلی شرکت، مانند "example.com".

مواد و روش ها

acknowledgeNotificationSet: اعلان‌های دریافت‌شده از Enterprises را تأیید می‌کند. PullNotificationSet برای جلوگیری از برگشت تماس‌های بعدی همان اعلان‌ها.
تکمیل ثبت نام: با مشخص کردن نشانه تکمیل و توکن Enterprise، جریان ثبت نام را تکمیل می کند. این درخواست نباید چندین بار برای یک توکن Enterprise معین فراخوانی شود.
ایجاد وب توکن: یک توکن منحصر به فرد برای دسترسی به یک رابط کاربری قابل جاسازی را برمی گرداند. برای ایجاد رابط کاربری وب، رمز تولید شده را به API جاوا اسکریپت مدیریت شده Google Play منتقل کنید. هر نشانه فقط برای شروع یک جلسه رابط کاربری قابل استفاده است. برای اطلاعات بیشتر به اسناد JavaScript API مراجعه کنید.
ثبت نام کنید: شرکتی را با EMM فراخوان ثبت‌نام می‌کند.
ایجاد SignupUrl: URL ثبت نام را ایجاد می کند.
گرفتن: نام و دامنه یک شرکت را بازیابی می کند.
getServiceAccount: حساب سرویس و اعتبارنامه را برمی گرداند. حساب سرویس را می توان با تماس با setAccount به شرکت متصل کرد. حساب سرویس برای این شرکت و EMM منحصر به فرد است و در صورت عدم محدودیت شرکت حذف خواهد شد. اعتبارنامه ها حاوی داده های کلید خصوصی هستند و در سمت سرور ذخیره نمی شوند.

این روش فقط پس از فراخوانی Enterprises.Enroll یا Enterprises.CompleteSignup و قبل از Enterprises.SetAccount قابل فراخوانی است. در مواقع دیگر یک خطا برمی‌گرداند.

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

هنگامی که حساب سرویس به شرکت متصل شد، می توان آن را با استفاده از منبع serviceAccountKeys مدیریت کرد.
getStoreLayout: طرح‌بندی فروشگاه را برای شرکت برمی‌گرداند. اگر چیدمان فروشگاه تنظیم نشده باشد، «پایه» را به عنوان نوع طرح‌بندی فروشگاه برمی‌گرداند و صفحه اصلی ندارد.
فهرست: یک شرکت را با نام دامنه جستجو می کند. این فقط برای شرکت هایی که از طریق جریان ایجاد ایجاد شده توسط Google ایجاد شده اند پشتیبانی می شود. جستجوی شناسه برای شرکت‌هایی که از طریق جریان شروع شده توسط EMM ایجاد می‌شوند، مورد نیاز نیست، زیرا EMM شناسه سازمانی را در تماس برگشتی مشخص‌شده در فراخوان Enterprises.generateSignupUrl می‌آموزد.
pullNotificationSet: مجموعه ای از اعلان را برای شرکت های مرتبط با حساب سرویس تأیید شده برای درخواست دریافت می کند و برمی گرداند. ممکن است مجموعه اعلان‌ها خالی باشد اگر هیچ اعلانی در انتظار نباشد.
یک مجموعه اعلان برگشتی باید ظرف 20 ثانیه با تماس با Enterprises تأیید شود.AcknowledgeNotificationSet، مگر اینکه مجموعه اعلان خالی باشد.
اعلان‌هایی که ظرف 20 ثانیه تأیید نشوند، در نهایت دوباره در پاسخ به درخواست PullNotificationSet دیگر گنجانده می‌شوند و آنهایی که هرگز تأیید نشدند، در نهایت طبق خط‌مشی Google Cloud Platform Pub/Sub سیستم حذف خواهند شد.
ممکن است چندین درخواست به طور همزمان برای بازیابی اعلان‌ها انجام شود، در این صورت، اعلان‌های معلق (در صورت وجود) بین هر تماس‌گیرنده تقسیم می‌شوند، در صورت تعلیق.
اگر هیچ اعلانی وجود نداشته باشد، یک لیست اعلان خالی برگردانده می شود. درخواست‌های بعدی ممکن است پس از دردسترس شدن، اعلان‌های بیشتری را برگردانند.
sendTestPushNotification: یک اعلان آزمایشی برای تأیید اعتبار ادغام EMM با سرویس Google Cloud Pub/Sub برای این شرکت ارسال می‌کند.
setAccount: حسابی را که برای احراز هویت در API به عنوان شرکت مورد استفاده قرار می گیرد، تنظیم می کند.
setStoreLayout: طرح فروشگاه را برای شرکت تنظیم می کند. به طور پیش فرض، storeLayoutType روی "basic" تنظیم شده است و طرح بندی فروشگاه اصلی فعال است. طرح اولیه فقط شامل برنامه هایی است که توسط سرپرست تأیید شده اند و به مجموعه محصول موجود برای یک کاربر اضافه شده اند (با استفاده از تماس setAvailableProductSet ). برنامه های موجود در صفحه به ترتیب ارزش شناسه محصولشان مرتب شده اند. اگر یک طرح‌بندی فروشگاه سفارشی ایجاد کنید (با تنظیم storeLayoutType = "سفارشی" و تنظیم یک صفحه اصلی)، طرح‌بندی فروشگاه اصلی غیرفعال می‌شود.
لغو ثبت نام: ثبت نام یک شرکت را از EMM فراخوان لغو می کند.