Enterprises

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

การแสดงทรัพยากร

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

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

{
  "kind": "androidenterprise#enterprise",
  "id": string,
  "primaryDomain": string,
  "name": string,
  "administrator": [
    {
      "email": string
    }
  ],
  "googleAuthenticationSettings": {
    "googleAuthenticationRequired": string,
    "dedicatedDevicesAllowed": string,
    "createdAt": {
      "seconds": long,
      "nanos": integer
    },
    "updatedAt": {
      "seconds": long,
      "nanos": integer
    }
  },
  "enterpriseType": string,
  "managedGoogleDomainType": string
}
ชื่อพร็อพเพอร์ตี้ ค่า คำอธิบาย หมายเหตุ
administrator[] list ผู้ดูแลระบบขององค์กร ฟีเจอร์นี้รองรับเฉพาะองค์กรที่สร้างผ่านโฟลว์ที่ EMM เริ่มต้นเท่านั้น

administrator[].email string อีเมลของผู้ดูแลระบบ
enterpriseType string ประเภทขององค์กร

ค่าที่ยอมรับมีดังนี้
  • "enterpriseTypeUnspecified"
  • "managedGoogleDomain"
  • "managedGooglePlayAccountsEnterprise"
googleAuthenticationSettings nested object การตั้งค่าสำหรับการตรวจสอบสิทธิ์ผู้ใช้ที่ Google จัดให้
googleAuthenticationSettings.createdAt nested object การประทับเวลาของเวลาที่สร้างหรือแก้ไขการตั้งค่าเป็นครั้งแรก
googleAuthenticationSettings.createdAt.nanos integer เศษส่วนของวินาทีที่ไม่เป็นลบที่ความละเอียดระดับนาโนวินาที ค่าวินาทีที่เป็นลบซึ่งมีเศษส่วนยังคงต้องมีค่านาโนที่เป็นค่าบวกซึ่งนับไปข้างหน้าตามเวลา ต้องอยู่ระหว่าง 0 ถึง 999,999,999 เท่านั้น
googleAuthenticationSettings.createdAt.seconds long แสดงวินาทีของเวลา UTC ตั้งแต่ Epoch ของ Unix 1970-01-01T00:00:00Z ต้องอยู่ระหว่าง 0001-01-01T00:00:00Z ถึง 9999-12-31T23:59:59Z
googleAuthenticationSettings.dedicatedDevicesAllowed string อนุญาตให้อุปกรณ์เฉพาะใช้งานได้หรือไม่

ค่าที่ยอมรับมีดังนี้
  • "allowed"
  • "dedicatedDevicesAllowedUnspecified"
  • "disallowed"
googleAuthenticationSettings.googleAuthenticationRequired string ต้องมีการตรวจสอบสิทธิ์ของ Google หรือไม่

ค่าที่ยอมรับมีดังนี้
  • "googleAuthenticationRequiredUnspecified"
  • "notRequired"
  • "required"
googleAuthenticationSettings.updatedAt nested object การประทับเวลาที่มีการแก้ไขการตั้งค่าครั้งล่าสุด
googleAuthenticationSettings.updatedAt.nanos integer เศษส่วนของวินาทีที่ไม่เป็นลบที่ความละเอียดระดับนาโนวินาที ค่าวินาทีที่เป็นลบซึ่งมีเศษส่วนยังคงต้องมีค่านาโนที่เป็นค่าบวกซึ่งนับไปข้างหน้าตามเวลา ต้องอยู่ระหว่าง 0 ถึง 999,999,999 เท่านั้น
googleAuthenticationSettings.updatedAt.seconds long แสดงวินาทีของเวลา UTC ตั้งแต่ Epoch ของ Unix 1970-01-01T00:00:00Z ต้องอยู่ระหว่าง 0001-01-01T00:00:00Z ถึง 9999-12-31T23:59:59Z
id string รหัสที่ไม่ซ้ำกันสำหรับองค์กร

id string รหัสที่ไม่ซ้ำกันสำหรับองค์กร

kind string
managedGoogleDomainType string ประเภทของโดเมน Google ที่มีการจัดการ

ค่าที่ยอมรับได้มีดังนี้
  • "managedGoogleDomainTypeUnspecified"
  • "typeDomain"
  • "typeTeam"
name string ชื่อขององค์กร เช่น "Example, Inc"
primaryDomain string โดเมนหลักขององค์กร เช่น "example.com"

เมธอด

acknowledgeNotificationSet
รับทราบการแจ้งเตือนที่ได้รับจาก Enterprises.PullNotificationSet เพื่อป้องกันไม่ให้การเรียกใช้ครั้งต่อๆ ไปแสดง การแจ้งเตือนเดียวกัน
completeSignup
ทําขั้นตอนการลงชื่อสมัครใช้ให้เสร็จสมบูรณ์โดยระบุโทเค็นการทําให้เสร็จสมบูรณ์และ โทเค็นองค์กร ห้ามเรียกคำขอนี้หลายครั้งสำหรับโทเค็นขององค์กรที่ระบุ
createWebToken
แสดงผลโทเค็นที่ไม่ซ้ำกันเพื่อเข้าถึง UI ที่ฝังได้ หากต้องการสร้าง เว็บ UI ให้ส่งโทเค็นที่สร้างขึ้นไปยัง JavaScript API ของ Managed Google Play โทเค็นแต่ละรายการใช้ได้เพื่อเริ่มเซสชัน UI เพียง 1 เซสชันเท่านั้น ดูข้อมูลเพิ่มเติมได้ที่ เอกสารประกอบเกี่ยวกับ JavaScript API
ลงทะเบียน
ลงทะเบียนองค์กรกับ EMM ที่เรียกใช้
generateEnterpriseUpgradeUrl
สร้าง URL การอัปเกรดองค์กรเพื่ออัปเกรดกลุ่มบัญชี Managed Google Play สำหรับองค์กรที่มีอยู่เป็นโดเมน Google ที่มีการจัดการ ดูรายละเอียดเพิ่มเติมได้ที่ คำแนะนำในการอัปเกรดองค์กร
generateSignupUrl
สร้าง URL สำหรับลงชื่อสมัครใช้
รับ
ดึงชื่อและโดเมนขององค์กร
getServiceAccount
แสดงผลบัญชีบริการและข้อมูลเข้าสู่ระบบ คุณเชื่อมโยงบัญชีบริการ กับองค์กรได้โดยการเรียกใช้ setAccount บัญชีบริการ เป็นบัญชีเฉพาะสำหรับองค์กรและ EMM นี้ และจะถูกลบหากองค์กร ถูกยกเลิกการเชื่อมโยง ข้อมูลเข้าสู่ระบบมีข้อมูลคีย์ส่วนตัวและไม่ได้จัดเก็บไว้ที่ฝั่งเซิร์ฟเวอร์

เมธอดนี้จะเรียกใช้ได้หลังจากเรียกใช้ Enterprises.Enroll หรือ Enterprises.CompleteSignup และก่อนเรียกใช้ Enterprises.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 ที่เรียกใช้