REST Resource: customers

المرجع: العميل

عندما يتم تسجيل حساب عميل Google لدى أحد المورِّدين، يدير هذا المورِّد اشتراكات العميل في خدمات Google. يتم وصف العميل باسم نطاق أساسي وعنوان جغرافي.

تمثيل JSON 
{
  "customerId": string,
  "customerDomain": string,
  "postalAddress": {
    object (Address)
  },
  "phoneNumber": string,
  "alternateEmail": string,
  "resourceUiUrl": string,
  "customerDomainVerified": boolean,
  "kind": string,
  "customerType": enum (CustomerType),
  "primaryAdmin": {
    object (PrimaryAdmin)
  }
}
الحقول
customerId

string

سيتم دائمًا عرض هذه السمة في ردّ كالمعرّف الفريد الذي تنشئه Google. في الطلب، يمكن أن يكون هذا الموقع هو النطاق الأساسي أو المعرّف الفريد الذي تنشئه Google.
customerDomain

string

سلسلة اسم النطاق الأساسي للعميل. يجب إدخال "customerDomain" عند إنشاء عميل جديد. لا تُدرِج البادئة www في النطاق عند إضافة عميل.
postalAddress

object (Address)

معلومات عنوان العميل يحتوي كل حقل على 255 حرفًا كحد أقصى.
phoneNumber

string

رقم هاتف جهة الاتصال بالعميل. يجب أن يبدأ بـ "+" متبوعًا برمز البلد. ويمكن أن يكون باقي الرقم أرقامًا متجاورة أو يلتزم باصطلاحات التنسيق المحلي للهاتف، ولكن يجب أن يكون رقم هاتف حقيقيًا وليس "123" مثلاً. ويتم تجاهل هذا الحقل تلقائيًا إذا كان غير صالح.
alternateEmail

string

مثل "البريد الإلكتروني للعميل" في أدوات المورِّد، هذا البريد الإلكتروني هو جهة الاتصال الثانوية المستخدمة في حالة حدوث شيء ما لخدمة العميل مثل انقطاع الخدمة أو مشكلة تتعلق بالأمان. هذه السمة مطلوبة عند إنشاء "نطاق" جديد العميل ويجب ألا يستخدم النطاق نفسه مثل customerDomain. الحقل alternateEmail ليس ضروريًا لإنشاء "فريق" العميل.
resourceUiUrl

string

عنوان URL للوحة بيانات وحدة تحكم المشرف التابعة للعميل. تنشئ خدمة واجهة برمجة التطبيقات عنوان URL للقراءة فقط. يتم استخدام ذلك إذا كان تطبيق العميل يتطلب من العميل إكمال مهمة في وحدة تحكّم المشرف.
customerDomainVerified

boolean

ما إذا كان قد تم إثبات ملكية النطاق الأساسي للعميل أم لا.
kind

string

يحدد المورد كعميل. القيمة: reseller#customer
customerType

enum (CustomerType)

تحدد نوع العميل. وتشمل القيم المقبولة ما يلي:

  • domain: تشير إلى عميل تم إثبات ملكية نطاقه (تلقائي).
  • team: تضمين عميل تم إثبات ملكية عنوان بريده الإلكتروني.

لمزيد من المعلومات، يُرجى الاطّلاع على الفِرق المُدارة.
primaryAdmin

object (PrimaryAdmin)

تفاصيل المشرف الأول للعميل، تظهر في حالة عميل team.

العنوان

نموذج JSON لعنوان العميل.

تمثيل JSON 
{
  "countryCode": string,
  "kind": string,
  "region": string,
  "addressLine2": string,
  "locality": string,
  "addressLine3": string,
  "postalCode": string,
  "addressLine1": string,
  "organizationName": string,
  "contactName": string
}
الحقول
countryCode

string

للحصول على معلومات عن countryCode، يمكنك الاطّلاع على عناصر رمز البلد وفقًا لمعيار ISO 3166. تأكَّد من أنّ هذا البلد قد تمت الموافقة عليه لإعادة بيع منتجات Google. هذه السمة مطلوبة عند إنشاء عميل جديد.
kind

string

تحدد المورد كعنوان عميل. القيمة: customers#address
region

string

مثال على القيمة region هو CA لولاية كاليفورنيا.
addressLine2

string

السطر 2 من العنوان.
locality

string

مثال على قيمة locality هي مدينة San Francisco.
addressLine3

string

السطر 3 من العنوان.
postalCode

string

مثال على postalCode هو رمز بريدي مثل 94043. هذه السمة مطلوبة عند إنشاء عميل جديد.
addressLine1

string

العنوان الجغرافي للعميل يمكن أن يتكون العنوان من سطر إلى ثلاثة أسطر. إنّ addressline2 وaddressLine3 اختياريتان.
organizationName

string

اسم الشركة أو قسمها. هذا الحقل مطلوب.
contactName

string

اسم جهة اتصال العميل هذا الحقل مطلوب.

CustomerType

نوع العميل

عمليات التعداد
customerTypeUnspecified نوع العميل غير معروف
domain العملاء التابعون للنطاق أو الذين يمتلكون النطاقات
team عملاء بدون نطاقات أو عملاء تم إثبات ملكيتهم باستخدام عنوان البريد الإلكتروني

PrimaryAdmin

نموذج JSON للمشرف الأساسي في حالة عملاء team

تمثيل JSON 
{
  "primaryEmail": string
}
الحقول
primaryEmail

string

البريد الإلكتروني للنشاط التجاري للمشرف الأساسي للعميل

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

الطُرق

get

 يحصل على حساب عميل.

insert

 يطلب حساب عميل جديد.

patch

 لتعديل إعدادات حساب عميل

update

 لتعديل إعدادات حساب عميل