Enterprises

ดูรายการเมธอดสำหรับทรัพยากรนี้ได้ที่ส่วนท้ายของหน้านี้

การนำเสนอแหล่งข้อมูล

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

• สำหรับลูกค้าโดเมนที่จัดการโดย Google กระบวนการนี้จะต้องใช้ Enterprises.enroll และ Enterprises.setAccount (ร่วมกับอาร์ติแฟกต์ที่ได้รับจากคอนโซลผู้ดูแลระบบและคอนโซล Google API) และส่งให้กับ EMM ผ่านกระบวนการที่สามารถทำได้ด้วยตนเองมากกว่าหรือน้อยกว่า
• สำหรับลูกค้าบัญชี Managed 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
    }
  ]
}

ชื่อพร็อพเพอร์ตี้	ค่า	คำอธิบาย	หมายเหตุ
administrator[]	list	ผู้ดูแลระบบขององค์กร ตัวเลือกนี้รองรับเฉพาะองค์กรที่สร้างผ่านขั้นตอนที่เริ่มต้นโดย EMM เท่านั้น
administrator[].email	string	อีเมลของผู้ดูแลระบบ
id	string	รหัสที่ไม่ซ้ำกันสำหรับองค์กร
kind	string
name	string	ชื่อองค์กร เช่น "Example, Inc"
primaryDomain	string	โดเมนหลักขององค์กร เช่น "example.com"

เมธอด

acknowledgeNotificationSet

รับทราบการแจ้งเตือนที่ได้รับจาก Enterprises.PullNotificationSet เพื่อป้องกันไม่ให้สายที่โทรเข้ามาส่งกลับ การแจ้งเตือนเดียวกัน

completeSignup

เสร็จสิ้นขั้นตอนการลงชื่อสมัครใช้ด้วยการระบุโทเค็นการสรุปและ โทเค็น Enterprise ต้องไม่มีการเรียกคำขอนี้หลายครั้งสำหรับ Enterprise ที่ระบุ โทเค็น

createWebToken

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

ลงทะเบียน

ลงทะเบียนองค์กรด้วย EMM การโทร

generateSignupUrl

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

รับ

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

getServiceAccount

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

วิธีการนี้จะเรียกใช้ได้หลังจากการเรียกใช้แล้วเท่านั้น Enterprises.enroll หรือ Enterprises.Completeลงชื่อสมัครใช้ และเข้าร่วมก่อน Enterprises.SetAccount; ในบางครั้ง จะทำให้ระบบแสดงผลข้อผิดพลาด

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

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

getStoreLayout

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

list

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

pullNotificationSet

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

sendTestPushNotification

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

setAccount

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

setStoreLayout

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

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

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