REST Resource: enterprises

แหล่งข้อมูล: องค์กร

ใช้การกำหนดค่ากับองค์กรแล้ว

การแสดง JSON 
{
  "name": string,
  "enabledNotificationTypes": [
    enum (NotificationType)
  ],
  "pubsubTopic": string,
  "primaryColor": integer,
  "logo": {
    object (ExternalData)
  },
  "enterpriseDisplayName": string,
  "termsAndConditions": [
    {
      object (TermsAndConditions)
    }
  ],
  "appAutoApprovalEnabled": boolean,
  "signinDetails": [
    {
      object (SigninDetail)
    }
  ],
  "contactInfo": {
    object (ContactInfo)
  }
}
ช่อง
name

string

ชื่อขององค์กรที่เซิร์ฟเวอร์สร้างขึ้นระหว่างการสร้างในรูปแบบ enterprises/{enterpriseId}
enabledNotificationTypes[]

enum (NotificationType)

ประเภทการแจ้งเตือน Google Pub/Sub ที่เปิดใช้สำหรับองค์กร
pubsubTopic

string

หัวข้อที่เผยแพร่การแจ้งเตือน Pub/Sub ในรูปแบบ projects/{project}/topics/{topic} ช่องนี้จำเป็นต้องระบุเมื่อเปิดใช้การแจ้งเตือน Pub/Sub เท่านั้น
primaryColor

integer

สีในรูปแบบ RGB ที่แสดงถึงสีหลักที่จะแสดงใน UI ของแอปการจัดการอุปกรณ์ คอมโพเนนต์สีจะจัดเก็บดังนี้ (red << 16) | (green << 8) | blue โดยที่ค่าของแต่ละคอมโพเนนต์อยู่ระหว่าง 0 ถึง 255
enterpriseDisplayName

string

ชื่อขององค์กรที่แสดงต่อผู้ใช้ ช่องนี้มีความยาวสูงสุด 100 อักขระ
termsAndConditions[]

object (TermsAndConditions)

ข้อกำหนดและเงื่อนไขที่ต้องยอมรับเมื่อจัดสรรอุปกรณ์สำหรับองค์กรนี้ ระบบจะสร้างหน้าของคำศัพท์สำหรับแต่ละค่าในรายการนี้
appAutoApprovalEnabled
(deprecated)

boolean

เลิกใช้งานและไม่ได้ใช้
signinDetails[]

object (SigninDetail)

รายละเอียดการลงชื่อเข้าใช้ขององค์กร
contactInfo

object (ContactInfo)

ข้อมูลติดต่อขององค์กรที่ EMM จัดการ

NotificationType

ประเภทการแจ้งเตือนที่เซิร์ฟเวอร์การจัดการอุปกรณ์อาจส่งผ่าน Google Pub/Sub

Enum
NOTIFICATION_TYPE_UNSPECIFIED ระบบจะละเว้นค่านี้
ENROLLMENT การแจ้งเตือนที่ส่งเมื่ออุปกรณ์ลงทะเบียน
COMPLIANCE_REPORT

เลิกใช้งานแล้ว
STATUS_REPORT การแจ้งเตือนที่ส่งเมื่ออุปกรณ์ออกรายงานสถานะ
COMMAND การแจ้งเตือนที่ส่งเมื่อคำสั่งของอุปกรณ์เสร็จสมบูรณ์
USAGE_LOGS ระบบจะส่งการแจ้งเตือนเมื่ออุปกรณ์ส่ง BatchUsageLogEvents

ExternalData

ข้อมูลที่โฮสต์ในสถานที่ภายนอก ข้อมูลนี้จะดาวน์โหลดโดย Android Device Policy และยืนยันกับแฮช

การแสดง JSON 
{
  "url": string,
  "sha256Hash": string
}
ช่อง
url

string

URL ที่สมบูรณ์ไปยังข้อมูล ซึ่งต้องใช้รูปแบบ http หรือ https Android Device Policy ไม่ได้ระบุข้อมูลเข้าสู่ระบบใดๆ ในคำขอ GET ดังนั้น URL ดังกล่าวต้องเข้าถึงได้แบบสาธารณะ อาจมีการใช้คอมโพเนนต์แบบสุ่มขนาดยาวลงใน URL เพื่อป้องกันไม่ให้ผู้โจมตีค้นพบ URL ดังกล่าวได้
sha256Hash

