REST Resource: partners.customers

المرجع: الشركة

مورِّد أو مورِّد أو عميل في مورِّد برنامج "إعداد الأجهزة الجوّالة للمؤسسات دفعةً واحدة" وواجهات برمجة تطبيقات العملاء

تمثيل JSON 
{
  "name": string,
  "companyId": string,
  "companyName": string,
  "ownerEmails": [
    string
  ],
  "adminEmails": [
    string
  ],
  "termsStatus": enum (TermsStatus),
  "skipWelcomeEmail": boolean,
  "languageCode": string,
  "googleWorkspaceAccount": {
    object (GoogleWorkspaceAccount)
  }
}
الحقول
name

string

النتائج فقط. اسم مورد واجهة برمجة التطبيقات للشركة. يكون اسم المورد أحد التنسيقات التالية:

  • 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 واحد على الأقل. يتشارك المالكون أذونات الوصول نفسها كالمشرفين، ولكن يمكنهم أيضًا إضافة مستخدمي بوابة مؤسستك وحذفهم وتعديلهم.
adminEmails[]

string

اختياريّ. عنوان البريد الإلكتروني للمستخدمين التابعين للعميل في دور المشرف. يجب أن يكون كل عنوان بريد إلكتروني مرتبطًا بحساب على Google.
termsStatus

enum (TermsStatus)

النتائج فقط. ما إذا كان أي مستخدم من الشركة قد وافق على أحدث بنود الخدمة (ToS). يمكنك الاطّلاع على TermsStatus.
skipWelcomeEmail

boolean

الإدخال فقط. في حال ضبط هذه السياسة على "صحيح"، لن يتم إرسال رسالة الترحيب الإلكترونية إلى العميل. يُنصح بتخطّي رسالة الترحيب الإلكترونية إذا تمت المطالبة بالأجهزة مع خدمة DEVICE_PROTECTION إضافية، لأنّ العميل سيتلقّى رسائل إلكترونية منفصلة في وقت المطالبة بالجهاز. يتم تجاهل هذا الحقل إذا لم يكن برنامج "إعداد الأجهزة الجوّالة للمؤسسات دفعةً واحدة".
languageCode

string

الإدخال فقط. اللغة المفضّلة للعميل والتي يتم تمثيلها كرمز لغة BCP47 يتم التحقّق من صحة هذا الحقل عند الإدخال، وسيتم رفض الطلبات التي تحتوي على رموز لغة غير متوافقة.

googleWorkspaceAccount

object (GoogleWorkspaceAccount)

النتائج فقط. حساب Google Workspace المرتبط بهذا العميل. يُستخدَم فقط لشركات العملاء.

TermsStatus

موافقة الشركة على بنود الخدمة الخاصة ببرنامج "إعداد الأجهزة الجوّالة للمؤسسات دفعةً واحدة" (ToS). يمكن لمستخدم واحد قبول "بنود الخدمة" لشركته باستخدام بوابة الويب.

تم إصدار نُسخ من "بنود الخدمة". وهذا يعني أنّه عند تغيير "بنود الخدمة"، يجب أن يقبل مستخدم واحد على الأقل "بنود الخدمة" الجديدة. ستظل حالة بنود الخدمة "TERMS_STATUS_STALE" إلى أن يقبل المستخدِم الأوّل بنود الخدمة الجديدة.

عمليات التعداد
TERMS_STATUS_NOT_ACCEPTED لم يقبل أي من مستخدمي الشركة بنود الخدمة.
TERMS_STATUS_ACCEPTED قبِل مستخدم واحد (أو أكثر) في الشركة "بنود الخدمة".
TERMS_STATUS_STALE لم يقبل أي من مستخدمي الشركة بنود الخدمة الحالية، ولكن قبِل مستخدم واحد على الأقل بنود خدمة سابقة.

GoogleWorkspaceAccount

عميل Google Workspace

تمثيل JSON 
{
  "customerId": string,
  "preProvisioningTokens": [
    string
  ]
}
الحقول
customerId

string

مطلوب. الرقم التعريفي للعميل
preProvisioningTokens[]

string

النتائج فقط. الرموز المميّزة للإدارة المُسبَقة التي تم استخدامها سابقًا للمطالبة بالأجهزة.

الطُرق

create

 تنشئ حسابًا للعميل لبرنامج "إعداد الأجهزة الجوّالة للمؤسّسات دفعةً واحدة".

list

 يسرد العملاء المسجَّلين في المورِّد المحدّد في الوسيطة partnerId.