Enterprises

ดูรายการวิธีการสําหรับแหล่งข้อมูลนี้ได้ที่ท้ายหน้า

การนําเสนอทรัพยากร

ทรัพยากรขององค์กรแสดงการเชื่อมโยงระหว่าง EMM กับองค์กรหนึ่งๆ การเชื่อมโยงดังกล่าวสามารถสร้างอินสแตนซ์ได้ 2 วิธีโดยใช้ API นี้ ดังนี้

• สำหรับลูกค้าโดเมนที่ Google จัดการ กระบวนการนี้เกี่ยวข้องกับการใช้ Enterprises.enroll และ Enterprises.setAccount (ร่วมกับรายการต่างๆ ที่ได้มาจากคอนโซลผู้ดูแลระบบและคอนโซล Google API) และส่งไปยัง EMM ผ่านกระบวนการที่ต้องทำด้วยตนเอง
• สำหรับลูกค้าบัญชี Google Play ที่มีการจัดการ กระบวนการนี้เกี่ยวข้องกับการใช้ Enterprises.generateSignupUrl และ Enterprises.completeSignup ร่วมกับ UI การสมัครใช้บริการ Managed Google Play (กลไกที่ Google มีให้) เพื่อสร้างการเชื่อมโยงโดยไม่ต้องทำตามขั้นตอนด้วยตนเอง

ในฐานะ EMM คุณสามารถรองรับแนวทางใดแนวทางหนึ่งหรือทั้ง 2 แนวทางในคอนโซล EMM ดูรายละเอียดได้ที่สร้างองค์กร

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

ชื่อพร็อพเพอร์ตี้	ค่า	คำอธิบาย	หมายเหตุ
administrator[]	list	ผู้ดูแลระบบขององค์กร การดำเนินการนี้ใช้ได้กับองค์กรที่สร้างผ่านขั้นตอนที่เริ่มต้นโดย EMM เท่านั้น
administrator[].email	string	อีเมลของผู้ดูแลระบบ
enterpriseType	string	ประเภทขององค์กร ค่าที่ยอมรับมีดังนี้ "enterpriseTypeUnspecified" "managedGoogleDomain" "managedGooglePlayAccountsEnterprise"
id	string	รหัสที่ไม่ซ้ำกันสำหรับองค์กร
kind	string
managedGoogleDomainType	string	ประเภทของโดเมน Google ที่มีการจัดการ ค่าที่ยอมรับได้มีดังนี้ "managedGoogleDomainTypeUnspecified" "typeDomain" "typeTeam"
name	string	ชื่อองค์กร เช่น "Example, Inc"
primaryDomain	string	โดเมนหลักขององค์กร เช่น "example.com"

เมธอด

acknowledgeNotificationSet

รับทราบการแจ้งเตือนที่ได้รับจาก Enterprise.PullNotificationSet เพื่อป้องกันไม่ให้การเรียกใช้ครั้งต่อๆ ไปแสดงการแจ้งเตือนเดิม

completeSignup

ทําตามขั้นตอนการลงชื่อสมัครใช้ให้เสร็จสมบูรณ์โดยระบุโทเค็นการเสร็จสมบูรณ์และโทเค็นองค์กร ต้องไม่เรียกคําขอนี้หลายครั้งสําหรับ Enterprise Token หนึ่งๆ

createWebToken

แสดงผลโทเค็นที่ไม่ซ้ำกันเพื่อเข้าถึง UI ที่ฝังได้ หากต้องการสร้าง UI ของเว็บ ให้ส่งโทเค็นที่สร้างขึ้นไปยัง JavaScript API ของ Managed Google Play โทเค็นแต่ละรายการจะใช้เพื่อเริ่มเซสชัน UI ได้เพียงเซสชันเดียวเท่านั้น ดูข้อมูลเพิ่มเติมได้ใน เอกสารประกอบ JavaScript API

enroll

ลงทะเบียนองค์กรกับ EMM ที่โทรเข้ามา

generateSignupUrl

สร้าง URL การลงชื่อสมัครใช้

get

ดึงข้อมูลชื่อและโดเมนขององค์กร

getServiceAccount

แสดงบัญชีบริการและข้อมูลเข้าสู่ระบบ บัญชีบริการจะเชื่อมโยงกับองค์กรได้โดยเรียกใช้ setAccount บัญชีบริการจะสร้างขึ้นสำหรับองค์กรและ EMM นี้เท่านั้น และจะลบออกหากองค์กรไม่ได้เชื่อมโยง ข้อมูลเข้าสู่ระบบมีข้อมูลคีย์ส่วนตัวและจะไม่จัดเก็บไว้ฝั่งเซิร์ฟเวอร์

