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
    }
  ]
}

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

วิธีการ

acknowledgeNotificationSet

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

completeSignup

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

createWebToken

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

ลงทะเบียน

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

generateSignupUrl

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

รับ

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

getServiceAccount

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

คุณจะเรียกใช้เมธอดนี้ได้หลังจากที่เรียกใช้ Enterprises.Enrollment หรือ Enterprises.CompleteSubscription และก่อน Enterprises.SetAccount เท่านั้น ไม่เช่นนั้นระบบจะแสดงข้อผิดพลาด

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

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

getStoreLayout

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

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

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

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