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 ที่โทรอยู่