เมธอดนี้จะเรียกใช้ได้หลังจากเรียกใช้ Methods.Enroll หรือ Methods.CompleteSignup และก่อนเรียกใช้ Methods.SetAccount เท่านั้น ไม่เช่นนั้นระบบจะแสดงข้อผิดพลาด

การเรียกใช้ครั้งต่อๆ ไปหลังจากครั้งแรกจะสร้างชุดข้อมูลเข้าสู่ระบบใหม่ที่ไม่ซ้ำกันและทำให้ข้อมูลเข้าสู่ระบบที่สร้างขึ้นก่อนหน้านี้ใช้งานไม่ได้

เมื่อเชื่อมโยงบัญชีบริการกับองค์กรแล้ว คุณจะจัดการบัญชีบริการได้โดยใช้ทรัพยากร serviceAccountKeys

getStoreLayout

แสดงเลย์เอาต์ร้านค้าสำหรับองค์กร หากไม่ได้ตั้งค่าเลย์เอาต์ร้านค้า ระบบจะแสดง "พื้นฐาน" เป็นประเภทเลย์เอาต์ร้านค้าและไม่มีหน้าแรก

list

ค้นหาองค์กรตามชื่อโดเมน การดำเนินการนี้ใช้ได้กับองค์กรที่สร้างผ่านขั้นตอนการสร้างที่ Google เป็นผู้เริ่มเท่านั้น ไม่จำเป็นต้องค้นหารหัสสำหรับองค์กรที่สร้างผ่านขั้นตอนที่เริ่มต้นโดย EMM เนื่องจาก EMM จะเรียนรู้รหัสองค์กรในการเรียกกลับที่ระบุในการเรียกใช้ Enterprises.generateSignupUrl

pullNotificationSet

ดึงข้อมูลและแสดงการแจ้งเตือนที่ตั้งค่าไว้สำหรับองค์กรที่เชื่อมโยงกับบัญชีบริการที่ตรวจสอบสิทธิ์สำหรับคำขอ ชุดการแจ้งเตือนอาจว่างเปล่าหากไม่มีการแจ้งเตือนที่รอดำเนินการ
ชุดการแจ้งเตือนที่แสดงผลต้องได้รับการรับทราบภายใน 20 วินาทีโดยเรียกใช้ Enterprises.AcknowledgeNotificationSet เว้นแต่ว่าชุดการแจ้งเตือนจะว่างเปล่า
การแจ้งเตือนที่ไม่มีการตอบกลับภายใน 20 วินาทีจะรวมอยู่ในคำตอบของคำขอ PullNotificationSet รายการอื่นในท้ายที่สุด และระบบจะลบการแจ้งเตือนที่ไม่มีการตอบกลับเลยในท้ายที่สุดตามนโยบายระบบ Pub/Sub ของ Google Cloud Platform
ระบบอาจดำเนินการตามคำขอหลายรายการพร้อมกันเพื่อดึงข้อมูลการแจ้งเตือน ซึ่งในกรณีนี้ การแจ้งเตือนที่รอดำเนินการ (หากมี) จะแยกไปยังผู้เรียกแต่ละราย หากมี
หากไม่มีการแจ้งเตือน ระบบจะแสดงรายการการแจ้งเตือนที่ว่างเปล่า คำขอที่ตามมาอาจแสดงการแจ้งเตือนเพิ่มเติมเมื่อพร้อมใช้งาน

sendTestPushNotification

ส่งการแจ้งเตือนทดสอบเพื่อตรวจสอบการผสานรวม EMM กับบริการ Google Cloud Pub/Sub สําหรับองค์กรนี้

setAccount

ตั้งค่าบัญชีที่จะใช้ตรวจสอบสิทธิ์กับ API เป็นองค์กร

setStoreLayout

กำหนดเลย์เอาต์ร้านค้าสำหรับองค์กร โดยค่าเริ่มต้น ระบบจะตั้งค่า storeLayoutType เป็น "basic" และเปิดใช้เลย์เอาต์ร้านค้าพื้นฐาน เลย์เอาต์พื้นฐานจะมีเฉพาะแอปที่ผู้ดูแลระบบอนุมัติและเพิ่มลงในชุดผลิตภัณฑ์ที่พร้อมให้บริการสำหรับผู้ใช้ (โดยใช้การเรียกใช้ setAvailableProductSet) แอปในหน้าจะจัดเรียงตามค่ารหัสผลิตภัณฑ์ หากคุณสร้างเลย์เอาต์ร้านค้าที่กำหนดเอง (โดยการตั้งค่า storeLayoutType = "custom" และการตั้งค่าหน้าแรก) ระบบจะปิดใช้เลย์เอาต์ร้านค้าพื้นฐาน

ยกเลิกการลงทะเบียน

ยกเลิกการลงทะเบียนองค์กรจาก EMM ที่โทรเข้ามา