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)

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

boolean

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

string

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

googleWorkspaceAccount

object (GoogleWorkspaceAccount)

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

สถานะข้อกําหนด

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

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

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

บัญชี Google Workspace

ลูกค้า Google Workspace

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

string

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

string

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

วิธีการ

create

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

list

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