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 فراخوان لغو می کند.