REST Resource: partners.vendors.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 المرتبط بهذا العميل. يُستخدَم فقط لشركات العملاء.

الطُرق

list

يسرد عملاء المورِّد.