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)

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

boolean

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

string

الإدخال فقط. اللغة المفضّلة للعميل التي يتم تمثيلها كرمز لغة BCP47. تم التحقق من صحة هذا الحقل عند الإدخال وسيتم رفض الطلبات التي تحتوي على رموز لغات غير متوافقة. رموز اللغات المدعومة: العربية (ar) الصينية (هونج كونج) (zh-HK) الصينية (المبسطة) (zh-CN) الصينية (التقليدية)(zh-TW) التشيكية (cs) الدنماركية (da) الهولندية (nl)الإنجليزية (المملكة المتحدة) (en-GB) الإنجليزية (الولايات المتحدة)(U) و(V)(V) (V)(V) (V) (I(AA)) V(V) (I(V)) (V)
googleWorkspaceAccount

object (GoogleWorkspaceAccount)

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

حالة البنود

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

تم إصدار بنود الخدمة. وهذا يعني أنه عند تغيير بنود الخدمة، على مستخدم واحد على الأقل قبول بنود الخدمة الجديدة. تصبح حالة بنود الشركة TERMS_STATUS_STALE إلى أن يقبل المستخدم الأول بنود الخدمة الجديدة.

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

حساب GoogleWorkspace

عميل Google Workspace.

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

string

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

string

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

الطُرق

create

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

list

 يسرد العملاء الذين تم تسجيلهم للمورّد المحدّد في الوسيطة partnerId.