string

แฮช SHA-256 ที่เข้ารหัสฐาน 64 ของเนื้อหาที่โฮสต์ที่ URL หากเนื้อหาไม่ตรงกับแฮชนี้ Android Device Policy จะไม่ใช้ข้อมูลดังกล่าว

TermsAndConditions

หน้าข้อกำหนดและเงื่อนไขที่จะยอมรับในระหว่างการจัดสรร

การแสดง JSON 
{
  "header": {
    object (UserFacingMessage)
  },
  "content": {
    object (UserFacingMessage)
  }
}
ช่อง
header

object (UserFacingMessage)

ส่วนหัวสั้นๆ ที่ปรากฏเหนือเนื้อหา HTML
content

object (UserFacingMessage)

สตริง HTML ที่มีการจัดรูปแบบที่ดี ซึ่งจะแยกวิเคราะห์บนไคลเอ็นต์ด้วย android.text.Html#fromHtml

SigninDetail

ทรัพยากรที่มีรายละเอียดการลงชื่อเข้าใช้ขององค์กร ใช้ enterprises เพื่อจัดการ SigninDetail สำหรับองค์กรที่ระบุ

สำหรับองค์กร เราจะมี SigninDetail กี่รายการก็ได้ที่ระบุโดยไม่ซ้ำกันด้วยชุดค่าผสมของช่อง 3 ช่องต่อไปนี้ (signinUrl, allowPersonalUsage, tokenTag) ค่า 1 ไม่สามารถสร้าง SigninDetail 2 รายการที่มีค่าเดียวกัน (signinUrl, allowPersonalUsage, tokenTag) (tokenTag เป็นช่องที่ไม่บังคับ)

Patch: การดำเนินการจะอัปเดตรายการปัจจุบันของ SigninDetails ด้วยรายการใหม่ของ SigninDetails

  • หากผ่านการกำหนดค่า SigninDetail ที่จัดเก็บไว้ ระบบจะแสดงผล signinEnrollmentToken และ qrCode เดียวกัน
  • หากเราผ่านการกำหนดค่า SigninDetail ที่เหมือนกันหลายรายการซึ่งไม่ได้จัดเก็บไว้ จะจัดเก็บการกำหนดค่าแรกไว้ในการกำหนดค่า SigninDetail ดังกล่าว
  • หากมีการกำหนดค่าอยู่แล้ว เราจะไม่สามารถขอมากกว่า 1 ครั้งในการเรียก API แพตช์หนึ่งๆ ได้ ไม่เช่นนั้นอาจทำให้เกิดข้อผิดพลาดเกี่ยวกับคีย์ซ้ำและการดำเนินการทั้งหมดจะล้มเหลว
  • หากเรานำการกำหนดค่าบางอย่างของ SigninDetail ออกจากคำขอ ระบบจะนำการกำหนดค่าดังกล่าวออกจากพื้นที่เก็บข้อมูล จากนั้นเราจะขอ signinEnrollmentToken และ qrCode อีกรายการสําหรับการกําหนดค่า SigninDetail เดียวกัน
การแสดง JSON 
{
  "signinUrl": string,
  "signinEnrollmentToken": string,
  "qrCode": string,
  "allowPersonalUsage": enum (AllowPersonalUsage),
  "tokenTag": string
}
ช่อง
signinUrl

string

URL การลงชื่อเข้าใช้สำหรับการตรวจสอบสิทธิ์เมื่อมีการจัดสรรอุปกรณ์ด้วยโทเค็นการลงทะเบียนการลงชื่อเข้าใช้ ปลายทางการลงชื่อเข้าใช้ควรเสร็จสิ้นขั้นตอนการตรวจสอบสิทธิ์ด้วย URL ในรูปแบบ https://enterprise.google.com/android/enroll?et= เพื่อให้เข้าสู่ระบบได้สำเร็จ หรือ https://enterprise.google.com/android/enroll/invalid สำหรับการเข้าสู่ระบบไม่สำเร็จ
signinEnrollmentToken

