REST Resource: partners.customers

แหล่งข้อมูล: บริษัท

ตัวแทนจำหน่าย ผู้ให้บริการ หรือลูกค้าในตัวแทนจำหน่ายที่มีการตั้งค่าอุปกรณ์พร้อมใช้แบบรวมกลุ่มและ API ของลูกค้า

การแสดง JSON 
{
  "name": string,
  "companyId": string,
  "companyName": string,
  "ownerEmails": [
    string
  ],
  "adminEmails": [
    string
  ],
  "termsStatus": enum (TermsStatus),
  "skipWelcomeEmail": boolean,
  "languageCode": string,
  "googleWorkspaceAccount": {
    object (GoogleWorkspaceAccount)
  }
}
ช่อง
name

string

เอาต์พุตเท่านั้น ชื่อทรัพยากร API ของบริษัท ชื่อทรัพยากรอยู่ในรูปแบบใดรูปแบบหนึ่งต่อไปนี้

  • partners/[PARTNER_ID]/customers/[CUSTOMER_ID]
  • partners/[PARTNER_ID]/vendors/[VENDOR_ID]
  • partners/[PARTNER_ID]/vendors/[VENDOR_ID]/customers/[CUSTOMER_ID]

เซิร์ฟเวอร์เป็นผู้กำหนด
companyId

string (int64 format)

เอาต์พุตเท่านั้น รหัสของบริษัท เซิร์ฟเวอร์เป็นผู้กำหนด
companyName

string

ต้องระบุ ชื่อบริษัท เช่น XYZ Corp แสดงต่อพนักงานของบริษัทในพอร์ทัลการตั้งค่าอุปกรณ์พร้อมใช้แบบรวมกลุ่ม
ownerEmails[]

string

ต้องระบุ อินพุตเท่านั้น อีเมลของผู้ใช้ในบทบาทเจ้าของ ต้องมี owner_email อย่างน้อย 1 รายการ เจ้าของจะแชร์สิทธิ์เข้าถึงเดียวกับผู้ดูแลระบบ แต่จะเพิ่ม ลบ และแก้ไขผู้ใช้พอร์ทัลขององค์กรได้
adminEmails[]

string

ไม่บังคับ อีเมลของผู้ใช้ในบทบาทผู้ดูแลระบบของลูกค้า อีเมลแต่ละรายการต้องเชื่อมโยงกับบัญชี Google
termsStatus

enum (TermsStatus)

เอาต์พุตเท่านั้น มีผู้ใช้จากบริษัทยอมรับข้อกำหนดในการให้บริการ (ToS) ล่าสุดหรือไม่ ดูTermsStatus
skipWelcomeEmail

boolean

อินพุตเท่านั้น หากตั้งค่าเป็น "จริง" ระบบจะไม่ส่งอีเมลต้อนรับถึงลูกค้า ขอแนะนำให้คุณข้ามอีเมลต้อนรับหากอุปกรณ์จะได้รับการอ้างสิทธิ์ด้วยบริการ DEVICE_PROTECTION เพิ่มเติม เนื่องจากลูกค้าจะได้รับอีเมลแยกต่างหากเมื่อถึงเวลาอ้างสิทธิ์อุปกรณ์ ระบบจะไม่สนใจช่องนี้หากไม่ใช่ลูกค้าที่มีการตั้งค่าอุปกรณ์พร้อมใช้แบบรวมกลุ่ม
languageCode

string

อินพุตเท่านั้น สถานที่ที่ลูกค้าต้องการซึ่งแสดงเป็นรหัสภาษา BCP47 ระบบจะตรวจสอบฟิลด์นี้เมื่อป้อนข้อมูล และคำขอที่มีรหัสภาษาที่ไม่รองรับจะถูกปฏิเสธ

googleWorkspaceAccount

object (GoogleWorkspaceAccount)

เอาต์พุตเท่านั้น บัญชี Google Workspace ที่เชื่อมโยงกับลูกค้ารายนี้ ใช้สำหรับบริษัทของลูกค้าเท่านั้น

TermsStatus

การยอมรับข้อกำหนดในการให้บริการ (ToS) ของการตั้งค่าอุปกรณ์พร้อมใช้แบบรวมกลุ่ม ผู้ใช้รายเดียวสามารถยอมรับข้อกำหนดในการให้บริการของบริษัทโดยใช้เว็บพอร์ทัลได้

ข้อกำหนดในการให้บริการมีการระบุเวอร์ชัน ซึ่งหมายความว่าเมื่อมีการเปลี่ยนแปลงข้อกำหนดในการให้บริการ ผู้ใช้อย่างน้อย 1 รายจะต้องยอมรับข้อกำหนดในการให้บริการใหม่ สถานะข้อกำหนดของบริษัทจะเป็นTERMS_STATUS_STALEจนกว่าผู้ใช้รายแรกจะยอมรับข้อกำหนดในการให้บริการใหม่

Enum
TERMS_STATUS_NOT_ACCEPTED ไม่มีผู้ใช้คนใดของบริษัทยอมรับข้อกำหนดในการให้บริการ
TERMS_STATUS_ACCEPTED ผู้ใช้ของบริษัทอย่างน้อย 1 รายยอมรับข้อกำหนดในการให้บริการแล้ว
TERMS_STATUS_STALE ไม่มีผู้ใช้คนใดของบริษัทยอมรับข้อกำหนดในการให้บริการปัจจุบัน แต่มีผู้ใช้อย่างน้อย 1 รายยอมรับข้อกำหนดในการให้บริการก่อนหน้านี้

GoogleWorkspaceAccount

ลูกค้า Google Workspace

การแสดง JSON 
{
  "customerId": string,
  "preProvisioningTokens": [
    string
  ]
}
ช่อง
customerId

string

ต้องระบุ รหัสลูกค้า
preProvisioningTokens[]

string

เอาต์พุตเท่านั้น โทเค็นการจัดสรรล่วงหน้าที่ใช้ในการอ้างสิทธิ์อุปกรณ์ก่อนหน้านี้

เมธอด

create

 สร้างลูกค้าสำหรับการตั้งค่าอุปกรณ์พร้อมใช้แบบรวมกลุ่ม

list

 แสดงรายการลูกค้าที่ลงทะเบียนกับตัวแทนจำหน่ายที่ระบุโดยอาร์กิวเมนต์ partnerId