REST Resource: enterprises

ทรัพยากร: Enterprise

การกำหนดค่าที่ใช้กับองค์กร

การแสดง 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)
  },
  "googleAuthenticationSettings": {
    object (GoogleAuthenticationSettings)
  }
}
ช่อง
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
googleAuthenticationSettings

object (GoogleAuthenticationSettings)

การตั้งค่าการตรวจสอบสิทธิ์ผู้ใช้ที่ Google เป็นผู้จัดหา

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) และไม่สามารถสร้าง 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),
  "defaultStatus": enum (SigninDetailDefaultStatus),
  "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)

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

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

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

สำหรับอุปกรณ์ส่วนตัว

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

enum (SigninDetailDefaultStatus)

ไม่บังคับ กำหนดว่าควรใช้ URL การลงชื่อเข้าใช้โดยค่าเริ่มต้นสำหรับองค์กรหรือไม่ SigninDetail ที่มีการตั้งค่า defaultStatus เป็น SIGNIN_DETAIL_IS_DEFAULT ใช้สำหรับวิธีการลงทะเบียนบัญชี Google signinDetails ขององค์กรจะมีdefaultStatusเป็นSIGNIN_DETAIL_IS_DEFAULTได้เพียงรายการเดียว หาก Enterprise มี signinDetails อย่างน้อย 1 รายการ และไม่มีการตั้งค่า defaultStatus ที่ตั้งค่าเป็น SIGNIN_DETAIL_IS_DEFAULT ระบบจะเลือกอันแรกจากรายการและตั้งค่า defaultStatus เป็น SIGNIN_DETAIL_IS_DEFAULT หากไม่ได้ระบุ signinDetails สําหรับ Enterprise จะลงทะเบียนอุปกรณ์บัญชี Google ไม่สำเร็จ
tokenTag

string

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

SigninDetailDefaultStatus

กำหนดว่าควรใช้ URL การลงชื่อเข้าใช้โดยค่าเริ่มต้นสำหรับองค์กรหรือไม่

Enum
SIGNIN_DETAIL_DEFAULT_STATUS_UNSPECIFIED เทียบเท่ากับ SIGNIN_DETAIL_IS_NOT_DEFAULT
SIGNIN_DETAIL_IS_DEFAULT ระบบจะใช้ URL การลงชื่อเข้าใช้สำหรับองค์กรโดยค่าเริ่มต้น
SIGNIN_DETAIL_IS_NOT_DEFAULT ระบบจะไม่ใช้ URL การลงชื่อเข้าใช้กับองค์กรโดยค่าเริ่มต้น

ContactInfo

รายละเอียดรายชื่อติดต่อสำหรับองค์กร Managed Google Play

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

string

อีเมลสำหรับเจ้าหน้าที่ติดต่อ ซึ่งจะใช้ส่งประกาศสำคัญเกี่ยวกับ Google Play ที่มีการจัดการ
dataProtectionOfficerName

string

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

string

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

string

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

string

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

string

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

string

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

GoogleAuthenticationSettings

มีการตั้งค่าการตรวจสอบสิทธิ์ผู้ใช้ที่ Google เป็นผู้จัดหา

การแสดง JSON 
{
  "googleAuthenticationRequired": enum (GoogleAuthenticationRequired)
}
ช่อง
googleAuthenticationRequired

enum (GoogleAuthenticationRequired)

เอาต์พุตเท่านั้น ผู้ใช้ต้องได้รับการตรวจสอบสิทธิ์โดย Google ในระหว่างขั้นตอนการลงทะเบียนหรือไม่ ผู้ดูแลระบบไอทีระบุได้ว่าจะเปิดใช้การตรวจสอบสิทธิ์ Google สำหรับองค์กรสำหรับอุปกรณ์ของผู้ปฏิบัติงานโดยใช้ความรู้หรือไม่ ค่านี้ตั้งค่าได้ผ่านคอนโซลผู้ดูแลระบบของ Google เท่านั้น การตรวจสอบสิทธิ์ของ Google ใช้ได้กับ signinUrl ในกรณีที่ต้องมีการตรวจสอบสิทธิ์ของ Google และระบุ signinUrl ระบบจะเปิดการตรวจสอบสิทธิ์ของ Google ก่อน signinUrl

GoogleAuthenticationRequired

การตั้งค่าว่าต้องการตรวจสอบสิทธิ์ผ่าน Google สำหรับองค์กรนี้หรือไม่

Enum
GOOGLE_AUTHENTICATION_REQUIRED_UNSPECIFIED ไม่มีการใช้ค่านี้
NOT_REQUIRED โดยไม่จำเป็นต้องมีการตรวจสอบสิทธิ์ของ Google
REQUIRED Google กำหนดให้ผู้ใช้ต้องผ่านการตรวจสอบสิทธิ์ได้สำเร็จ

เมธอด

create

 สร้างองค์กร

delete

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

get

 รับองค์กร

list

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

patch

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