string

โทเค็นการลงทะเบียนทั่วทั้งองค์กรซึ่งใช้เพื่อทริกเกอร์ขั้นตอนการลงชื่อเข้าใช้ที่กำหนดเอง นี่คือฟิลด์แบบอ่านอย่างเดียวที่เซิร์ฟเวอร์สร้างขึ้น
qrCode

string

สตริง JSON ที่ใช้การแทนค่า UTF-8 เพื่อสร้างคิวอาร์โค้ดเพื่อลงทะเบียนอุปกรณ์ด้วยโทเค็นการลงทะเบียนนี้ได้ หากต้องการลงทะเบียนอุปกรณ์โดยใช้ NFC ระเบียน NFC ต้องมีการนำเสนอพร็อพเพอร์ตี้ java.util.Properties แบบอนุกรมใน JSON นี่คือฟิลด์แบบอ่านอย่างเดียวที่เซิร์ฟเวอร์สร้างขึ้น
allowPersonalUsage

enum (AllowPersonalUsage)

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

สำหรับอุปกรณ์ของบริษัท

  • การเปิดใช้การใช้งานส่วนตัวจะทำให้ผู้ใช้ตั้งค่าโปรไฟล์งานในอุปกรณ์ได้
  • การปิดใช้การใช้งานส่วนตัวกำหนดให้ผู้ใช้จัดสรรอุปกรณ์เป็นอุปกรณ์ที่มีการจัดการครบวงจร

สำหรับอุปกรณ์ที่ใช้ส่วนตัว

  • การเปิดใช้การใช้งานส่วนตัวจะทำให้ผู้ใช้ตั้งค่าโปรไฟล์งานในอุปกรณ์ได้
  • การปิดใช้การใช้งานส่วนตัวจะทำให้อุปกรณ์ไม่สามารถจัดสรรได้ ปิดใช้การใช้งานส่วนตัวในอุปกรณ์ส่วนตัวไม่ได้
tokenTag

string

ข้อมูลเมตาที่ EMM ระบุเพื่อแยกความแตกต่างระหว่างอินสแตนซ์ของ SigninDetail

ContactInfo

รายละเอียดการติดต่อขององค์กร Managed Google Play

การแสดง JSON 
{
  "contactEmail": string,
  "dataProtectionOfficerName": string,
  "dataProtectionOfficerEmail": string,
  "dataProtectionOfficerPhone": string,
  "euRepresentativeName": string,
  "euRepresentativeEmail": string,
  "euRepresentativePhone": string
}
ช่อง
contactEmail

string

อีเมลของผู้ติดต่อ ซึ่งจะใช้เพื่อส่งประกาศสำคัญเกี่ยวกับ Managed Google Play
dataProtectionOfficerName

string

ชื่อของเจ้าหน้าที่คุ้มครองข้อมูล
dataProtectionOfficerEmail

string

อีเมลของเจ้าหน้าที่คุ้มครองข้อมูล อีเมลได้รับการตรวจสอบแล้ว แต่ยังไม่ได้รับการยืนยัน
dataProtectionOfficerPhone

string

หมายเลขโทรศัพท์ของเจ้าหน้าที่ปกป้องข้อมูล หมายเลขโทรศัพท์ได้รับการตรวจสอบแล้วแต่ยังไม่ได้รับการยืนยัน
euRepresentativeName

string

ชื่อของตัวแทนสหภาพยุโรป
euRepresentativeEmail

string

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

string

หมายเลขโทรศัพท์ของตัวแทนสหภาพยุโรป หมายเลขโทรศัพท์ได้รับการตรวจสอบแล้วแต่ยังไม่ได้รับการยืนยัน

วิธีการ

create

 สร้างองค์กร

delete

 ลบองค์กร รวมถึงบัญชีและข้อมูลทั้งหมดที่เชื่อมโยงกับองค์กรอย่างถาวร

get

 รับองค์กร

list

 แสดงรายการองค์กรที่จัดการโดย EMM

patch

 อัปเดตองค์กร